Enviar mensagem com prévia de link

Amb. de Produção

https://api.way-api.io

POST

/instances/{instanceId}/messages/link

Última modificação:2026-09-17 22:00:23

Adiciona uma mensagem com link e prévia visual à fila de uma instância.

A instância precisa estar conectada. Use em targetId um telefone ou um identificador retornado pelas
rotas de chats e newsletters.

previewTitle e previewDescription são obrigatórios. previewImage é opcional e aceita uma URL pública
ou base64 puro de até 10 MB. Use linkSize para escolher entre a prévia compacta (SMALL) e a prévia
grande (LARGE, padrão).

A resposta 202 confirma apenas que a mensagem entrou na fila; acompanhe o resultado pelos webhooks
message.sent e message.failed.

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

Confirma que a mensagem entrou na fila de envio. Isso ainda não confirma a entrega no WhatsApp.

Bodyapplication/json

🟠400Requisição Inválida

🟠401Não Autorizado

🟠403Proibido

🟠404Registo Não Encontrado

🟠409Erro de Parâmetro

🟠422Erro de Parâmetro

🟠429

🔴500Erro do Servidor

🔴502Gateway Inválido

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.way-api.io/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-09-17 22:00:23

Página anterior

Enviar mensagem com imagem

Próxima página

Listar mensagens pendentes