Template WhatsApp aprovado: como criar e evitar rejeição

Um template de WhatsApp aprovado é uma mensagem com texto fixo, revisada e liberada pela Meta antes de você usá-la. Ele é a única forma de iniciar conversa pela API oficial fora da janela de 24 horas, e por isso é o primeiro obstáculo real de quem conecta um número. A aprovação depende de três coisas: a categoria certa, um texto que faça sentido com as variáveis preenchidas e nada que a política da Meta proíba. O resto deste guia mostra como acertar cada uma delas, o que fazer quando a Meta rejeita e o que acontece com o template depois de aprovado.

O que é um template e por que ele precisa de aprovação

No WhatsApp Business comum, do celular, você escreve o que quiser para quem quiser. Na API oficial, a regra é outra, e ela é da Meta, não do provedor. Uma empresa só pode mandar mensagem livre para uma pessoa dentro da janela de 24 horas, que abre quando essa pessoa escreve primeiro. Passou disso, a única mensagem que sai é um template pré-aprovado. Mensagem livre fora da janela nem chega a ser enviada: a Meta recusa com o código 131047.

O motivo é simples. Quem começa a conversa é a empresa, e a pessoa do outro lado não pediu nada naquele momento. A Meta revisa o texto antes para garantir que ele diz o que a categoria promete, que não é golpe e que não viola a política de mensagens. É o que mantém o WhatsApp sem spam, e é o que protege o seu número: quem recebe uma mensagem clara bloqueia menos, e bloqueio é o que derruba a qualidade.

Todo envio em massa pela API oficial usa template, porque a lista inteira está fora da janela. Uma campanha para 500 pessoas é um template aprovado enviado 500 vezes, cada vez com as variáveis daquele contato.

Anatomia de um template: cabeçalho, corpo, rodapé, botões e variáveis

Um template tem até quatro partes, e só uma é obrigatória.

• Cabeçalho (opcional): uma linha curta em negrito, de até 60 caracteres, ou uma mídia. Pode ter uma variável.
• Corpo (obrigatório): o texto principal, de até 1.024 caracteres. É aqui que entram as variáveis.
• Rodapé (opcional): uma linha pequena e cinza, de até 60 caracteres, sem variáveis. Serve para assinatura ou para o aviso de como parar de receber.
• Botões (opcionais): de resposta rápida ou de link. Falamos deles numa seção própria.

As variáveis são as chaves numeradas no texto: {{1}}, {{2}}, {{3}}. Na hora do envio, cada uma é trocada pelo dado daquela pessoa: o nome, o número do pedido, a data da consulta. Três regras que valem para todas:

1. A numeração é sequencial e começa em 1. Um corpo com {{1}} e {{3}}, sem {{2}}, é recusado.
2. Toda variável precisa de um exemplo na hora de criar. A Meta revisa o texto com os exemplos preenchidos; sem eles não há como saber se "Olá {{1}}" vai virar "Olá Marina" ou "Olá clique aqui".
3. A variável não substitui o texto. Um corpo que é quase só variáveis, ou que começa e termina com uma, costuma ser rejeitado, porque a Meta não consegue avaliar o que a mensagem diz.

O nome do template também tem regra: letras minúsculas, números e sublinhado, como confirmacao_pedido ou lembrete_consulta_v2. E cada template é criado em um idioma. Um template pt_BR aprovado não serve para enviar em en_US; o envio no idioma errado falha com o código 132001.

Qual categoria escolher: marketing, utilidade ou autenticação?

A categoria é a decisão mais importante, por dois motivos. Ela define o que a Meta espera encontrar no texto, e define quanto a Meta cobra por mensagem entregue.

Os valores estão na tabela publicada pela Meta em setembro de 2026. Confira o rate card oficial antes de fazer conta, e lembre que a cobrança é sempre da Meta, direta para você. O Frame Conexa não cobra por mensagem.

A tentação clássica é criar um template de utilidade com um pedaço de promoção dentro, para pagar menos. Não funciona. A Meta lê o texto e, quando ele não bate com a categoria declarada, faz uma de duas coisas: rejeita, ou reclassifica o template como marketing e aprova assim. No Frame Conexa a criação já pede à Meta que ajuste a categoria em vez de rejeitar, então o resultado mais comum é um template aprovado como marketing quando você achava que era utilidade. Isso aparece no painel, e vale conferir antes do primeiro envio.

