Enviar mensagem com imagem

Amb. de Desenv.

http://localhost:3000

POST

/instances/{instanceId}/messages/image

Envia uma mensagem de imagem para um único destino.

A instância precisa estar conectada para este envio funcionar. Se ela estiver desconectada, a API retorna 422 e não enfileira a mensagem.

O campo imageInput aceita 3 formatos:

URL pública: https://cdn.example.com/banner.png

data URL base64 completa: data:image/png;base64,iVBORw0KGgo...

base64 puro completo: iVBORw0KGgo...

Recomendações:

prefira data URL quando possível, porque ela informa o tipo da imagem

envie sempre o base64 completo

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.

Bodyapplication/json

🟠400Requisição Inválida

🟠401Não Autorizado

🟠403Proibido

🟠404Registo Não Encontrado

🟠422Erro de Parâmetro

Request Example

Shell

JavaScript

Java

Swift

curl --location 'http://localhost:3000/instances//messages/image' \
--header 'x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "targetId": "120363123456789@g.us",
    "imageInput": "https://cdn.example.com/banner.png",
    "caption": "Banner da campanha",
    "delaySeconds": 15
}'

Response Example

202 - Mensagem de imagem enfileirada

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

Modificado em 2026-06-12 15:08:32

Página anterior

Consultar status da instância

Próxima página

Enviar mensagem com preview de link