Enviar mensagem com imagem

Amb. de Produção

https://api.way-api.io

POST

/instances/{instanceId}/messages/image

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

Adiciona uma mensagem com imagem à 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.

imageInput aceita uma imagem completa, com no máximo 10 MB, em um destes formatos:

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

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

base64 puro completo: iVBORw0KGgo...

Prefira data URL ao usar base64, pois ela informa o tipo da imagem. 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/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-09-17 22:00:23

Página anterior

Consultar status da instância

Próxima página

Enviar mensagem com prévia de link