Enviar mensagem com preview de link

Amb. de Desenv.

http://localhost:3000

POST

/instances/{instanceId}/messages/link

Envia uma mensagem com preview de link para um único destino.

Regras importantes:

url deve ser pública e segura

previewImage é opcional e deve ser uma URL pública (http/https)

a resposta 202 significa que a mensagem foi aceita e enfileirada

delaySeconds é opcional e segue a mesma regra de fila da rota de texto

Requisição

Authorization

Adicionar parâmetro em header

x-api-key

Exemplo:

x-api-key: ********************

Parâmetros de Caminho

Parâmetros Header

Parâmetros Bodyapplication/jsonNecessário

Examples

Respostas

🟢202Aceite

application/json

Resposta de aceite para envio assíncrono de mensagem.

Body

🟠400Requisição Inválida

🟠401Não Autorizado

🟠403Proibido

🟠404Registo Não Encontrado

🟠422Erro de Parâmetro

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'http://localhost:3000/instances//messages/link' \
--header 'x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "targetId": "120363123456789@g.us",
    "url": "https://suaempresa.com/artigo",
    "text": "Dá uma olhada neste conteúdo.",
    "previewImage": "https://suaempresa.com/imagens/capa.png",
    "previewTitle": "Título do preview",
    "previewDescription": "Resumo curto do link",
    "delaySeconds": 15
}'

Response Example

202 - Mensagem com link enfileirada

{
    "messageId": "018f47ac-7a5b-7cc2-9f9a-9b8d7f6e5d4c",
    "type": "link",
    "status": "queued"
}

Modificado em 2026-04-17 20:31:44

Página anterior

Enviar mensagem com imagem

Próxima página

Enviar mensagem de texto