Este conteúdo visa orientar sobre o funcionamento do gerenciamento de mídias na API Oficial do WhatsApp (Meta), explicando como ocorre a gestão de envio de arquivos como imagens, vídeos, áudios e documentos por meio da plataforma. Este procedimento também visa esclarecer limitações técnicas, boas práticas e impactos operacionais para integrações realizadas por meio da Sonax.
1. O que é o Gerenciamento de Mídias da Meta?
O Gerenciamento de Mídias é o conjunto de recursos disponibilizados pela Meta para permitir que empresas enviem e recebam arquivos por meio do WhatsApp Business Platform.
Esses arquivos podem incluir:
- Imagens
- Vídeos
- Áudios
- Documentos
- Figurinhas (stickers)
Ao contrário do que ocorre em aplicativos comuns, na API Oficial as mídias não são enviadas diretamente ao destinatário. Primeiro, elas passam por um processo de upload para os servidores da Meta, recebem um identificador único (Media ID) e somente depois podem ser utilizadas em mensagens.
2. Armazenamento das mídias
A Meta suporta diversos formatos de mídia.
Entre os mais utilizados:
Imagens
- JPG
- JPEG
- PNG
- WEBP
Vídeos
- MP4
Áudios
- MP3
- AAC
- M4A
- AMR
- OGG (Opus)
Documentos
- DOC
- DOCX
- XLS
- XLSX
- PPT
- PPTX
- TXT
3. Limites de tamanho dos arquivos
Os limites variam conforme o tipo de mídia.
| Tipo | Limite Aproximado |
|---|---|
| Imagem | Até 5 MB |
| Áudio | Até 16 MB |
| Vídeo | Até 16 MB |
| Documento | Até 100 MB |
Caso o arquivo ultrapasse o limite permitido, a Meta rejeitará o envio.
4. Impactos operacionais no Sonax Chat
O funcionamento correto de mídias no Sonax Chat depende diretamente de:
- Disponibilidade da API da Meta;
- Recebimento correto dos webhooks;
- Processamento dos arquivos pela infraestrutura Sonax;
- Permissões válidas da conta WhatsApp Business.
Falhas em qualquer uma dessas etapas podem ocasionar:
- Arquivos não exibidos;
- Mídias em branco;
- Erros de download;
- Mensagens sem anexos;
- Atrasos na visualização do conteúdo.
Nesses casos, recomenda-se abrir um chamado junto ao suporte Sonax para análise dos logs e validação do fluxo junto à Meta.
Para maiores informações, acesse o portal da Meta referente ao envio de mídias aqui.