API oficial

Template com mídia no WhatsApp: o cabeçalho que quase ninguém usa e que muda a taxa de resposta

Por VeyloCRM · · 11 min de leitura

Todo template da API oficial pode ter uma imagem, um vídeo ou um PDF no topo. É o recurso que mais muda leitura e resposta sem aumentar o custo da conversa, e também o que mais trava gente na hora de cadastrar, por causa de um passo mal explicado de mídia de exemplo. Este guia resolve o cadastro, mostra a mídia variável por contato e traz os números de uma campanha comparada.

O que é um template com mídia

Na API oficial do WhatsApp, toda mensagem que a empresa inicia precisa usar um modelo aprovado pela Meta — o template. O que muita empresa não sabe é que esse modelo pode ter, no topo, um cabeçalho de mídia: uma imagem, um vídeo ou um documento em PDF.

A diferença de resultado é grande. Uma mensagem só de texto compete com dezenas de outras na tela do cliente. Uma mensagem com imagem ocupa mais espaço, é vista antes de ser lida e comunica em um segundo o que o texto levaria três linhas para explicar. Em campanhas de produto, agenda, evento e cobrança, o cabeçalho de mídia é frequentemente a diferença entre a pessoa abrir e a pessoa ignorar.

Também é onde mais gente trava na hora de criar o modelo. O processo de envio de mídia de exemplo durante o cadastro é pouco explicado, o erro que a Meta devolve é genérico, e é comum a empresa desistir e publicar o template só com texto — perdendo desempenho sem nem saber por quê.

Este guia explica os três tipos de cabeçalho, o que cada um serve, as regras de formato e tamanho, o passo da mídia de exemplo que derruba tanta gente, como funciona a mídia variável por contato, o que a Meta costuma reprovar e como medir se valeu a pena.

Vale dizer de saída o que está em jogo. Em operações que medem, trocar um template só de texto por um template com cabeçalho de imagem costuma mexer em dois números ao mesmo tempo: quantas pessoas leem e quantas respondem. O custo da conversa cobrado pela Meta é o mesmo nos dois casos, e o custo da arte é uma hora de trabalho reaproveitável — o que torna essa uma das poucas mudanças em que o ganho não vem acompanhado de aumento de gasto.

E há um recurso dentro desse assunto que quase ninguém usa e que muda operação inteira: a mídia variável, que permite mandar um arquivo diferente para cada contato usando o mesmo modelo aprovado. É o que transforma cobrança, faturamento e pós-venda, porque elimina o envio manual de boleto, nota e comprovante um por um.

Leitura liberada

Continue lendo de graça

Preencha uma vez e libere este e todos os outros artigos do blog. Não cobramos nada — só queremos saber para quem estamos escrevendo.

Leva 20 segundos. Prefere falar direto no WhatsApp?

Os três tipos de cabeçalho de mídia

  • Imagem. O mais usado e o de melhor relação entre esforço e resultado. Serve para produto, promoção, cardápio, comprovante visual, convite e lembrete com identidade visual.
  • Vídeo. Funciona muito bem em lançamento, demonstração e recado pessoal do dono do negócio. Tem custo de produção maior e exige atenção ao tamanho do arquivo.
  • Documento. O mais subestimado. É o formato correto para boleto, nota, contrato, proposta, cardápio em PDF, catálogo e comprovante — tudo que o cliente precisa guardar ou encaminhar.

Existe ainda o cabeçalho de texto simples, que não é mídia, e o de localização, útil para quem entrega ou atende presencialmente. A escolha não é estética: é sobre o que o cliente vai fazer com aquilo. Se ele precisa guardar, é documento. Se ele precisa entender rápido, é imagem.

Regras de formato e tamanho

As especificações exatas mudam com o tempo e precisam ser conferidas na documentação oficial antes de produzir o material, mas alguns princípios se mantêm e economizam retrabalho:

  • formatos aceitos são limitados — imagem em JPG ou PNG, vídeo em MP4, documento em PDF são o caminho seguro;
  • existe limite de tamanho de arquivo, e ele é menor do que a maioria imagina, principalmente em vídeo;
  • proporção importa: imagem muito alta ou muito larga é cortada na exibição, e o corte costuma comer exatamente o texto que alguém colocou dentro da arte;
  • texto dentro da imagem fica ilegível em tela pequena, e a leitura da maioria acontece em tela pequena;
  • vídeo sem som precisa funcionar, porque boa parte das pessoas abre sem áudio.

A regra prática que resolve quase tudo: teste a arte no seu próprio celular antes de cadastrar o template. O que parece ótimo no computador frequentemente aparece cortado no telefone.

Como produzir a arte que funciona nesse canal

A arte de um cabeçalho de WhatsApp não segue as mesmas regras de um post de rede social, e usar o mesmo arquivo nos dois lugares é um erro comum. Três diferenças mandam.

A primeira é o espaço. O cabeçalho aparece pequeno na lista de conversas e maior só quando a pessoa abre. Isso significa que o elemento principal precisa ser reconhecível em miniatura — um produto, um rosto, uma cor de marca — e que qualquer texto pequeno é inútil.

