Skip to main content
POST

Parâmetros de rota

string
obrigatório
Identificador único do bot que envia a mensagem.

Parâmetros do corpo

string
obrigatório
Tipo de mensagem. Deve ser "audio".
string
obrigatório
Destinatário da mensagem. Aceita um número de telefone no formato E.164 sem o sinal + (ex.: 593999999999) ou um BSUID (ex.: US.13491208655302741918) para usuários com a proteção de número ativada no WhatsApp. Veja Identificação do destinatário.
string
obrigatório
URL pública (HTTPS) do arquivo de áudio. Os formatos e o tamanho máximo dependem do canal (veja a tabela de formatos e limites por canal).

Resposta

boolean
true se a mensagem foi enviada com sucesso.
string
Identificador da mensagem enviada.

Formatos e limites de tamanho por canal

Requisitos de URL

A URL deve ser acessível publicamente via HTTPS, não deve exigir autenticação e deve apontar diretamente para o arquivo (e não para uma página HTML).

Erros Comuns

  • INVALID_MEDIA_URL - A URL do áudio é inválida ou inacessível
  • MEDIA_TOO_LARGE - O arquivo de áudio excede o limite de tamanho do canal
  • UNSUPPORTED_MEDIA_TYPE - O formato de áudio não é suportado

Casos de Uso

  • Enviar mensagens de voz
  • Compartilhar músicas ou podcasts
  • Enviar notificações em áudio
  • Compartilhar gravações