Pular para o conteúdo principal
POST
/
send-link
Send link
curl --request POST \
  --url https://zapi.hubmessage.io/channels/{channel_id}/token/{channel_token}/send-link \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "phone": "5511999999999",
  "message": "Check out our website: https://www.hubmessage.io",
  "image": "https://www.hubmessage.io/logo.png",
  "linkUrl": "https://www.hubmessage.io",
  "title": "Hub Message",
  "linkDescription": "Omnichannel API for Business Communication"
}
'
{
  "zaapId": "3999984263738042930CD6ECDE9VDWSA",
  "messageId": "D241XXXX732339502B68",
  "id": "D241XXXX732339502B68"
}

Conceituação

Método para envio de mensagens com preview de link, incluindo imagem, título e descrição.
Os links só são clicáveis se o destinatário tiver seu número salvo na agenda ou se ele tiver iniciado uma conversa com você anteriormente.
A estrutura de resposta é idêntica à da Z-API. Seu código existente que processa esses retornos continuará funcionando sem alterações.

Autorizações

Authorization
string
header
obrigatório

Secret Key generated in the Hub Message Security panel

Corpo

application/json
phone
string
obrigatório

Recipient phone number (country code + area code + number)

Exemplo:

"5511999999999"

message
string
obrigatório

Message text. Must include the link URL at the end

image
string
obrigatório

Link preview image URL

Link URL

title
string
obrigatório

Link title

Link description

Preview size: SMALL, MEDIUM or LARGE

Opções disponíveis:
SMALL,
MEDIUM,
LARGE
delayMessage
integer

Delay in seconds before sending (1-15)

Intervalo obrigatório: 1 <= x <= 15
delayTyping
integer

Seconds to display "typing" status (1-15)

Intervalo obrigatório: 1 <= x <= 15

Resposta

Message sent successfully

zaapId
string

Internal identifier

messageId
string

WhatsApp message ID

id
string

Same value as messageId (compatibility)