Saltar para o conteúdo principal
Um modelo WhatsApp pode conter um ficheiro multimédia no cabeçalho: uma imagem, um vídeo ou um documento. Se for bem utilizado, duplica as taxas de abertura e de envolvimento de uma mensagem que, de outra forma, seria apenas de texto. Mal utilizado - formato errado, URL quebrado, tipo MIME incompatível - faz com que o envio falhe ou o modelo pareça amador. Esta página é a referência prática para saber o que funciona, o que não funciona e como explorar os media através do Flowella.

​
Formatos e limites suportados

Estes são os formatos e limites de tamanho que o Meta impõe aos media nos cabeçalhos dos templates (e noutros locais nas mensagens WhatsApp Business Platform).

​
Imagens

FormatoExtensãoTipo MIMETamanho máximo
JPEG.jpeg / .jpgimage/jpeg5 MB
PNG.pngimage/png5 MB
As imagens devem ser 8-bit, RGB ou RGBA. O WebP não é aceite em cabeçalhos de modelos (só é válido em mensagens de autocolantes, que são um tipo de mensagem separado). Dimensões recomendadas: Rácio de aspeto 1,91:1, mínimo de 800×418 px. As imagens quadradas (1:1) também podem ser reproduzidas de forma aceitável. Outros rácios de aspeto são apresentados em caixa alta pelo cliente WhatsApp.

​
Vídeos

FormatoExtensãoTipo MIMETamanho máximo
3GPP.3gpvideo/3gpp16 MB
MP4.mp4video/mp416 MB
Os vídeos devem utilizar o codec de vídeo H.264 e o codec de áudio AAC, com um córrego de áudio único ou sem áudio.
Os vídeos codificados com o perfil H.264 “High” e fotogramas B não são suportados pelos clientes Android WhatsApp. Codificar (ou recodificar) com o perfil H.264 “Principal” sem B-frames, ou com o perfil “Baseline ”, e colocar as caixas moov antes das caixas mdat para uma maior compatibilidade.Se estiver a utilizar o ffmpeg, o sinalizador -movflags faststart trata da ordenação moov/mdat.

​
Documentos

FormatoExtensãoTipo MIMETamanho máximo
PDF.pdfapplication/pdf100 MB
Microsoft Word.doc / .docxapplication/msword / application/vnd.openxmlformats-officedocument.wordprocessingml.document100 MB
Microsoft Excel.xls / .xlsxapplication/vnd.ms-excel / application/vnd.openxmlformats-officedocument.spreadsheetml.sheet100 MB
Microsoft PowerPoint.ppt / .pptxapplication/vnd.ms-powerpoint / application/vnd.openxmlformats-officedocument.presentationml.presentation100 MB
Texto simples.txttext/plain100 MB
Os PDFs são os mais fiáveis em todos os dispositivos. Os documentos do Office funcionam, mas exigem que o destinatário tenha uma aplicação compatível instalada; num telemóvel não empresarial, abrem normalmente como pré-visualizações.

​
O que não funciona

Não é possível incorporar um vídeo do YouTube ou do Vimeo num cabeçalho de modelo. O cabeçalho tem de ser um ficheiro MP4 ou 3GPP que o Meta possa obter e alojar.Se pretender enviar um vídeo do YouTube, existem duas opções:
  1. **Colocar a hiperligação do YouTube no corpo da mensagem ou num botão URL. 2. Tocar no botão abre a aplicação ou o browser do YouTube. A pré-visualização do vídeo apresentada no WhatsApp será uma miniatura estática.
  2. Faça o download do vídeo e carregue-o novamente como MP4. Sujeito aos seus direitos de redistribuição do conteúdo, o que normalmente significa que tem de ser o seu próprio vídeo.
Esta última é a forma de obter uma pré-visualização real do vídeo em conversação.
Os GIFs animados (.gif) não estão na lista suportada. O WhatsApp converte-os do lado do servidor quando partilhados ponto a ponto na aplicação do consumidor, mas a Plataforma Empresarial não o faz. Re-codificar o GIF como um MP4 (que os clientes móveis do WhatsApp reproduzem com reprodução automática e sem som, da mesma forma que mostram um GIF).
As imagens WebP só são válidas para mensagens de autocolantes, não para cabeçalhos de modelos. Converta-as para JPEG ou PNG antes de as utilizar como imagem de cabeçalho.
Por predefinição, os iPhones guardam as fotografias no formato HEIC, que não se encontra na lista suportada. Altere a definição do iPhone para capturar em JPEG ou converta HEIC para JPEG antes de carregar.
Uma imagem de 6 MB, um vídeo de 18 MB ou um PDF de 110 MB serão rejeitados. Comprimir antes de carregar. No caso das imagens, o cliente WhatsApp também comprime novamente no ecrã, pelo que uma fotografia de 4 MB não terá um aspeto significativamente melhor do que uma de 1 MB no ecrã de um telemóvel.

​
Duas formas de anexar media a um modelo

O Meta suporta dois padrões para colocar media num modelo:

​
Padrão 1: Cabo de media (recomendado)