A segunda é a divisão de trabalho entre imagem e corpo. A imagem chama atenção; o corpo informa e convence. Colocar o preço, o prazo e a condição dentro da arte e deixar o corpo vazio desperdiça o único lugar da mensagem que é pesquisável, copiável e legível em qualquer aparelho. O contrário funciona melhor: imagem limpa, corpo com a informação.

A terceira é a repetição. Quem recebe várias campanhas da mesma empresa começa a ignorar um padrão visual repetido. Variar a imagem entre campanhas, mantendo a identidade, preserva a atenção — e é mais barato do que aumentar a base.

Uma prática simples melhora tudo isso: antes de mandar para milhares de pessoas, envie o template para três números da própria equipe, em aparelhos diferentes, e olhe como aparece na lista de conversas, não só dentro da conversa aberta. É ali que a decisão de abrir acontece.

A mídia de exemplo: o passo que trava todo mundo

Para aprovar um template com cabeçalho de mídia, a Meta exige uma amostra — um arquivo de exemplo enviado durante a criação do modelo, para que o revisor veja como a mensagem vai aparecer.

Esse é o ponto em que a maioria trava, porque o processo tem duas etapas que não são óbvias: o arquivo precisa ser enviado antes, em um passo separado, e o identificador devolvido por esse envio é que vai no cadastro do template. Quando alguém tenta colar a URL de uma imagem hospedada em outro lugar, ou usa um identificador de um envio anterior, a resposta costuma ser um erro genérico de parâmetro inválido, que não explica nada.

Duas orientações práticas para quem opera:

  • a mídia de exemplo é só uma amostra para a análise — ela não precisa ser a mídia final que você vai enviar em cada campanha, e na maioria dos casos não será;
  • se o seu sistema não oferece o campo de mídia de exemplo na tela de criação de template, ele provavelmente não suporta cabeçalho de mídia, e essa é uma pergunta a fazer antes de contratar.

Mídia fixa e mídia variável por contato

Depois de aprovado, o template pode ser enviado de duas formas quanto à mídia:

  • Mídia fixa — a mesma imagem para toda a lista. É o caso de promoção, aviso e convite.
  • Mídia variável — cada contato recebe um arquivo diferente no cabeçalho, usando o mesmo template aprovado. É o que permite mandar o boleto de cada cliente, a nota de cada pedido, o comprovante de cada pagamento ou o contrato de cada pessoa.

A mídia variável é o recurso que mais muda operação e o menos conhecido. Com ele, uma empresa deixa de precisar de um template por cliente e passa a ter um único modelo de "seu boleto chegou" que entrega o arquivo certo para cada pessoa. Isso transforma cobrança, faturamento e pós-venda.

O texto do template também aceita variáveis, então é possível combinar: nome da pessoa no corpo, valor e vencimento nas variáveis, e o PDF individual no cabeçalho.

Documento variável na prática: o que muda na operação

Vale detalhar o caso de uso que mais economiza tempo, porque ele costuma passar despercebido. Uma empresa que emite cem boletos por mês normalmente envia cada um manualmente: abre a conversa, anexa o PDF, escreve o texto, confere o nome. São alguns minutos por cliente, mais o retrabalho de quem se perde no meio e manda o arquivo errado para a pessoa errada — o que, em cobrança, é um problema sério de privacidade.

Com um template de utilidade aprovado, com cabeçalho de documento e variáveis no corpo, essa mesma operação vira um envio em lote: a lista traz o telefone, o nome, o valor, a data e o link do arquivo de cada pessoa, e cada contato recebe o documento dele com o texto personalizado. O que levava um turno passa a levar minutos, e o risco de trocar arquivo entre clientes desaparece porque o vínculo é feito por dado, não por atenção humana.

Três cuidados fazem esse fluxo funcionar. O arquivo precisa estar acessível para o envio no momento do disparo, com nome que faça sentido para quem recebe, já que o nome do arquivo aparece na conversa. A base precisa estar correta, porque erro de telefone em documento financeiro é mais grave do que em promoção. E o template precisa estar na categoria adequada ao conteúdo, o que em cobrança e comprovante costuma significar utilidade.

Categoria certa evita reprovação

Template com mídia segue as mesmas regras de categoria de qualquer outro. Escolher a categoria errada é uma das causas mais frequentes de reprovação e, quando passa, de custo mais alto do que o necessário.

A leitura simples: se a mensagem existe porque o cliente fez alguma coisa — comprou, agendou, solicitou, pediu a segunda via — ela tende a ser de utilidade. Se ela existe para vender, promover ou reativar, é marketing. Tentar enquadrar promoção como utilidade para pagar menos é o caminho mais rápido para reprovação e para desgaste da conta.

O que a Meta costuma reprovar nesses templates

  • imagem cujo conteúdo não tem relação com o texto do template;
  • arte inteiramente composta por texto promocional, que é lida como tentativa de burlar a análise do texto;
  • mídia com conteúdo sensível ou que viole as políticas de comércio da plataforma;
  • uso de marca, logo ou identidade de terceiros sem relação com a empresa;
  • promessa em imagem que o corpo da mensagem não sustenta;
  • arquivo de exemplo genérico demais, sem relação nenhuma com o uso declarado.

