> ## Documentation Index > Fetch the complete documentation index at: https://knowledge.flowella.io/llms.txt > Use this file to discover all available pages before exploring further. # Multimédia nos cabeçalhos dos modelos WhatsApp: imagens e vídeos > Que formatos e tamanhos de multimédia o WhatsApp aceita nos cabeçalhos dos modelos, porque as ligações do YouTube não são incorporadas, e como carregar e referenciar multimédia através do Flowella. 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 | Formato | Extensão | Tipo MIME | Tamanho máximo | | ------- | ---------------- | ------------ | -------------- | | JPEG | `.jpeg` / `.jpg` | `image/jpeg` | 5 MB | | PNG | `.png` | `image/png` | 5 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 | Formato | Extensão | Tipo MIME | Tamanho máximo | | ------- | -------- | ------------ | -------------- | | 3GPP | `.3gp` | `video/3gpp` | 16 MB | | MP4 | `.mp4` | `video/mp4` | 16 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 | Formato | Extensão | Tipo MIME | Tamanho máximo | | -------------------- | ---------------- | ------------------------------------------------------------------------------------------------------------- | -------------- | | PDF | `.pdf` | `application/pdf` | 100 MB | | Microsoft Word | `.doc` / `.docx` | `application/msword` / `application/vnd.openxmlformats-officedocument.wordprocessingml.document` | 100 MB | | Microsoft Excel | `.xls` / `.xlsx` | `application/vnd.ms-excel` / `application/vnd.openxmlformats-officedocument.spreadsheetml.sheet` | 100 MB | | Microsoft PowerPoint | `.ppt` / `.pptx` | `application/vnd.ms-powerpoint` / `application/vnd.openxmlformats-officedocument.presentationml.presentation` | 100 MB | | Texto simples | `.txt` | `text/plain` | 100 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: 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. 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. O ficheiro é carregado através do Media API do Meta. O identificador devolvido é guardado no modelo. 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. 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](/pt/hubspot/workflow-actions). ## 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 * [Referência do modelo](/pt/app/template-reference) - a estrutura completa do modelo em que este suporte se insere * [Modelos](/pt/app/templates) - criação de modelos passo-a-passo no Flowella * [Acções de fluxo de trabalho](/pt/hubspot/workflow-actions) - passagem de URLs de media por destinatário através de fluxos de trabalho HubSpot