Enviando mídia: imagens, vídeo, áudio e documentos
A mídia é enviada de duas formas: subindo o arquivo primeiro e referenciando o id devolvido, ou dando à Meta um link público para buscar. Subir o arquivo é mais confiável, e os limites de tamanho variam por tipo de um jeito que pega as pessoas de surpresa.
O teto de tamanho de imagem na Cloud API.
O teto para vídeo e áudio.
O teto para documentos.
Os limites, por tipo
Diferentes para cada um, e ultrapassar qualquer um deles devolve o erro 131053, em vez de algo descritivo.
- Imagens: 5 MB. JPEG e PNG.
- Vídeo: 16 MB. MP4 e 3GPP, com vídeo em H.264 e áudio em AAC.
- Áudio: 16 MB. AAC, AMR, MP3, áudio MP4 e OGG com Opus.
- Documentos: 100 MB. A maioria dos tipos comuns de documento, incluindo PDF e formatos do Office.
- Figurinhas: 100 KB animadas, 500 KB estáticas, apenas WebP.
Subir o arquivo ou linkar
Duas formas de enviar o mesmo arquivo, e elas falham de maneiras diferentes.
Subir envia o arquivo para a Meta primeiro e devolve um id de mídia que você referencia no envio. Linkar dá à Meta uma URL para buscar na hora do envio. O caminho do link parece mais simples e acrescenta um modo de falha que você não enxerga: uma URL que abre no seu navegador pode ser inalcançável a partir da infraestrutura da Meta por causa de geografia, de uma regra de firewall ou de um cookie de sessão que o seu navegador já guarda.
Suba o arquivo. É uma requisição a mais e elimina uma classe inteira de falhas.
Recebendo mídia
A mídia de entrada chega como um id de mídia, e não como bytes. Seu handler busca o arquivo separadamente usando esse id.
- Busque logo. Os ids não continuam válidos indefinidamente.
- Uma busca que falha devolve o erro 131052, que normalmente significa que o upload do remetente ficou incompleto.
- Guarde o arquivo por sua conta se for precisar dele depois. A Meta não é um arquivo morto.
- Registre a mensagem mesmo quando a busca de mídia falhar, para que o texto e o contexto sobrevivam.
O que a Coexistência muda
A mídia num número em Coexistência funciona exatamente como em qualquer outro número da Cloud API, com os mesmos limites.
A única diferença que vale conhecer é o histórico. Quando um número se conecta pela primeira vez, a Meta sincroniza as mensagens recentes do app do WhatsApp Business, e essa sincronização cobre o texto das mensagens, em vez de ser um arquivo completo de mídia. A mídia anterior à conexão continua no celular, onde sempre esteve.
Erros comuns
- Mandar um link porque parece mais simples. A rede da Meta não é o seu navegador.
- Buscar a mídia de entrada horas depois. Os ids de mídia expiram.
- Exportar vídeo sem conferir o codec. Os padrões dos softwares de edição muitas vezes não são suportados.
A EasyCoexistence entrega os eventos de mensagem de entrada direto da Meta para o seu endpoint, então os ids de mídia chegam ao seu sistema imediatamente e podem ser buscados enquanto ainda são válidos.
Perguntas frequentes
Qual é o maior arquivo que eu posso enviar?
100 MB, e apenas para documentos. Vídeo e áudio param em 16 MB e imagens em 5 MB.
Devo subir o arquivo ou mandar uma URL?
Suba o arquivo. Isso elimina a alcançabilidade como causa de falha.
Por quanto tempo um id de mídia é válido?
Não é indefinidamente, e é por isso que a mídia de entrada deve ser buscada assim que o evento chega.
A mídia antiga sincroniza quando eu conecto?
Não. A sincronização de histórico cobre o conteúdo das mensagens recentes; a mídia anterior à conexão fica no celular.
Continue lendo
Pronto para começar?
Configure o WhatsApp Coexistence em minutos, não em meses. O aplicativo continua funcionando no celular.
Começar teste grátisVerificado em