Uma consequência que poucos consideram: template de marketing entregue conta no limite por pessoa da Meta, que soma todas as empresas que falam com aquele usuário. Quem já recebeu marketing demais nas últimas horas não recebe o seu, e o envio falha com 131049. Utilidade e autenticação não entram nessa conta. É mais um motivo para não disfarçar utilidade de marketing, nem o contrário.

Por que a Meta rejeita templates? Motivos comuns e correções

A rejeição chega com um motivo curto, que o painel mostra ao lado do template. Os casos que mais aparecem na prática são estes.

Formato inválido. Variável fora de sequência, variável sem exemplo, texto cheio de espaços ou quebras de linha em excesso, corpo que começa e termina com variável. Correção: numere de 1 em diante, dê um exemplo realista para cada uma e escreva texto de verdade em volta.

Conteúdo não bate com a categoria. "Seu pedido foi enviado. Aproveite 20% de desconto na próxima compra" declarado como utilidade. Correção: tire a oferta, ou aceite a categoria de marketing.

Texto vago ou que parece golpe. "Clique no link para resolver sua pendência" sem dizer qual pendência nem quem é a empresa. Correção: diga quem está falando, o que aconteceu e o que a pessoa deve fazer, com o nome da empresa no texto ou no rodapé.

Link encurtado ou link genérico. Encurtadores escondem o destino, e a Meta trata isso como risco. Correção: use o domínio da sua empresa no botão de link, com a parte variável só no final da URL.

Conteúdo proibido pela política. Produtos e serviços que a política de comércio da Meta não permite anunciar pelo WhatsApp. Aqui não há correção de texto; é o tipo de negócio que não cabe na plataforma.

Duplicado. Um template com o mesmo nome e idioma de outro que já existe na conta. Correção: apague o antigo ou mude o nome.

Dica: antes de enviar para análise, leia o template com os exemplos preenchidos, como a pessoa vai ler. Se uma frase só faz sentido para quem conhece a sua empresa por dentro, reescreva. É esse texto, e não o seu template com chaves, que a Meta avalia.

Rejeitado não é o fim. O template pode ser editado e reenviado para análise, e a edição volta para o estado pendente. Quando o motivo não fica claro, a saída mais rápida costuma ser criar um novo com o texto revisado, em vez de disputar a decisão.

12 exemplos de template que costumam ser aprovados

Os textos abaixo seguem as regras da seção anterior: variáveis com texto em volta, categoria coerente com o conteúdo e a empresa identificada. Use-os como ponto de partida, não como garantia: a decisão final é sempre da Meta, e o mesmo texto pode ser aprovado numa conta e reclassificado em outra.

Loja: confirmação de pedido, carrinho e promoção

1. Confirmação de pedido (utilidade): "Olá {{1}}, recebemos seu pedido {{2}} na Loja Alfa. A previsão de envio é de até {{3}} dias úteis. Se precisar de algo, é só responder por aqui." Botão de link: Acompanhar pedido.
2. Pedido pronto para retirada (utilidade): "{{1}}, seu pedido {{2}} já está disponível para retirada na Loja Alfa, de segunda a sábado, das 9h às 18h. Ele fica reservado por 5 dias."
3. Carrinho abandonado (marketing): "Oi {{1}}, os itens que você separou na Loja Alfa ainda estão no seu carrinho. Reservamos por mais 24 horas." Botão de link: Ver meu carrinho.
4. Promoção da semana (marketing): "{{1}}, esta semana a Loja Alfa está com {{2}} de desconto em {{3}}. Vale até domingo, enquanto durar o estoque." Botões de resposta rápida: Quero ver e Não tenho interesse.

Clínica e escola: lembrete de consulta, aviso e cobrança

