API Oficial do WhatsApp

Como criar um template do zero

O template é o modelo de mensagem que a Meta aprova antes de você enviar. Sem ele, a API Oficial não deixa você falar com quem ainda não te chamou. O vídeo abaixo mostra a criação de dois templates, do começo ao fim: um simples e um com variável e botões.

Tutorial completo · aproximadamente 2 minutos

Por que a Meta exige isso

Na API Oficial você só escreve mensagem livre para quem falou com você nas últimas 24 horas. Fora dessa janela — ou para quem nunca te chamou — o envio precisa sair de um template já analisado pela Meta. É exatamente isso que protege o seu número: como o conteúdo foi aprovado antes, você não é punido por volume.

Cada template tem uma categoria, e é ela que define o preço cobrado pela Meta: Marketing (promoções, novidades, ofertas) custa mais que Utilidade (confirmações, avisos, cobranças, atualizações de pedido).

Simular o custo do seu envio →

O passo a passo

1

Abra Configuração → Integrações Meta

Você cai na tela Contas META. No topo, escolha a aba Templates e depois Templates WABA. Ali existem duas visões: Lista de Templates (o que você já tem) e Criar Template.
2

Selecione a Conexão WABA

É o número oficial que vai enviar. Ao escolher a conexão, o campo App ID é preenchido sozinho — você não precisa digitar nada ali.
3

Dê um nome ao template

O nome é interno, serve para você achar o template depois. Só aceita letras minúsculas, números e underscore — nada de espaço, acento ou maiúscula. Prefira algo que descreva a mensagem: ola_tudo_bem, vamos_dar_andamento_no_seu_atendimento.
4

Escolha o idioma e a categoria

Idioma normalmente é Português (BR) — e um template vale para um idioma só. Em Categoria, marque Marketing se a mensagem oferece, divulga ou promove, e Utilidade se ela informa, confirma ou dá andamento em algo que o cliente já começou. Essa escolha muda o preço e o rigor da análise.
5

Monte os componentes da mensagem

No bloco Componentes há um seletor com Cabeçalho, Corpo, Rodapé e Botões: você escolhe a peça e clica em Adicionar Componente. O Corpo é o único obrigatório — é o texto principal, com até 1024 caracteres, e aceita *negrito* e _itálico_. Do lado direito, a Prévia mostra em tempo real como a mensagem vai chegar no celular do cliente.
6

Use variáveis quando a mensagem for personalizada

Escreva {{1}} no lugar do que muda de pessoa para pessoa — o nome, o produto, a data. Na hora do envio você preenche cada variável. No vídeo, o corpo ficou Olá, {{1}}, vamos dar andamento no seu atendimento?. Precisa de mais de uma? Use {{2}}, {{3}}, sempre em ordem.
7

Adicione botões, se fizer sentido

Escolha Botões no seletor de componentes, clique em Adicionar Componente e depois em Adicionar Botão. Em Resposta Rápida, o texto que você digitar vira o botão que o cliente toca — no vídeo foram dois: Sim e Não. Eles aparecem na prévia na hora, e facilitam muito a resposta de quem recebe.
8

Clique em Criar Template

Aparece o aviso “Template criado com sucesso!” e o sistema te devolve para a Lista de Templates.
9

Aguarde a aprovação da Meta

O template nasce com o status PENDING (pendente). Quando a Meta analisar, ele passa a APPROVED — e só a partir daí ele aparece para ser usado em campanha ou envio em massa. Na lista você vê o nome, o idioma, o ID, a categoria e uma prévia do texto, além dos filtros por status, categoria e idioma para achar rápido quando tiver muitos.

As peças de um template

Corpo — obrigatório

O texto da mensagem, até 1024 caracteres. É a única peça que todo template precisa ter.

Variáveis — o que muda por pessoa

{{1}}, {{2}}… são preenchidas no momento do envio. Um template com variável serve para milhares de contatos sem parecer mensagem em massa.

Botões — resposta em um toque

Na Resposta Rápida, o cliente toca em vez de digitar. Aumenta muito a taxa de resposta em confirmação, agendamento e pesquisa.

Cabeçalho e rodapé — opcionais

O cabeçalho destaca um título no alto da mensagem; o rodapé é aquela linha pequena no fim. Nenhum dos dois é obrigatório — comece só pelo corpo.

O que evita reprovação

Escolha a categoria certa

Texto de oferta cadastrado como Utilidade para pagar menos é o erro mais comum — e a Meta recusa ou reclassifica. Na dúvida entre informar e oferecer, é Marketing.

Não deixe a variável solta

Evite começar ou terminar o texto com {{1}}, e nunca deixe o corpo só com variáveis. A Meta precisa entender a mensagem lendo o modelo.

Crie antes de precisar

A análise costuma ser rápida, mas não é instantânea. Deixar para criar o template no dia da campanha é pedir para atrasar o disparo.

Template aprovado não vira outro texto

O que muda no envio são as variáveis, não a mensagem. Precisa de um texto diferente? É um template novo, com nome novo, passando pela análise de novo.

Um atalho na tela de criação

No canto superior direito da tela de Criar Template existem os botões Assistente IA e Gerar com IA. Se travar na hora de escrever, eles ajudam a montar o texto — e você ajusta o que quiser antes de enviar para a análise.

Template aprovado. E agora?

Para muita gente de uma vez

Use o template em uma campanha ou no envio em massa.

Ver o tutorial de disparo →
Para reabrir uma conversa

Passou das 24 horas desde a última mensagem do cliente? O template é o único jeito de voltar a falar com ele — inclusive nos follow-ups automáticos.

Ficou alguma dúvida?

A equipe da GeniosWeb monta o seu primeiro template junto com você e acompanha até a aprovação da Meta.