Carregue o ficheiro através do Media API do Meta, obtenha um media handle, e faça referência ao handle quando enviar o modelo. Utilizado pelo Flowella por defeito. Benefícios:
  • O Meta aloja o ficheiro, pelo que não existem falhas de URL quebrado no momento do envio.
  • Entrega mais rápida porque o Meta não tem de ir buscar o ficheiro a um URL externo.
  • Funciona para os limites de tamanho total acima.
O identificador é válido por 30 dias. Se o seu modelo estiver a ser enviado repetidamente com o mesmo suporte, o Flowella actualiza o identificador automaticamente antes de expirar.

​
Padrão 2: URL HTTPS público

Forneça um URL para um ficheiro acessível publicamente. O Meta vai buscá-lo na altura do envio. Isto é útil quando:
  • O ficheiro multimédia muda de acordo com o destinatário (um PDF personalizado, uma etiqueta de envio por encomenda).
  • Os suportes são gerados em tempo real e não se pretende fazer o upload por envio.
Advertências:
  • O URL deve ser publicamente acessível (sem autenticação) e utilizar HTTPS com um certificado válido.
  • Se o URL devolver um erro ou for lento, o envio falha.
  • O Meta armazena em cache o ficheiro obtido durante algum tempo; atualizar o ficheiro no URL não actualiza necessariamente o que é enviado.

​
Como o Flowella lida com o upload de media

Para a maioria dos casos de utilização, o Flowella gere o tratamento dos media por si:
1

Adicionar um ficheiro multimédia de cabeçalho ao criar o modelo

Em Templates → Criar, escolha Imagem, Vídeo ou Documento como tipo de cabeçalho e, em seguida, arraste o ficheiro para a área de carregamento.
2

Flowella valida o ficheiro

O formato, o tamanho e o tipo MIME são verificados antes da submissão. Se o ficheiro não for suportado, é apresentado um erro imediatamente em vez de esperar que o Meta rejeite o modelo.
3

Flowella carrega para o Meta e guarda o identificador

O ficheiro é carregado através do Media API do Meta. O identificador devolvido é guardado no modelo.
4

O envio do modelo inclui o identificador

Quando o template é submetido para aprovação, o Meta vê o media real (não um URL), para que o processo de revisão possa avaliar os visuais como parte da aprovação.
5

Envia a reutilização do mesmo identificador

Até que a mídia do cabeçalho do modelo seja alterada, todos os envios usam o mesmo identificador. Os identificadores são actualizados automaticamente antes de expirarem.
Para suportes de dados por destinatário (PDFs personalizados, etiquetas de envio), utilize a opção URL público no construtor de modelos e passe o URL como uma variável quando acionar o envio a partir de um fluxo de trabalho ou da API. Consulte Acções de fluxo de trabalho.

​
Projetar para a janela de visualização WhatsApp

Algumas notas de design que não aparecem nas especificações do Meta mas que são importantes na prática:
  • Texto em imagens Mantenha-o grande e com alto contraste. O WhatsApp mostra a imagem com uma largura aproximada à do ecrã do telemóvel, por isso qualquer coisa mais pequena do que cerca de 14 px torna-se ilegível.
  • Área segura** O WhatsApp pode cortar ou fazer letterbox; mantenha o conteúdo crítico no centro de 80% da imagem.
  • Consistência da marca: A imagem do cabeçalho e o nome de exibição e foto de perfil do WhatsApp ficam todos próximos uns dos outros - mantenha-os visualmente consistentes.
  • A WhatsApp utiliza a primeira moldura como pré-visualização antes da reprodução do vídeo. Não abra com uma moldura preta ou com um logótipo da empresa; comece com uma imagem significativa.
  • Nome do ficheiro do documento Ao enviar um PDF ou outro documento, o nome do ficheiro é visível para o destinatário. Utilize um nome claro e descritivo, como Acme-Order-12345-Receipt.pdf e não attachment.pdf.

​
Erros comuns e correcções

O tipo MIME real do ficheiro não corresponde ao que foi declarado. Acontece frequentemente quando um “JPEG” exportado pelo iPhone é, na verdade, HEIC, ou quando uma ferramenta renomeia um .docx para .pdf sem converter.Correção: inspecionar o ficheiro (no macOS/Linux: file -I yourfile.png) e reexportar no formato correto ou alterar a extensão para corresponder.
O codec de áudio é algo diferente de AAC, ou há vários fluxos de áudio.Correção: voltar a codificar com ffmpeg -i input.mp4 -c:v libx264 -profile:v main -c:a aac -movflags faststart output.mp4.
Codificado com o perfil H.264 High e B-frames. Reencodificar com perfil Principal ou de Base.
O Meta não consegue aceder ao URL. Causas comuns: o URL requer autenticação, o certificado é inválido, o servidor demora a responder (tempo limite) ou o URL devolve um redireccionamento em vez do ficheiro.Correção: teste o URL com o curl -I para confirmar que ele retorna 200 com o tipo de conteúdo correto e que o certificado é válido. Em seguida, tente novamente.
A fonte é de baixa resolução ou foi aumentada. O WhatsApp não reprocessa a nitidez; o que carrega é o que é mostrado.Correção: carregue pelo menos 800 px na extremidade longa para uma imagem 1.91:1 e não aumente a resolução de uma fonte pequena.

​
Guias relacionados