5. Lembrete de consulta (utilidade): "Olá {{1}}, lembrando sua consulta na Clínica Beta com {{2}}, no dia {{3}} às {{4}}. Você confirma?" Botões de resposta rápida: Confirmar e Remarcar.
6. Resultado disponível (utilidade): "{{1}}, o resultado do seu exame {{2}} já está disponível na Clínica Beta. Você pode retirar na recepção ou acessar pelo link." Botão de link: Acessar resultado.
7. Reunião de pais (utilidade): "Prezado responsável por {{1}}, a reunião de pais da turma {{2}} da Escola Gama será no dia {{3}} às {{4}}. Contamos com a sua presença."
8. Rematrícula aberta (marketing): "Olá {{1}}, as rematrículas da Escola Gama para 2027 estão abertas até {{2}}, com condição especial para quem renovar antes do prazo." Botão de link: Ver condições.

Repare no par 7 e 8. Os dois são da escola, para o mesmo público. O primeiro dá uma informação sobre algo que já existe entre a escola e a família: é utilidade. O segundo convida a comprar de novo, com um benefício: é marketing. O que separa as categorias é a intenção da mensagem, não quem envia.

Infoprodutor: aula ao vivo, oferta e reengajamento

9. Acesso liberado (utilidade): "{{1}}, seu acesso ao curso {{2}} está liberado. Entre com o e-mail {{3}} na área de alunos." Botão de link: Entrar na área de alunos.
10. Aula ao vivo começa em 1 hora (utilidade): "{{1}}, a aula {{2}} do curso em que você se inscreveu começa às {{3}}. O link de acesso é o mesmo da área de alunos." Vale como utilidade porque a pessoa se inscreveu na aula. Se o texto convidar a comprar algo, vira marketing.
11. Carrinho aberto (marketing): "{{1}}, as inscrições para {{2}} abrem hoje e ficam abertas até {{3}}. Quem entrou na lista de espera tem prioridade." Botão de link: Garantir minha vaga.
12. Reengajamento (marketing): "Oi {{1}}, faz um tempo que você não aparece por aqui. Preparamos um conteúdo novo sobre {{2}} que pode te interessar. Quer receber?" Botões de resposta rápida: Quero receber e Parar de receber.

O botão "Parar de receber" do último exemplo não é enfeite. Quem responde com ele está pedindo para sair, e a política da Meta exige respeitar o pedido. No Frame Conexa, quem responde escrevendo "sair", "parar", "stop", "cancelar", "descadastrar" ou "remover" é suprimido das próximas campanhas automaticamente, assim como quem bloqueia mensagens de marketing no próprio WhatsApp. O toque no botão chega como clique no relatório da campanha, e dali você monta um público com essas pessoas para excluí-las dos próximos envios.

Botões: resposta rápida ou link, e como o clique aparece no relatório

Dois tipos de botão passam pela aprovação da Meta, e eles se comportam de forma diferente depois que a mensagem é entregue.

O botão de resposta rápida manda uma mensagem de volta para você com o texto do botão. Quando a pessoa toca em "Confirmar", chega uma mensagem "Confirmar" na conversa, e isso abre a janela de 24 horas: você pode responder livremente. É o botão certo para tudo que pede uma decisão da pessoa.

O botão de link abre uma URL no navegador do celular. Nada volta para o WhatsApp. É o botão certo para levar a um pedido, a um carrinho ou a uma página de vendas. A URL pode ter uma variável no final, para levar cada pessoa ao seu próprio pedido, e a Meta pede um exemplo completo dela.

Essa diferença define o que dá para medir. No relatório de campanha do Frame Conexa, o clique em botão de resposta rápida é contado por pessoa e por botão, e a atribuição é feita pelo identificador da mensagem que a pessoa respondeu, nunca pelo telefone. O telefone parece o caminho óbvio, mas no Brasil o número volta da Meta às vezes sem o nono dígito, e casar por telefone erraria metade da base. Já o botão de link não gera nenhum evento no WhatsApp, e por isso o relatório não mostra número ao lado dele. Um "0" ali afirmaria que ninguém abriu o link, o que não é verdade: só não há como saber.

Nota: se a taxa de clique importa, prefira o botão de resposta rápida e leve a pessoa ao link na mensagem seguinte, dentro da janela que o clique acabou de abrir. Você mede o clique e ainda ganha uma conversa aberta.

