Enviar multimédia: imagens, vídeo, áudio e documentos
A multimédia é enviada carregando primeiro o ficheiro e usando o ID devolvido, ou fornecendo à Meta uma ligação pública para o obter. Carregar é mais fiável, e os limites variam por tipo de forma pouco intuitiva.
O limite de tamanho das imagens na Cloud API.
O limite para vídeo e áudio.
O limite para documentos.
Os limites por tipo
São diferentes para cada tipo, e exceder um limite devolve o erro 131053, sem uma descrição útil.
- Imagens: 5 MB. JPEG e PNG.
- Vídeo: 16 MB. MP4 e 3GPP, com vídeo H.264 e áudio AAC.
- Áudio: 16 MB. AAC, AMR, MP3, áudio MP4 e OGG com Opus.
- Documentos: 100 MB. Os tipos de documentos mais comuns, incluindo PDF e formatos Office.
- Autocolantes: 100 KB animados, 500 KB estáticos, apenas WebP.
Carregar ou usar uma ligação
Há duas formas de enviar o mesmo ficheiro, e falham de maneiras diferentes.
Ao carregar, publica o ficheiro primeiro na Meta e recebe um ID de multimédia para referenciar ao enviar. Ao usar uma ligação, fornece à Meta um URL para obter o ficheiro no momento do envio. A ligação parece mais simples, mas acrescenta uma falha invisível: um URL que abre no seu navegador pode estar inacessível à infraestrutura da Meta devido à localização geográfica, a uma regra de firewall ou a um cookie de sessão que o navegador já possui.
Carregue o ficheiro. É um pedido adicional, mas elimina toda uma classe de falhas.
Receber multimédia
A multimédia recebida chega como um ID de multimédia, não como bytes. O seu handler obtém o ficheiro separadamente usando esse ID.
- Obtenha-a rapidamente. Os IDs não permanecem válidos indefinidamente.
- Uma obtenção falhada devolve o erro 131052, o que normalmente significa que o carregamento do remetente ficou incompleto.
- Guarde o ficheiro por sua conta se precisar dele mais tarde. A Meta não é um arquivo.
- Registe a mensagem mesmo quando a obtenção da multimédia falha, para preservar o texto e o contexto.
O que muda com a Coexistência
A multimédia num número com Coexistência funciona exatamente como em qualquer outro número da Cloud API, com os mesmos limites.
A única diferença relevante é o histórico. Quando um número se liga pela primeira vez, a Meta sincroniza mensagens recentes da aplicação WhatsApp Business, mas essa sincronização inclui o texto das mensagens, não um arquivo completo de multimédia. A multimédia anterior à ligação permanece no telemóvel, onde sempre esteve.
Erros comuns
- Enviar uma ligação por parecer mais simples. A rede da Meta não é o seu navegador.
- Obter multimédia recebida horas mais tarde. Os IDs de multimédia expiram.
- Exportar vídeo sem verificar o codec. As predefinições do software de edição nem sempre são suportadas.
A EasyCoexistence entrega os eventos de mensagens recebidas diretamente da Meta ao seu endpoint, para que os IDs de multimédia cheguem imediatamente ao seu sistema e possam ser obtidos enquanto ainda são válidos.
Perguntas frequentes
Qual é o maior ficheiro que posso enviar?
100 MB, mas apenas para documentos. O vídeo e o áudio têm um limite de 16 MB, e as imagens de 5 MB.
Devo carregar o ficheiro ou enviar um URL?
Carregue-o. Assim, a acessibilidade deixa de ser uma causa de falha.
Durante quanto tempo é válido um ID de multimédia?
Não é válido indefinidamente, por isso a multimédia recebida deve ser obtida assim que o evento chegar.
A multimédia antiga é sincronizada quando faço a ligação?
Não. A sincronização do histórico inclui o conteúdo recente das mensagens; a multimédia anterior à ligação permanece no telemóvel.
Continue a ler
Pronto para começar?
Configure a Coexistência do WhatsApp em minutos, não em meses. A aplicação continua a funcionar no telemóvel.
Começar período experimental gratuitoVerificado em