Pular para o conteúdo

Enviar mensagens

Enviar documento

Envie um PDF ou outro documento com nome de arquivo e legenda por WhatsApp, Instagram ou Messenger.

Envie um documento em POST /v1/messages com type: "document". 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": "document",
"document": {
"link": "https://cdn.exemplo.com/fatura-novembro.pdf",
"filename": "fatura-novembro.pdf",
"caption": "Sua fatura de novembro"
}
}'

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 do documento.
  • 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 document.media_id.

  • document.caption: legenda de até 1024 caracteres.
  • document.filename: nome exibido ao contato, até 240 caracteres. Envie sempre, com a extensão (fatura-novembro.pdf), para o contato ver um nome legível.
  • Upload: até 100 MiB.

O upload reconhece estes formatos:

Formato Extensões
PDF .pdf
Office antigo .doc, .xls, .ppt
Office .docx, .xlsx, .pptx
Texto puro .txt

Os arquivos do Office são identificados pelos bytes e pela extensão do nome do arquivo. Outros formatos devolvem 415 media_type_not_supported.

O corpo é só link ou media_id, com duas diferenças:

  • link precisa ser https.
  • Não existem caption nem filename. Mande a legenda como mensagem de texto à parte.
Canal Tamanho máximo Formatos
Instagram 25 MB application/pdf
Messenger 25 MB application/pdf
Código Status Quando
validation_failed 400 link e media_id juntos, ou nenhum dos dois
media_too_large 413 Arquivo acima do limite do canal
media_type_not_supported 415 Formato que o canal não aceita
media_error 422 A Meta não conseguiu processar o arquivo
outside_service_window 422 Mensagem livre fora da janela de 24 h