Envie uma mensagem
POST /v1/messages exige to, kind e o objeto correspondente: text, template, reaction, location, contacts ou interactive. Image, audio, video, document e sticker usam media. Confira campos e validações na referência.
Para mídias, inclua id ou link. Áudio não aceita caption/filename; vídeo não aceita filename. Use replyToMessageId para responder a uma mensagem.
A resposta usa o formato do Watahub, não o completo da Meta. messageId contém o wamid quando fornecido pela Meta. Acompanhe a entrega com webhooks.
Envie e baixe arquivos
Envie comPOST /v1/media usando multipart/form-data, ou POST /v1/media/{id} com um ID de telefone. Fora da rota, use um seletor documentado como X-Phone-Number-Id.
GET /v1/media/{id} retorna uma URL temporária da Meta, não o conteúdo. A URL exige o token da Meta do número. Prefira GET /v1/media/{mediaId}/content para baixar pelo Watahub sem expor esse token.
Somente mídias enviadas ou recebidas pela conta são acessíveis. Não presuma que /v1 inclua tipo MIME, checksum ou tamanho da Meta.