Template de mensagem do WhatsApp API: categorias e aprovação

Template de mensagem do WhatsApp API: categorias e aprovação

Um template de mensagem do WhatsApp API é um texto pré-aprovado pela Meta que a empresa pode enviar quando não há conversa aberta com o cliente, como um aviso ou um primeiro contato. Para ser aprovado, ele precisa estar na categoria correta (marketing, utilidade ou autenticação), ter conteúdo claro, variáveis com exemplos e um consentimento do cliente por trás. O agente de IA não inventa esse texto: ele escolhe um template aprovado, preenche as variáveis permitidas e, quando o cliente responde, volta a conversar em texto livre.

Principais pontos

• Template é a forma de iniciar conversa ou retomá-la quando a janela de atendimento está fechada. Dentro da janela, o texto é livre.
• A categoria (marketing, utilidade ou autenticação) define regras de conteúdo e a forma de cobrança. A Meta pode reclassificar um template se achar que a categoria declarada não corresponde ao texto.
• Aprovação depende de texto específico, exemplos de variáveis, finalidade clara e respeito às políticas de comércio e de mensagens da plataforma.
• O agente de IA deve trabalhar com uma lista fechada de templates aprovados, validar a janela antes de enviar e registrar cada decisão.
• Opt-in, LGPD e qualidade das mensagens importam tanto quanto o texto: envio indesejado derruba a avaliação de qualidade e pode levar a restrições no número.

O que é um template e quando ele é obrigatório?

O WhatsApp Business Platform separa dois tipos de mensagem enviada pela empresa. O primeiro é a mensagem de sessão, em texto livre, permitida enquanto a janela de atendimento estiver aberta. A janela se abre quando o cliente escreve para a empresa e permanece aberta por um período definido pela Meta (consulte o valor atual na documentação oficial, porque a plataforma pode alterá-lo). O segundo tipo é o template, necessário quando a empresa quer falar primeiro ou quando a janela já fechou.

Na prática, isso significa que toda automação que dispara aviso de pedido, lembrete de agendamento, cobrança ou retorno de orçamento depende de templates. Já a resposta a uma pergunta que o cliente acabou de fazer não depende.

Um template tem componentes: cabeçalho (opcional), corpo, rodapé (opcional) e botões (opcionais, como resposta rápida ou link). O corpo carrega variáveis numeradas entre chaves duplas, que são substituídas no momento do envio. Cada template recebe um nome interno, um idioma e uma categoria, e passa por análise antes de poder ser usado. Os detalhes técnicos de criação e envio estão na documentação da Meta sobre envio de templates.

Antes de tudo isso, a conta precisa estar apta a operar. Se sua empresa ainda não concluiu esse passo, vale ler o guia de verificação de empresa na Meta para WhatsApp.

Quais são as categorias de template e como escolher?

A documentação da Meta organiza os templates em três categorias. A escolha errada é uma das causas mais comuns de rejeição ou de reclassificação automática.

• Utilidade: mensagem específica, solicitada ou esperada pelo cliente, ligada a uma transação ou conta existente. Exemplos: confirmação de pedido, aviso de entrega, lembrete de consulta já marcada, atualização de status de um serviço contratado. O texto não deve conter promoção.
• Marketing: tudo o que promove, divulga, convida a comprar ou tenta reengajar. Ofertas, lançamentos, campanhas, pesquisa de reativação e convites para eventos entram aqui. Se o texto de utilidade ganha uma frase de oferta, a Meta tende a tratá-lo como marketing.
• Autenticação: envio de código de uso único para verificar identidade, em formato próprio, com regras mais rígidas de conteúdo. Não é espaço para outro assunto.

Um guia de decisão simples, na ordem:

• O cliente fez uma ação ou contratou algo que justifica esta mensagem agora? Se sim, candidate a utilidade.
• A mensagem tem qualquer elemento de oferta, desconto, convite comercial ou incentivo a nova compra? Se sim, é marketing, mesmo que venha junto de uma informação útil.
• A mensagem serve apenas para entregar um código de verificação? Então é autenticação.
• Na dúvida, escolha a categoria mais conservadora e prefira separar em dois templates: um de utilidade, sem apelo comercial, e outro de marketing, enviado só a quem aceitou receber.

A forma de cobrança e os limites de envio dependem da categoria e mudam com o tempo. Por isso, consulte a tabela vigente da Meta antes de planejar volume, em vez de copiar valores de artigos antigos. Para entender como isso se encaixa em campanhas e consentimento, veja também mensagens ativas no WhatsApp: templates, opt-in e boas práticas.

