Pular para o conteúdo principal
POST
Enviar áudio
Envia um áudio para um cliente com a janela de 24 horas aberta. O áudio pode chegar como arquivo de áudio ou como mensagem de voz.
O destinatário pode ser informado pelo número de telefone (to) ou pelo ID do usuário (recipient). Se os dois forem enviados, vale o to; para enviar pelo ID do usuário, deixe o to em branco. Veja a diferença em Destinatário.
Informe o áudio de uma das duas formas:
Envie apenas um dos dois. Com link e id na mesma requisição, a Meta recusa o envio.
No Testar, o link já vem preenchido com um áudio de exemplo. Para testar com um id, apague o link antes de enviar.

Mensagem de voz

Com audio.voice igual a true, o áudio chega como mensagem de voz: aparece com o ícone de microfone e pode ser transcrito pelo WhatsApp do cliente.
A mensagem de voz exige um arquivo .ogg com codec OPUS e canal mono. Fora desse formato, a transcrição falha.

Como conseguir um áudio no formato certo

O jeito mais simples é gravar o áudio no próprio WhatsApp. O arquivo baixado pelo WhatsApp Web já sai no formato de mensagem de voz:
  1. Grave o áudio no WhatsApp do celular, em qualquer conversa.
  2. Abra essa conversa no WhatsApp Web, abra o menu da mensagem de áudio e clique em Baixar.
  3. Envie o arquivo baixado na aba Mídias do painel da Datafy, para usar em link, ou pelo endpoint Upload de mídia, para usar em id.
  4. Envie a mensagem com audio.voice igual a true.
WhatsApp Web com o menu de uma mensagem de áudio aberto e a opção Baixar destacada.
O botão de reproduzir só aparece direto na conversa para arquivos de até 512 KB. Acima disso, o cliente vê um ícone de download antes de ouvir.
Sem voice, ou com voice igual a false, o áudio chega como arquivo de áudio comum.

Formatos aceitos

O tipo MIME do arquivo precisa corresponder à extensão. Mensagens de áudio não têm legenda. Veja mais detalhes na documentação de mensagens de áudio da Meta.

Autorizações

Authorization
string
header
obrigatório

Token gerado no painel da Datafy ao criar o canal. Formato: sk_live_xxx.

Parâmetros de caminho

phone_number_id
string
obrigatório

ID do número que envia a mensagem. Descubra com GET /me.

Corpo

application/json
messaging_product
enum<string>
padrão:whatsapp
obrigatório

Sempre whatsapp.

Opções disponíveis:
whatsapp
Exemplo:

"whatsapp"

to
string
obrigatório

Número do destinatário com código do país e DDD, como 5511999999999. Tem prioridade sobre recipient: para enviar pelo ID do usuário, deixe em branco.

Exemplo:

"5511999999999"

type
enum<string>
padrão:audio
obrigatório

Sempre audio.

Opções disponíveis:
audio
Exemplo:

"audio"

audio
object
obrigatório

Áudio da mensagem. Informe link ou id, nunca os dois.

recipient_type
enum<string>
padrão:individual

Sempre individual.

Opções disponíveis:
individual
Exemplo:

"individual"

recipient
string

ID do usuário no WhatsApp (BSUID), recebido nos webhooks em from_user_id e contacts[].user_id, como BR.13491208655302741918. Usado quando to não é informado.

context
object

Responde citando uma mensagem anterior da conversa.

Resposta

Envio aceito pela Meta. Não confirma a entrega.