WhatsApp business API: Envio de mídias

Michelli Silva Atualizado por Michelli Silva

Envio de mídias

É possível o envio de mídia (áudios, vídeos e imagens ) pelo WhatsApp de acordo com as restrições impostas pela plataforma. 32mb de upload máximo ou 30s tentando realizar o upload. O que significa? se o arquivo possuir menos do que 32mb mas a internet for lenta o suficiente para não subir em 30s, não vai subir pq excedeu o timeout.

Se o canal de comunicação for o WhatsApp, ele tem suas próprias regras. Elas são:

Tipos de conteúdo compatíveis

Mídia

Tipos de conteúdo compatíveis

audio

audio/aacaudio/mp4audio/amraudio/mpeg eaudio/ogg; codecs=opus

Observação: o tipo audio/ogg de base não é compatível.

document

Qualquer tipo MIME válido.

image

image/jpeg e image/png

No momento, imagens com fundo transparente não são compatíveis.

sticker

image/webp

video

video/mp4 e video/3gpp

Observações:

  • Apenas o codec de vídeo H.264 e o codec de áudio AAC são compatíveis.
  • Aceitamos vídeos com stream de áudio único ou sem stream de áudio.

Tamanho de mídia após o processamento

Este é o tamanho máximo permitido depois de o arquivo de mídia ser comprimido e criptografado.

Tipo de mídia

Tamanho

audio

16 MB

document

100 MB

image

5 MB

sticker

100 KB

video

16 MB

As mídias enviadas por meio de mensagens são armazenadas nos servidores do WhatsApp por 14 dias. Se um usuário fizer uma solicitação para baixar a mídia depois desse período, os servidores do WhatsApp solicitarão o mesmo arquivo de mídia do cliente local do WhatsApp Business. Se a mídia tiver sido removida, o usuário será notificado de que ela está indisponível.

Não é seguro supor que o download foi concluído apenas com base nos recibos de entrega e leitura. No geral, as mídias de saída podem ser removidas depois de 30 dias, mas use a estratégia que melhor se adapta à sua empresa.

Restrições

  • Caso você use o processo de carregamento de mídia em vez de um link para a URL da mídia em questão, o arquivo precisará ser carregado no volume de mídia. Quando o carregamento for concluído, envie uma mensagem usando o ID de mídia.
  • O app processa a mídia carregada antes que ela seja enviada para o servidor. O tamanho máximo da mídia que pode ser carregada no nó media é 100 MB. No entanto, há limites após o processamento para os vários tipos de mídia descritos na tabela Tamanho de mídia após o processamento acima.
  • O armazenamento de mídia precisa ser gerenciado pela empresa. Se o volume de mídia alcançar o limite, o envio de mensagens começará a falhar.
  • Não há suporte às seguintes ações:

Envio de mídia por streams de bytes

Envio de mensagens com figurinhas animadas

Como carregar

Faça uma solicitação POST para /v1/media a fim de carregar a mídia. O corpo da solicitação local deve conter os dados de mídia binária, e o cabeçalho Content-Type precisa ser definido de acordo com o tipo de mídia carregado. Consulte a Tipos de conteúdo compatíveis para ver as opções aceitas.

Enviar os dados binários em uma solicitação POST HTTP é o método-padrão para carregar dados binários. Por exemplo, se quiser carregar uma imagem, envie uma solicitação POST com os bytes reais da imagem na carga. Outra opção é usar --data-binary caso você queira que cURL leia e use o arquivo fornecido em binários exatamente como ele está.

Exemplo

Carregamento de mídia:

POST /v1/media
Content-Type:

Carregamento de mídia com cURL:

curl -X POST \
https://:/v1/media \
-H 'Authorization: Bearer ' \
-H 'Content-Type: image/jpeg' \ # or other appropriate media type
--data-binary @

Em ambos os casos, uma resposta bem-sucedida retorna o campo id, necessário para recuperar mídias ou enviar mensagens de mídia aos clientes.

{
"media": [
{
"id": "f043afd0-f0ae-4b9c-ab3d-696fb4c8cd68"
}
]
}

Se você receber uma mensagem de erro, consulte Mensagens de erro e status para saber mais.

Você pode ver que vídeos e áudios possuem tamanho Max de 16mb (se upar um vídeo de 20mb no push por exemplo, o vídeo será salvo no push, mas na hora de executar, o WhatsApp não consegue enviar) e documento o máximo de 100mb (o que não funciona no push, porque só suporta ate 32mb)

Você pode ver mais sobre essas informações na página oficial da META: https://developers.facebook.com/docs/whatsapp/on-premises/reference/media

Como a gente se saiu?

Whatsapp Template messages: Impedimentos e configurações

Contato