API oficial do WhatsApp
Templates do WhatsApp: categorias, aprovação e como evitar reprovação
Templates do WhatsApp: quando são obrigatórios, as categorias marketing, utilidade e autenticação, a revisão da Meta e como escrever sem ser reprovado.

Na API oficial do WhatsApp, fora da janela de 24 horas aberta pela última mensagem do cliente, a empresa só pode escrever com um modelo (template) aprovado pela Meta. Cada modelo tem uma categoria (marketing, utilidade ou autenticação), que a Meta confere na criação, pode mudar depois e que define a tarifa cobrada. A decisão da revisão sai em até 24 horas, e as reprovações mais comuns vêm de variáveis mal formatadas, pedido de dados sensíveis, duplicatas e promoção disfarçada de aviso. Aprovado, o modelo continua sendo avaliado pela reação de quem recebe e pode ser pausado.
Você escreveu o aviso de pedido com carinho, mandou para aprovação e ele voltou reprovado. Ou foi aprovado como utilidade e, semanas depois, apareceu como marketing, com outra tarifa. Os modelos de mensagem, que todo mundo chama de templates, são a parte da API oficial do WhatsApp que mais gera dúvida. Este guia explica como eles funcionam, com as regras da Meta como estavam em setembro de 2026, e como escrever modelos que passam na revisão e são bem recebidos.
Se você ainda está decidindo entre o app WhatsApp Business e a plataforma, comece pelo nosso comparativo entre o app e a API oficial.
Quando você é obrigado a usar um template?
Sempre que a janela de atendimento de 24 horas estiver fechada. Fora dela, a empresa só pode escrever com um modelo aprovado.
Segundo a documentação de mensagens de serviço, quando o cliente manda mensagem ou liga, abre-se uma janela de 24 horas, e cada nova mensagem dele reinicia o relógio. Dentro dela, você responde como quiser, sem aprovação prévia. Quando ela fecha, só saem modelos pré-aprovados.
Na prática, isso inclui quase tudo que a empresa inicia: a confirmação do pedido feito no site, o lembrete da consulta, a campanha do fim de semana, o código de login. A Política de Mensagens do WhatsApp Business acrescenta que cada modelo só pode ser usado para a finalidade para a qual foi criado.
E o modelo aprovado não substitui o consentimento: a mesma política exige que a pessoa tenha dado o número e aceitado receber mensagens da sua empresa. Sobre como coletar e registrar esse aceite, veja o guia de LGPD no WhatsApp e no e-mail.
Quais são as categorias e como escolher a certa?
Todo modelo tem uma de três categorias: marketing, utilidade ou autenticação. A categoria define como a Meta trata o modelo e quanto você paga por mensagem entregue. As definições estão no guia de categorização de modelos, atualizado pela Meta em 15 de setembro de 2026:
| Categoria | Para que serve | Exemplos típicos | Ponto de atenção |
|---|---|---|---|
| Marketing | Gerar reconhecimento, vender, reativar, criar relacionamento | Oferta, lançamento, carrinho abandonado, aniversário, convite para renovar assinatura | A mais flexível. Conteúdo misto ou vago também cai aqui |
| Utilidade | Acompanhar uma ação ou pedido do cliente, ou avisar algo essencial | Confirmação e atualização de pedido, alerta de conta, pesquisa sobre um atendimento específico, confirmação de opt-in | Não pode ter intenção promocional nem persuasiva |
| Autenticação | Verificar a identidade com código de uso único | Código de login, de recuperação de conta, de confirmação de transação | Texto fixo da Meta; sem URL, mídia ou emoji |
Para ser utilidade, o modelo precisa cumprir dois critérios ao mesmo tempo: ser não promocional e ser específico do cliente (ligado ao pedido, à conta ou à transação dele) ou essencial para ele, como um alerta de fraude ou o recall de um produto que ele comprou.
Três armadilhas que a própria Meta aponta:
- Conteúdo misto é marketing. Atualização de pedido com cupom, ou pesquisa de satisfação com oferta, é classificada como marketing.
- Conteúdo vago é marketing. Um modelo que é só uma variável, ou só “Parabéns!”, entra como marketing.
- Interação anterior não transforma venda em aviso. Carrinho abandonado e convite para renovar assinatura são marketing, mesmo quando o cliente interagiu com você antes.
As tarifas por categoria variam por país e mudam com o tempo; os valores ficam na página oficial de preços da Meta, e a mudança prevista para 1º de outubro de 2026 está no nosso comparativo. Guarde uma frase dessa página: a empresa é responsável por conferir a categoria dos modelos aprovados e, a cada envio, aceita o custo da categoria aplicada naquele momento.
Como a Meta decide e muda a categoria de um modelo?
Você escolhe a categoria ao criar o modelo, e a Meta confere se ela bate com o conteúdo. Desde 9 de abril de 2025, se você marcar utilidade e a Meta entender que é marketing, o modelo é aprovado direto como marketing.
A conferência continua depois. Desde 1º de julho de 2024, a Meta revisa periodicamente modelos já aprovados, inclusive os que já tinham passado por análise:
- Utilidade que deveria ser marketing: a Meta avisa com um dia de antecedência, por e-mail aos administradores e por webhook, e muda a categoria. O modelo continua aprovado, só que como marketing.
- Marketing ou utilidade que deveria ser autenticação: desde 1º de outubro de 2024, o modelo é reprovado no primeiro dia do mês seguinte ao aviso e deixa de funcionar.
Se discordar da nova categoria, você pode pedir análise pelo Suporte para Empresas, a partir do Gerenciador do WhatsApp, em até 60 dias.
Quem insiste em classificar marketing como utilidade enfrenta restrições progressivas. Desde 16 de abril de 2025, a empresa que já recebeu aviso por uso indevido perde o aviso prévio: a recategorização passa a ser imediata. Depois vêm um limite de volume para mensagens de utilidade (mínimo de sete dias), a conversão de todos os modelos de utilidade da conta em marketing (7 dias, ou 30 na reincidência) e a mesma medida em todo o portfólio empresarial (30 dias).
Do que um template é feito?
Um modelo tem quatro componentes: cabeçalho, corpo, rodapé e botões. Só o corpo é obrigatório. Os limites estão na página de componentes do modelo:
- Cabeçalho (opcional): texto com até 60 caracteres e no máximo uma variável, ou mídia (imagem, vídeo ou documento, como um PDF). Há também o cabeçalho de localização, que mostra um mapa e só vale para utilidade ou marketing.
- Corpo (obrigatório): só texto, até 1.024 caracteres, com várias variáveis.
- Rodapé (opcional): só texto, até 60 caracteres.
- Botões (opcionais): até dez no total, sendo no máximo dois de URL, um de telefone e um de copiar código. Cada rótulo tem até 25 caracteres. Com mais de três botões, o cliente vê dois e o resto fica num botão de ver todas as opções.
As variáveis são os espaços preenchidos no envio, como nome ou número do pedido. Podem ser posicionais ({{1}}, {{2}}, em ordem, começando em 1) ou nomeadas, em minúsculas com sublinhado, como {{numero_pedido}}. Toda variável precisa de um valor de exemplo na criação, porque é assim que o revisor enxerga a mensagem pronta.
Mais três detalhes: o nome do modelo aceita só minúsculas, números e sublinhado; a Meta não traduz nada, então cada idioma é um modelo próprio e conta para o limite da conta (250 modelos em portfólio não verificado, até 6.000 em portfólio verificado com nome de exibição aprovado); e modelos parados há 12 meses ou mais são arquivados e excluídos 28 dias depois, se ninguém os desarquivar.
Como funciona a revisão e por que templates são reprovados?
Todo modelo novo ou editado passa por sistemas automáticos e revisão manual, e a decisão pode levar até 24 horas. Aprovado, ele aparece como “Ativo – Qualidade pendente” e já pode ser enviado. Reprovado, você edita e reenvia ou apela, sempre com amostras das variáveis.
A página de análise do modelo lista os motivos mais comuns de reprovação:
- Variáveis mal formatadas: chaves faltando, caracteres como
#,$ou%dentro da variável, ou numeração fora de ordem. - Variável demais para pouco texto: se a mensagem é quase só lacunas, o revisor não sabe o que ela diz.
- Começar ou terminar com variável: “
{{1}}, seu pedido saiu” é reprovado; “Oi,{{1}}! Seu pedido saiu.” passa. - Pedido de dados sensíveis: número completo de cartão, conta bancária ou documento, ou fotos de documentos que os contenham. Dados parciais, como os últimos quatro dígitos do CPF, são aceitos.
- Tom ameaçador: ameaçar com ação judicial ou exposição pública, algo a lembrar em mensagens de cobrança.
- Violação da Política Comercial ou da Política de Mensagens do WhatsApp.
- Duplicata: mesmo corpo e rodapé de um modelo existente (não vale para autenticação).
- Limite de caracteres estourado, inclusive de emojis no corpo.
Reprovação por categoria errada volta com o motivo INCORRECT_CATEGORY: dá para trocar a categoria e reenviar, criar outro modelo ou pedir análise.
Depois de aprovado, cuidado com as edições. Segundo a página de gerenciamento de modelos, um modelo aprovado pode ser editado até dez vezes em 30 dias, ou uma vez em 24 horas, e a categoria dele não pode ser editada. Se você excluir um modelo aprovado, o nome fica indisponível por 30 dias.
O que acontece depois da aprovação?
A Meta passa a acompanhar como as pessoas reagem a cada modelo, e isso afeta a entrega.
Qualidade. Cada modelo recebe uma classificação de qualidade baseada no uso, no retorno dos clientes e no engajamento, incluindo a taxa de leitura. No Gerenciador do WhatsApp, ela aparece como pendente, alta, média ou baixa.
Pausa. Na qualidade baixa, o modelo é pausado automaticamente: 3 horas na primeira vez, 6 horas na segunda e, na terceira, desabilitado. Pausado, não pode ser enviado. De início, o número não é afetado, mas insistir em modelos de baixa qualidade pode acabar atingindo o número.
Regularidade (pacing). Modelos novos de marketing, ou sem qualidade alta, podem sair em ritmo controlado: parte das mensagens é entregue e o resto fica retido até a Meta ter sinais de como o modelo foi recebido. Sinal bom libera tudo; sinal ruim descarta as retidas e pausa o modelo. A documentação de regularidade diz que a meta é entregar as campanhas em até uma hora em 99% dos casos. Em utilidade, isso só vale nos sete dias seguintes à pausa de algum modelo de utilidade da conta.
Limite de marketing por pessoa. O WhatsApp pode limitar quantos modelos de marketing uma pessoa recebe, com base, entre outros fatores, na taxa de leitura recente dela. A mensagem falha com o código 131049, e a Meta recomenda esperar ao menos 24 horas antes de tentar de novo.
Como escrever um template que passa na revisão e no cliente?
Escreva para quem vai receber, não para o revisor. As duas coisas quase sempre andam juntas:
- Uma mensagem, um objetivo. Aviso é aviso, oferta é oferta. Precisa das duas? Crie dois modelos.
- Diga logo quem é você e por que está escrevendo. A Meta recomenda evitar boas-vindas e apresentações vagas.
- Variável é para o que muda. Nome, pedido, data e valor são variáveis; a frase que explica o motivo é texto fixo.
- Dê exemplos realistas às variáveis. “Maria” e “4821” ajudam o revisor; “teste” atrapalha.
- Dê uma saída no marketing. A Meta cita o botão de resposta rápida para parar de receber ofertas como uso comum, e a política exige atender qualquer pedido de saída, feito dentro ou fora do WhatsApp.
- Use a biblioteca de modelos quando servir. Ela traz modelos de utilidade e autenticação já categorizados, como lembrete de pagamento e atualização de entrega. Personalizou o texto, volta para revisão.
- Mande menos, e melhor. A Meta pede para evitar muitas mensagens por dia; frequência alta vira bloqueio.
Exemplo prático
Imagine, como exemplo hipotético, uma ótica de bairro que precisa de três modelos. Os textos são exemplos para adaptar, não modelos oficiais, e a categoria final é sempre decidida pela Meta.
Utilidade: confirmação de pedido. Fala de uma transação específica e não oferece nada.
Cabeçalho: Pedido confirmado
Corpo: Oi, {{nome}}! Recebemos o seu pedido {{numero_pedido}} e o pagamento foi aprovado. Seus óculos ficam prontos até {{data_entrega}}, e a gente avisa por aqui quando puder retirar.
Rodapé: Ótica Exemplo · atendimento das 9h às 18h
Botão (URL): Ver meu pedido
Utilidade: lembrete de exame agendado. Informação sobre um serviço que o cliente marcou.
Corpo: Olá, {{nome}}. Lembrete do seu exame de vista marcado para {{data}}, às {{horario}}, na unidade {{unidade}}. Se precisar mudar o horário, é só tocar em um dos botões.
Botões (resposta rápida): Confirmar presença | Remarcar
Marketing: lançamento de coleção. Assumidamente promocional, só para quem aceitou receber ofertas, com saída clara.
Cabeçalho: imagem da vitrine nova
Corpo: Oi, {{nome}}! As armações da coleção de outono chegaram. Até {{data_fim}}, quem fizer o exame de vista com a gente ganha {{desconto}} de desconto na armação. Quer dar uma olhada?
Rodapé: Não quer mais receber ofertas? Toque em "Parar ofertas".
Botões: Ver a coleção (URL) | Parar ofertas (resposta rápida)
Autenticação: código de acesso. O texto é fixo e definido pela Meta, conforme a página de modelos de autenticação; você escolhe se inclui o aviso de segurança, o aviso de validade e o tipo de botão.
Corpo: 482913 é seu código de verificação. Para sua segurança, não compartilhe este código.
Rodapé: Este código expirará em 10 minutos.
Botão: Copiar código
E dois textos que a ótica não deveria mandar como utilidade: “Seus óculos estão prontos! Use o cupom VOLTA10 na próxima compra” (misto, vira marketing) e “{{1}}, temos novidades” (começa com variável e é vago).
Checklist antes de enviar
Passe por esta lista antes de submeter um modelo e antes de cada campanha:
- A mensagem precisa mesmo sair fora da janela? Se o cliente acabou de escrever, responda dentro dela.
- Cada pessoa da lista aceitou receber mensagens da sua empresa, e isso está registrado?
- Quem pediu para sair, por qualquer canal, foi retirado da lista?
- A categoria bate com o texto? Há oferta ou cupom escondido num aviso?
- As variáveis estão em ordem, sem caracteres especiais, com exemplos realistas, sem abrir nem fechar o texto?
- O texto pede algum dado sensível?
- Os limites foram respeitados: 60 caracteres no cabeçalho de texto e no rodapé, 1.024 no corpo, 25 nos botões?
- O marketing tem uma saída clara, e a frequência é razoável para essa base?
Os itens 2 e 3 são os que mais se perdem no dia a dia, e é onde vale ter o sistema conferindo por você. O Fieli Flow, em beta na API oficial do WhatsApp, faz esse tipo de checagem antes de cada envio: entre as nove conferências estão o consentimento registrado e o pedido de saída, e, na dúvida, a mensagem não sai.
Erros comuns
- Disfarçar promoção de aviso. Além da recategorização, a insistência leva a limites de volume e à perda dos modelos de utilidade por até 30 dias.
- Tratar a aprovação como definitiva. A categoria pode mudar e a qualidade pode pausar o modelo. Acompanhe os e-mails e o painel de modelos.
- Continuar disparando com o modelo pausado. A API rejeita os envios. Pare a campanha, entenda o motivo (texto, público ou frequência) e só então retome.
- Reenviar marketing em sequência para quem bateu no limite. Tentativas repetidas podem bloquear a entrega para essas pessoas por até 24 horas.
- Criar um modelo por detalhe. Modelos quase iguais podem ser reprovados como duplicata. Use variáveis para o que muda.
Perguntas frequentes
- Quanto tempo a Meta leva para aprovar um template?
- Segundo a documentação da Meta, a decisão pode levar até 24 horas. Se o modelo for reprovado, você pode editar e reenviar ou apelar, e a apelação também é decidida em até 24 horas.
- Posso trocar a categoria de um template já aprovado?
- Não diretamente: a Meta não permite editar a categoria de um modelo aprovado. Se você discorda da categoria que ela aplicou, pode pedir uma nova análise pelo Suporte para Empresas em até 60 dias ou criar outro modelo.
- Pesquisa de satisfação é utilidade ou marketing?
- É utilidade quando fala de um pedido ou atendimento específico e não tem nada de promocional. Pesquisa genérica não é aprovada como utilidade, e pesquisa com oferta embutida vira marketing.
- Quantas vezes posso editar um template aprovado?
- Em setembro de 2026, a Meta permite editar um modelo aprovado até dez vezes em 30 dias, ou uma vez em 24 horas. Modelos reprovados ou pausados podem ser editados sem limite, mas cada edição volta para a revisão.
- O que acontece quando um template é pausado?
- Enquanto estiver pausado, ele não pode ser enviado e a API rejeita as tentativas. A primeira pausa dura 3 horas, a segunda 6 horas e, na terceira vez, o modelo é desabilitado.
- Template aprovado dispensa o consentimento do cliente?
- Não. A aprovação diz respeito ao texto. A Política de Mensagens do WhatsApp Business continua exigindo que a pessoa tenha dado o número e aceitado receber mensagens da sua empresa.
Fontes
- Meta for Developers: Noções básicas sobre modelos (templates overview) (acesso em 26 de setembro de 2026)
- Meta for Developers: Componentes do modelo (acesso em 26 de setembro de 2026)
- Meta for Developers: Categorização de modelos (template categorization) (acesso em 26 de setembro de 2026)
- Meta for Developers: Análise do modelo (template review) (acesso em 26 de setembro de 2026)
- Meta for Developers: Gerenciamento de modelos (edição, exclusão e arquivamento) (acesso em 26 de setembro de 2026)
- Meta for Developers: Classificação de qualidade do modelo (acesso em 26 de setembro de 2026)
- Meta for Developers: Regularidade do modelo (template pacing) (acesso em 26 de setembro de 2026)
- Meta for Developers: Pausa no modelo (template pausing) (acesso em 26 de setembro de 2026)
- Meta for Developers: Limites de mensagens de modelo de marketing por usuário (acesso em 26 de setembro de 2026)
- Meta for Developers: Biblioteca de modelos (acesso em 26 de setembro de 2026)
- Meta for Developers: Modelos de autenticação (acesso em 26 de setembro de 2026)
- Meta for Developers: Mensagens de serviço: janela de atendimento e qualidade das mensagens (acesso em 26 de setembro de 2026)
- Meta for Developers: Preços na Plataforma do WhatsApp Business (acesso em 26 de setembro de 2026)
- WhatsApp: Política de Mensagens do WhatsApp Business (acesso em 26 de setembro de 2026)
Como este artigo foi feito
A pesquisa e o rascunho tiveram assistência de inteligência artificial. As afirmações foram checadas contra as fontes acima em 26 de setembro de 2026, e o texto foi revisado por Equipe Fieli em 26 de setembro de 2026. Por tratar de regras que mudam, este texto tem nova checagem prevista até 31 de dezembro de 2026. A capa é uma ilustração gerada com IA. Encontrou um erro? Escreva para contato@fieli.app.
A equipe que constrói o Fieli Posts, Flow, Tickets e Club, software para PMEs brasileiras acompanharem o cliente em cada etapa.