Vale lembrar que o revisor vê a amostra. Enviar uma foto aleatória só para passar do campo obrigatório aumenta a chance de reprovação.

Quando a mídia ajuda e quando atrapalha

Nem toda mensagem melhora com imagem. Três casos em que a mídia atrapalha:

  • Mensagem de autenticação, como código de verificação, que precisa ser instantânea, direta e sem distração.
  • Mensagem curta e urgente, do tipo "seu pedido saiu para entrega", em que a imagem só adiciona peso.
  • Conversa em andamento, dentro da janela de atendimento, onde a empresa pode simplesmente mandar a mídia diretamente, sem template nenhum.

E três em que ela ajuda muito: catálogo e produto, em que ver é decidir; documento que o cliente precisa guardar; e reativação de base fria, em que o desafio é fazer a pessoa parar de rolar a tela.

A conta que mostra se valeu a pena

Comparação real de uma mesma campanha de reativação, enviada em duas levas para públicos equivalentes de 2.000 contatos cada:

  • Só texto: 1.914 entregues, 622 leram, 71 responderam, 12 vendas
  • Com imagem no cabeçalho: 1.902 entregues, 848 leram, 134 responderam, 23 vendas
  • Custo das conversas: praticamente idêntico nos dois casos
  • Custo da arte: 1 hora de trabalho, reutilizável em outras campanhas

O ponto relevante é que a mídia não muda a entrega — ela muda a leitura e a resposta. Quem tem problema de entrega tem problema de base e de opt-in, e nenhuma imagem resolve isso. Quem tem entrega boa e resposta baixa costuma ter muito a ganhar com o cabeçalho.

Os erros mais comuns

  • Colocar todo o texto da oferta dentro da imagem, deixando o corpo vazio.
  • Usar arte feita para computador, que corta no celular.
  • Enviar boleto como imagem em vez de documento, impedindo o cliente de encaminhar ou imprimir.
  • Tratar a mídia de exemplo como se fosse a mídia definitiva.
  • Escolher categoria de utilidade em campanha promocional.
  • Não testar a mensagem no próprio celular antes de mandar para a base inteira.

Por onde começar

Escolha uma mensagem que você já envia com frequência e transforme em template com cabeçalho; produza a arte no formato correto e teste no seu celular; cadastre com a mídia de exemplo coerente com o uso real; rode uma primeira campanha comparando com a versão só texto, para ter o seu próprio número; e monte o modelo de documento variável para cobrança ou comprovante, que costuma ser o de maior impacto operacional. Um único template de documento individual bem feito resolve um problema que muitas empresas ainda resolvem mandando arquivo manualmente, um por um.

Perguntas frequentes

Como colocar imagem no template do WhatsApp?

O template precisa ser criado com um cabeçalho do tipo mídia, e a Meta exige uma amostra do arquivo durante a criação, para que o revisor veja como a mensagem vai aparecer. É nesse passo que a maioria trava, porque ele tem duas etapas pouco explicadas: o arquivo precisa ser enviado antes, em uma operação separada, e o identificador devolvido por esse envio é o que vai no cadastro do modelo. Colar a URL de uma imagem hospedada em outro lugar costuma gerar um erro genérico de parâmetro inválido que não explica nada. Vale lembrar que a mídia de exemplo é apenas uma amostra para a análise e não precisa ser a imagem final de cada campanha.

Dá para enviar um boleto ou nota diferente para cada cliente?

Sim, e esse é o recurso mais subestimado dos templates com mídia. Depois de aprovado, um modelo com cabeçalho de documento pode ser enviado com mídia variável, o que significa que cada contato recebe o arquivo dele usando o mesmo template. Combinando com variáveis no corpo, é possível personalizar nome, valor e vencimento na mesma mensagem. Na prática, uma empresa que emitia cem boletos por mês e enviava um a um, manualmente, passa a fazer isso em lote, em minutos, e elimina o risco de mandar o arquivo de um cliente para outro, que em cobrança é um problema sério de privacidade.

Quando não vale a pena colocar mídia no template?

Em três situações. Nas mensagens de autenticação, como código de verificação, em que a mensagem precisa ser instantânea e sem distração. Nas mensagens curtas e urgentes, do tipo pedido saiu para entrega, em que a imagem só adiciona peso sem acrescentar informação. E dentro de uma conversa já aberta na janela de atendimento, em que a empresa pode simplesmente enviar a mídia diretamente, sem usar template nenhum. Vale lembrar também que mídia não melhora entrega: se a taxa de entrega está baixa, o problema é a base e o opt-in, e nenhuma imagem resolve isso.

Um modelo aprovado, um arquivo diferente para cada cliente.

No VeyloCRM você cria o template com cabeçalho de mídia, envia boleto, nota ou comprovante individual em lote e acompanha entrega, leitura e resposta de cada contato.