Pular para o conteúdo principal
POST
Enviar áudio
Envia um áudio para um contato com a janela de 24 horas aberta. Quem baixa o arquivo é a Meta, a partir do endereço informado em payload.url. Não existe upload prévio nem ID de mídia: o áudio precisa estar hospedado em algum lugar acessível antes do envio.

Formatos aceitos

MP3 e OGG não são aceitos em áudio. São os dois formatos que mais aparecem em quem vem do WhatsApp, onde a mensagem de voz é OGG/Opus. Converta para AAC, M4A ou WAV antes de enviar.

Cabeçalho Content-Type

O formato é determinado pelo cabeçalho Content-Type devolvido pelo servidor que hospeda o arquivo, não pela extensão informada na URL. Um arquivo .m4a servido como audio/mp4a-latm é recusado; o mesmo arquivo servido como audio/mp4 é aceito. Em caso de recusa de um formato presente na tabela, verifique o cabeçalho:

Formato recusado

O error_subcode 2534080 indica formato recusado. O code 100 sem subcódigo indica falha ao baixar o arquivo.
A URL precisa ser pública e direta. Endereços que respondem com redirecionamento, exigem autenticação ou bloqueiam o download falham, mesmo abrindo normalmente no navegador.
O áudio aparece como mensagem de voz na conversa.

Autorizações

Authorization
string
header
obrigatório

Token do canal do Instagram, gerado no painel da Datafy. Formato: sk_live_xxx.

Corpo

application/json
recipient
object
obrigatório

Quem recebe a mensagem.

message
object
obrigatório

Resposta

Aceito pela Meta. Não confirma a entrega.