Como redigir um template que a Meta aprova?

A análise combina verificação automática e, às vezes, revisão humana. O que a documentação e a política comercial do WhatsApp deixam claro serve de roteiro de redação:

• Finalidade evidente: quem lê precisa entender em uma frase por que está recebendo aquilo. Textos genéricos como "temos uma novidade para você" tendem a ser barrados.
• Variáveis com contexto: não deixe variável sozinha no início ou no fim do corpo, nem duas coladas sem texto entre elas. Cerque cada variável com palavras que expliquem o que ela representa.
• Exemplos realistas: no envio para análise, cada variável exige um exemplo. Use valores plausíveis e sem dados reais de clientes.
• Categoria coerente: um aviso de utilidade que termina com "aproveite nossa promoção" será reclassificado ou rejeitado.
• Sem conteúdo proibido: a política de comércio e a política de mensagens do WhatsApp restringem certos produtos e práticas, e proíbem solicitar dados sensíveis, como senhas ou dados completos de cartão, por mensagem. Leia a política de mensagens do WhatsApp Business antes de redigir.
• Tom profissional e idioma correto: o idioma declarado precisa ser o do texto. Evite excesso de maiúsculas, pontuação repetida e links encurtados que escondem o destino.
• Opção de saída: em templates de marketing, ofereça uma forma simples de o cliente parar de receber, como um botão de resposta rápida.

Um exemplo de redação melhor, em utilidade: "Olá, [nome]. O pedido [número do pedido] saiu para entrega e deve chegar no endereço cadastrado. Se precisar alterar algo, responda esta mensagem." Compare com "Olá, [nome]! Novidades para você! Confira!", que não informa nada, não cita ação do cliente e provavelmente seria barrado ou tratado como marketing.

Se um template for rejeitado, a própria plataforma indica o motivo. Corrija o ponto específico e reenvie, em vez de criar dezenas de variações às cegas.

Passo a passo para criar, aprovar e manter um template

Uma sequência de trabalho que reduz retrabalho:

• Defina o gatilho: qual evento do processo dispara a mensagem (pedido enviado, orçamento pronto, consulta marcada) e quem é o destinatário.
• Confirme o consentimento: registre onde e quando o cliente aceitou receber mensagens por WhatsApp e para qual finalidade.
• Escolha a categoria com o guia de decisão da seção anterior.
• Redija o corpo com a menor quantidade possível de variáveis e com contexto em volta de cada uma.
• Prepare os exemplos de variáveis, sem dados reais.
• Envie para análise pelo gerenciador do WhatsApp ou pela API e aguarde o status.
• Acompanhe o status e a avaliação de qualidade. Templates podem ser pausados ou desativados se muitos clientes bloquearem ou denunciarem o remetente.
• Revise periodicamente: remova templates sem uso e ajuste os que geram reclamação.

Como o agente de IA deve usar templates fora da janela de atendimento?

Aqui está o ponto em que muitas implantações quebram. Um agente de IA conversa bem em texto livre, mas fora da janela ele não pode simplesmente gerar uma frase nova. A plataforma só aceita um template aprovado. O desenho correto separa três responsabilidades.

Primeiro, uma regra determinística (sem IA) verifica se a janela está aberta, olhando o horário da última mensagem recebida do cliente. Essa checagem não deve ser delegada ao modelo, porque um erro vira mensagem rejeitada ou envio indevido.

Segundo, se a janela estiver fechada, o agente só pode escolher entre uma lista fechada de templates aprovados, cada um com finalidade, categoria e variáveis descritas. O modelo ajuda a decidir qual template cabe no contexto e extrai os valores das variáveis a partir de dados do sistema (pedido, agenda, ordem de serviço), não do texto livre do cliente.

Terceiro, o envio passa por validações: o cliente tem consentimento registrado para aquela finalidade? A variável tem formato esperado? Há limite de frequência por contato? Se qualquer validação falha, o agente não envia e encaminha o caso para uma pessoa.

Quando o cliente responde ao template, a janela se reabre e o agente volta ao texto livre, agora com o contexto do template enviado. Vale que o histórico mostre qual template saiu, com quais valores e por qual motivo. Esse registro ajuda na auditoria, no atendimento ao titular de dados e na investigação de reclamações.

Três cuidados adicionais:

