Pular para o conteúdo

Enviar mensagens

Enviar imagem

Envie uma imagem com legenda opcional por WhatsApp, Instagram ou Messenger.

Envie uma imagem em POST /v1/messages com type: "image". Os campos comuns a todos os tipos (to, reply_to, typing, delay_ms, janela de 24 h) estão em Campos comuns.

Janela do terminal
curl -X POST https://api.messajo.com/v1/messages \
-H "Authorization: Bearer $MESSAJO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"connection_id": "con_123",
"to": "5511999990000",
"type": "image",
"image": {
"link": "https://cdn.exemplo.com/foto.jpg",
"caption": "Seu pedido saiu para entrega"
}
}'

A resposta é 201 com id (msg_…), status: "queued" e conversation_id. O estado final chega por webhook.

Informe exatamente um entre link e media_id. Mandar os dois, ou nenhum, devolve 400 validation_failed com exactly one of media_id or link is required.

  • link: URL da imagem.
  • media_id (med_…): vem de POST /v1/media, um multipart/form-data com file (e connection_id, exceto com chave de conexão mjc_…). Exige a permissão send. O tipo é lido dos bytes do arquivo, não da extensão.
Janela do terminal
curl -X POST https://api.messajo.com/v1/media \
-H "Authorization: Bearer $MESSAJO_API_KEY" \
-F connection_id=con_123 \

O upload devolve o id da mídia (med_…), que você usa em image.media_id.

  • image.caption: legenda de até 1024 caracteres.
  • Upload: até 5 MiB, em JPEG ou PNG.

O corpo é o mesmo, com duas diferenças:

  • link precisa ser https.
  • Não existe caption. Enviar legenda devolve 422 type_not_supported_by_channel apontando image.caption. Mande a legenda como mensagem de texto à parte.
Canal Tamanho máximo Formatos
Instagram 8 MiB image/jpeg, image/png, image/gif
Messenger 25 MiB image/jpeg, image/png, image/gif

type: "images" envia de 2 a 10 imagens em uma única mensagem. Cada item aceita link ou media_id.

{
"connection_id": "con_123",
"to": "17841400000000000",
"type": "images",
"images": {
"items": [
{ "link": "https://cdn.exemplo.com/a.jpg" },
{ "link": "https://cdn.exemplo.com/b.jpg" }
]
}
}
Código Status Quando
validation_failed 400 link e media_id juntos, ou nenhum dos dois
media_too_large 413 Arquivo acima do limite
media_type_not_supported 415 Formato que o canal não aceita
media_error 422 A Meta não conseguiu processar a mídia
type_not_supported_by_channel 422 caption no Instagram ou Messenger
outside_service_window 422 Mensagem livre fora da janela de 24 h

Detalhes de cada código no catálogo de erros.