Depois de aprovado: qualidade do template e pausa automática

Aprovação não é permanente. Cada template tem uma qualidade própria, calculada pela Meta a partir de como as pessoas reagem a ele: bloqueios, denúncias e a taxa de leitura. Ela começa como desconhecida, passa a verde, amarela ou vermelha conforme o uso, e você acompanha no WhatsApp Manager e no painel.

3 horas, 6 horas, desativado: a escada da Meta

Quando a qualidade de um template chega ao vermelho, a Meta o pausa sozinha. Segundo a página oficial sobre pausa de templates, a escada é esta:

Template pausado não sai. A API recusa o envio, e o Frame Conexa nem tenta: o estado do template é atualizado pelo aviso que a própria Meta manda a cada mudança, e um template que não consta como aprovado é barrado antes da chamada. O aviso chega também por e-mail e no WhatsApp Manager. A pausa pode ser desfeita à mão no WhatsApp Manager, mas desfazer sem mudar nada tende a repetir o resultado. O caminho que funciona é revisar o texto, o público ou os dois, e criar um template novo.

A pausa é do template, não do número, e não muda a capacidade de envio na hora. Mas a Meta avisa, na mesma página, que quem insiste em mandar templates que chegam à qualidade baixa pode ver o número afetado. Como a capacidade do número e a qualidade andam juntas, um template ruim que fica no ar é o jeito mais barato de piorar tudo que vem depois.

Três hábitos evitam a escada: enviar só para quem deu permissão, oferecer uma forma clara de parar de receber e nunca reenviar a mesma mensagem para quem não respondeu à primeira. Os erros que a Meta devolve num disparo, como 131026 e 131049, estão explicados um a um no dicionário de erros da API.

Como criar no Frame Conexa e pela API

No painel, a tela Templates lista tudo que existe na sua conta da Meta, com o estado de cada um: pendente, aprovado, rejeitado com o motivo, pausado. Criar é preencher categoria, idioma, cabeçalho, corpo com os exemplos de cada variável, rodapé e botões. O template nasce pendente e passa a aprovado quando a Meta decide. Não há prazo oficial: em geral leva de minutos a algumas horas, mas pode levar mais, e nenhum provedor consegue acelerar isso.

Criar e editar template exige um número de marketing. É uma decisão comercial nossa, não uma regra da Meta: o número de atendimento envia templates de utilidade e autenticação já aprovados, e só o de marketing cria templates e envia os de marketing. A diferença entre os dois está na página de planos.

Pela API, a criação é uma chamada. O token fc_ é gerado em Configurações, na aba API, e o id da instância vem de GET /api/v1/instances, como no guia de primeira mensagem.

curl -X POST https://frameconexa.com/api/v1/instances/$FRAME_CONEXA_INSTANCE_ID/templates \
  -H "Authorization: Bearer fc_SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "confirmacao_pedido",
    "category": "UTILITY",
    "language": "pt_BR",
    "body": "Olá {{1}}, recebemos seu pedido {{2}} na Loja Alfa. A previsão de envio é de até {{3}} dias úteis.",
    "bodyExamples": ["Marina", "7842", "3"],
    "footer": "Loja Alfa",
    "buttons": [
      { "type": "URL", "text": "Acompanhar pedido", "url": "https://loja.example/pedido/{{1}}", "urlExample": "https://loja.example/pedido/7842" }
    ],
    "allowCategoryChange": true
  }'

A resposta traz o id que a Meta atribuiu, o estado inicial e a categoria em que o template entrou em análise:

{
  "ok": true,
  "template": { "id": "1122334455", "status": "PENDING", "category": "UTILITY" }
}

Um 403 nessa rota significa que a instância não é de marketing. Um 400 quase sempre é variável sem exemplo ou nome fora do padrão, e o corpo diz qual. Os campos completos estão na referência de criação de template. Listar, editar e excluir seguem o mesmo caminho, e a exclusão remove só o idioma indicado, preservando os outros.

Próximo passo

Quem tem um número de marketing cria templates pelo painel ou pela API e acompanha a aprovação sem sair da tela. Veja os planos por número e, se preferir começar pelo código, a referência de criação de template tem todos os campos.