WhatsApp business API: Envio de mídias
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 |
|
Observação: o tipo |
| Qualquer tipo MIME válido. |
|
No momento, imagens com fundo transparente não são compatíveis. |
|
|
|
Observações:
|
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 |
| 16 MB |
| 100 MB |
| 5 MB |
| 100 KB |
| 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