> ## 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. # Media em cabeçalhos de modelos WhatsApp: imagens e vídeos > Que formatos e tamanhos de media o WhatsApp aceita em cabeçalhos de modelos, porque os links do YouTube não incorporam e como fazer upload e referenciar media através do Flowella. Um modelo WhatsApp pode conter uma peça de media no seu cabeçalho: uma imagem, um vídeo ou um documento. Bem usado, duplica as taxas de abertura e envolvimento de uma mensagem que de outra forma seria apenas texto. Mal usado — formato errado, URL partido, tipo MIME incompatível — faz com que o envio falhe ou que o modelo pareça amador. Esta página é a referência prática para o que funciona, o que não funciona e como encaminhar a media através do Flowella. ## Formatos e limites suportados Estes são os formatos e limites de tamanho que a Meta aplica a media em cabeçalhos de modelos (e noutras mensagens da 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**. WebP **não** é aceite em cabeçalhos de modelos (só é válido em mensagens de sticker, que são um tipo de mensagem separado). **Dimensões recomendadas:** rácio 1,91:1, mínimo 800×418 px. Imagens quadradas (1:1) também renderizam aceitavelmente. Outros rácios são enquadrados em letterbox 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 usar o **codec de vídeo H.264** e o **codec de áudio AAC**, com uma **única faixa de áudio ou sem áudio**. Vídeos codificados com o perfil H.264 **"High" e B-frames** não são suportados pelos clientes WhatsApp Android. Codifique (ou recodifique) com o perfil H.264 **"Main" sem B-frames**, ou com o perfil **"Baseline"**, e coloque as caixas `moov` antes das caixas `mdat` para maior compatibilidade. Se usar ffmpeg, o flag `-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 fiavelmente renderizados em todos os dispositivos. Documentos Office funcionam, mas requerem que o destinatário tenha uma aplicação compatível instalada; num telemóvel não profissional normalmente abrem como pré-visualizações. ## O que não funciona Não pode incorporar um vídeo do YouTube ou Vimeo num cabeçalho de modelo. O cabeçalho tem de ser um ficheiro MP4 ou 3GPP que a Meta possa obter e alojar. Se quiser enviar um vídeo do YouTube, duas opções: 1. **Coloque o link do YouTube no corpo ou num botão URL.** Tocá-lo abre a aplicação do YouTube ou o navegador. A pré-visualização de vídeo mostrada no WhatsApp será uma miniatura estática. 2. **Descarregue o vídeo e volte a fazer upload como MP4.** Sujeito aos seus direitos para redistribuir o conteúdo, o que geralmente significa que tem de ser o seu próprio vídeo. A última opção é a forma de obter uma pré-visualização de vídeo real na conversa. GIFs animados (`.gif`) não estão na lista suportada. O WhatsApp converte-os no servidor quando são partilhados par-a-par na aplicação do consumidor, mas a Business Platform não o faz. Recodifique o GIF como MP4 (que os clientes móveis do WhatsApp reproduzem em auto-play e sem som, da mesma forma que mostram um GIF). Imagens WebP só são válidas para mensagens de sticker, não para cabeçalhos de modelos. Converta para JPEG ou PNG antes de usar como imagem de cabeçalho. Os iPhones guardam por defeito fotos no formato HEIC, que não está na lista suportada. Ou altere a definição do iPhone para capturar em JPEG, ou converta HEIC para JPEG antes do upload. Uma imagem de 6 MB, um vídeo de 18 MB ou um PDF de 110 MB serão rejeitados. Comprima antes do upload. Para imagens, o cliente WhatsApp também recomprime no ecrã, portanto uma foto de 4 MB não vai ficar significativamente melhor do que uma de 1 MB num ecrã de telemóvel. ## Duas formas de anexar media a um modelo A Meta suporta dois padrões para colocar media num modelo: ### Padrão 1: Handle de media (recomendado) Faça upload do ficheiro através da API de Media da Meta, receba um **handle de media** e faça referência ao handle quando enviar o modelo. Usado pelo Flowella por defeito. Benefícios: * A Meta aloja o ficheiro, portanto não há falhas de URL partido no momento do envio. * Entrega mais rápida porque a Meta não tem de ir buscar a um URL externo. * Funciona para os limites de tamanho completos acima. O handle é válido por 30 dias. Se o seu modelo é enviado repetidamente com a mesma media, o Flowella atualiza o handle automaticamente antes de expirar. Para cabeçalhos DOCUMENT, o Flowella também reutiliza media de documentos recentemente carregada onde possível, portanto reenvios do mesmo modelo não precisam de fazer novo upload do ficheiro. Se a Meta rejeitar um ID reutilizado, o Flowella recorre ao upload novamente. ### Padrão 2: URL HTTPS público Forneça um URL para um ficheiro acessível publicamente. A Meta obtém-no no momento do envio. Isto é útil quando: * A media muda por destinatário (um PDF personalizado, uma etiqueta de envio por encomenda). * A media é gerada em tempo real e não quer fazer upload por envio. Ressalvas: * O URL deve ser **acessível publicamente** (sem autenticação) e usar **HTTPS com um certificado válido**. * Se o URL devolver um erro ou for lento, o envio falha. * A Meta faz cache do ficheiro obtido por algum tempo; atualizar o ficheiro no URL não atualiza necessariamente o que é enviado. ## Como o Flowella lida com upload de media Para a maioria dos casos de uso, o Flowella gere o handle de media por si: Em **Modelos → Criar**, escolha **Imagem**, **Vídeo** ou **Documento** como o tipo de cabeçalho, depois **arraste o ficheiro para a zona de upload tracejada** ou clique nela para procurar. Arrastar e largar funciona para os três tipos de cabeçalho e usa o mesmo caminho de upload que clicar. Para cabeçalhos **Documento**, o editor também mostra um campo **Nome de ficheiro do documento** que assume o nome do ficheiro carregado — edite-o para controlar o nome que os destinatários vêem na bolha de documento do WhatsApp. Formato, tamanho e tipo MIME são verificados antes da submissão. Se largar ou escolher um ficheiro não suportado, uma notificação diz-lhe imediatamente o que está errado (tipo errado ou acima do limite de tamanho) em vez de esperar que a Meta rejeite o modelo. O ficheiro é carregado através da API de Media da Meta. O handle devolvido é guardado no modelo. Quando o modelo é submetido para aprovação, a Meta vê a media real (não um URL), portanto o processo de revisão pode avaliar os visuais como parte da aprovação. Até a media de cabeçalho do modelo mudar, cada envio usa o mesmo handle. Os handles são automaticamente atualizados antes da expiração. Para cabeçalhos DOCUMENT, o **Nome de ficheiro do documento** que definiu no editor é persistido com o rascunho, é carregado através da aprovação e publicação da Meta e é usado em cada envio — envios de fluxo de trabalho HubSpot, envios de teste, envios em massa e envios da caixa de entrada mostram todos o seu nome de ficheiro em vez do nome interno do modelo. Quando usa **Modelos → Duplicar**, o Flowella copia o ficheiro de cabeçalho e o **Nome de ficheiro do documento** para o novo rascunho. Se a cópia falhar, o editor mostra um aviso e bloqueia a publicação até refazer o upload do ficheiro. Para media por destinatário (PDFs personalizados, etiquetas de envio), use a opção **URL público** no construtor de modelos e passe o URL como uma variável ao acionar o envio a partir de um fluxo de trabalho ou da API. Consulte [Ações de fluxo de trabalho](/pt/hubspot/workflow-actions). ## Desenhar para o viewport WhatsApp Algumas notas de design que não aparecem na especificação da Meta, mas que importam na prática: * **Texto em imagens.** Mantenha-o grande e com alto contraste. O WhatsApp mostra a imagem aproximadamente à largura do ecrã móvel, portanto qualquer coisa menor do que cerca de 14 px renderiza ilegível. * **Área segura.** O WhatsApp pode cortar ou aplicar letterbox; mantenha o conteúdo crítico nos 80% centrais da imagem. * **Consistência de marca.** A imagem do cabeçalho, o nome de exibição do WhatsApp e a foto de perfil ficam próximos uns dos outros — mantenha-os visualmente consistentes. * **Primeiro frame de um vídeo.** O WhatsApp usa o primeiro frame como a pré-visualização estática antes de o vídeo tocar. Não abra com um frame preto ou um logótipo corporativo; comece numa imagem significativa. * **Nome de ficheiro do documento.** Ao enviar um PDF ou outro documento, o **nome do ficheiro** é visível para o destinatário na bolha de documento do WhatsApp. O editor de modelos expõe um campo **Nome de ficheiro do documento** por baixo do upload do cabeçalho DOCUMENT; assume o nome do ficheiro carregado por defeito e é o que os destinatários realmente vêem quando o modelo é enviado. Use um nome claro e descritivo como `Acme-Encomenda-12345-Recibo.pdf`, não `attachment.pdf` ou o nome de objeto do CDN da Meta. ## Erros comuns e correções O tipo MIME real do ficheiro não corresponde ao declarado. Acontece frequentemente quando um "JPEG" exportado do iPhone é na verdade HEIC, ou quando uma ferramenta renomeia um `.docx` para `.pdf` sem converter. Correção: inspecione o ficheiro (em macOS/Linux: `file -I yourfile.png`) e exporte de novo no formato correto ou altere a extensão para corresponder. O codec de áudio é algo diferente de AAC, ou há várias faixas de áudio. Correção: recodifique com `ffmpeg -i input.mp4 -c:v libx264 -profile:v main -c:a aac -movflags faststart output.mp4`. Codificado com perfil H.264 High e B-frames. Recodifique com perfil Main ou Baseline. A Meta não consegue alcançar o URL. Causas comuns: o URL requer autenticação, o certificado é inválido, o servidor é lento a responder (timeout) ou o URL devolve um redirecionamento em vez do ficheiro. Correção: teste o URL com `curl -I` para confirmar que devolve 200 com o tipo de conteúdo correto e que o certificado valida. Depois tente de novo. A origem tem baixa resolução ou foi ampliada. O WhatsApp não reprocessa para nitidez; o que carregar é o que é mostrado. Correção: carregue pelo menos 800 px no lado longo para uma imagem 1,91:1, e não amplie uma origem pequena. ## Guias relacionados * [Referência do modelo](/pt/app/template-reference) — a estrutura completa do modelo onde esta media se encaixa * [Modelos](/pt/app/templates) — criação de modelos passo a passo no Flowella * [Ações de fluxo de trabalho](/pt/hubspot/workflow-actions) — passar URLs de media por destinatário através de fluxos de trabalho HubSpot This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.