Skip to main content
POST
/
send-image
curl --request POST \
  --url https://zapi.hubmessage.io/channels/{channel_id}/token/{channel_token}/send-image \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "phone": "5511999999999",
  "image": "https://exemplo.com/imagem.png",
  "caption": "Confira essa imagem!",
  "viewOnce": false
}
'
{
  "zaapId": "3999984263738042930CD6ECDE9VDWSA",
  "messageId": "D241XXXX732339502B68",
  "id": "D241XXXX732339502B68"
}

Overview

Method for sending images. You can send the image in two ways: via URL or Base64.
When sending as Base64, you must include the prefix with the image type, for example: data:image/png;base64,. To validate, paste the full Base64 in the browser address bar and verify the image renders correctly.
The response structure is identical to Z-API. Your existing code that processes these returns will continue working without changes.
File size limits and supported formats follow WhatsApp policies. See the official WhatsApp documentation for details.

Authorizations

Authorization
string
header
required

Secret Key gerada no painel de Segurança do Hub Message

Body

application/json
phone
string
required

Telefone do destinatário (DDI + DDD + número)

Example:

"5511999999999"

image
string
required

URL da imagem ou dados em Base64

caption
string

Legenda da imagem

messageId
string

ID de uma mensagem existente para responder

delayMessage
integer

Delay em segundos antes do envio (1-15)

Required range: 1 <= x <= 15
viewOnce
boolean
default:false

Enviar como mensagem de visualização única

Response

Mensagem enviada com sucesso

zaapId
string

Identificador interno

messageId
string

ID da mensagem no WhatsApp

id
string

Mesmo valor do messageId (compatibilidade)