Pular para o conteúdo

Enviar mensagens

Enviar vídeo

Envie um vídeo com legenda opcional por WhatsApp, Instagram ou Messenger.

Envie um vídeo em POST /v1/messages com type: "video". 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": "video",
"video": {
"link": "https://cdn.exemplo.com/video.mp4",
"caption": "Como montar"
}
}'

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 vídeo.
  • 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 video.media_id.

  • video.caption: legenda de até 1024 caracteres.
  • Upload: até 16 MiB. O upload reconhece os contêineres video/mp4 e video/3gpp.

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 video.caption. Mande a legenda como mensagem de texto à parte.
Canal Tamanho máximo Formatos
Instagram 25 MiB video/mp4, video/ogg, video/x-msvideo, video/quicktime, video/webm
Messenger 25 MiB video/mp4
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.