• Dados pessoais nas variáveis: envie só o necessário. Evite inserir diagnóstico, valores de dívida ou informações sensíveis em template. A ANPD é a referência para orientações de proteção de dados no Brasil.
• Entradas não confiáveis: se o texto do cliente alimenta o modelo, trate-o como não confiável. O OWASP Top 10 para aplicações com LLM descreve riscos como injeção de prompt, que podem levar o agente a preencher variáveis com conteúdo indevido.
• Volume e reputação: disparos em massa sem consentimento prejudicam a qualidade e podem afetar o número. O artigo sobre número de WhatsApp banido e como evitar com agente de IA detalha esse risco.

Se você monta o fluxo em uma ferramenta de automação, o guia de n8n com WhatsApp Cloud API mostra como organizar webhook, verificação e envio.

Cenário ilustrativo: aviso de aparelho pronto

Imagine, como cenário ilustrativo, uma assistência técnica que atende pelo WhatsApp. O cliente deixou um aparelho para reparo e conversou com o agente no dia da entrada. Dias depois, o técnico marca a ordem de serviço como concluída no sistema.

O fluxo seria assim: o evento do sistema aciona a automação. A regra determinística consulta a última mensagem do cliente e vê que a janela fechou. O agente recebe a lista de templates permitidos e seleciona o de utilidade "serviço concluído", cujo corpo informa que o aparelho da ordem [número] está pronto para retirada e convida o cliente a responder com dúvidas. Os valores vêm do sistema, não de texto livre. A validação confirma o consentimento registrado na abertura da ordem. A mensagem sai e o registro guarda template, variáveis e horário.

Se o cliente responder perguntando sobre garantia, a janela reabre e o agente volta ao texto livre, consultando as regras da empresa. Se a pergunta fugir do que ele pode decidir, ele transfere para uma pessoa com o resumo da conversa. Esse tipo de processo é detalhado em IA para assistência técnica de celulares.

Perceba o que o agente não faz: não escreve o aviso do zero, não adiciona oferta de acessório (isso viraria marketing e exigiria outro template e outro consentimento) e não envia se faltar dado.

Como mapear, limitar, pilotar e transferir aplicam-se a templates?

O método segue quatro movimentos. Em mapear, a empresa lista as mensagens que hoje saem por iniciativa dela, o gatilho de cada uma e onde o consentimento é registrado. Em limitar, define a lista fechada de templates, as variáveis permitidas, o limite de frequência e os dados que nunca entram em mensagem. Em pilotar, escolhe um único fluxo real, como o aviso de pedido pronto, com logs e uma métrica de sucesso combinada antes, por exemplo taxa de resposta ou de reclamações. Em transferir, entrega a operação documentada e decide se amplia, ajusta ou interrompe, com uma pessoa responsável por revisar os templates e a avaliação de qualidade.

Esse ritmo evita o erro comum de aprovar uma dúzia de templates de uma vez e descobrir tarde que metade foi reclassificada ou gera bloqueios. Para a visão geral de implantação, veja como integrar IA no WhatsApp da sua empresa.

Perguntas frequentes

Quanto tempo leva a aprovação de um template? A Meta informa que a análise costuma ser rápida, mas o prazo pode variar e não há garantia. Planeje o lançamento com folga e não dependa da aprovação no mesmo dia de uma campanha ou de uma mudança de processo.

Posso usar um template de utilidade para divulgar uma promoção? Não é recomendado. Se o texto contém conteúdo promocional, a Meta pode reclassificá-lo como marketing, com regras e cobrança próprias. O caminho correto é criar um template de marketing separado e enviá-lo apenas a quem deu consentimento para esse tipo de contato.

O agente de IA pode criar templates sozinho? Não deveria. A criação e a revisão de templates envolvem política da plataforma, categoria, consentimento e imagem da marca, e devem passar por uma pessoa responsável. O agente atua depois, escolhendo entre templates já aprovados e preenchendo variáveis validadas.

O que acontece se o cliente não responder ao template? A conversa não é aberta, e o agente continua limitado a templates aprovados para aquele contato. Não insista com envios repetidos: defina um limite de tentativas, registre o resultado e, se o assunto for importante, acione um canal alternativo ou uma pessoa da equipe.

Fontes

• Meta: envio de mensagens de template na WhatsApp Cloud API
• WhatsApp Business: política de mensagens
• ANPD: Autoridade Nacional de Proteção de Dados
• OWASP Top 10 for LLM Applications