guia 10 min de leitura

Como criar um template no WhatsApp

Passo a passo para selecionar a conta WhatsApp, montar o template no painel e enviar para aprovação da Meta.

Módulo: templates
vg tech templates whatsapp meta criacao

Para que serve

O template é a mensagem estruturada que a sua conta usa para envio oficial no WhatsApp.

Na prática, ele é a base para:

  • campanhas em massa;
  • envio unitário com mensagem oficial;
  • comunicações padronizadas da operação.

Sem template criado e aprovado, o fluxo de campanha fica travado ou incompleto.

Antes de começar

Antes de abrir o módulo Templates, confirme estes pontos:

  • você já está logado no painel;
  • existe pelo menos uma Conta WhatsApp conectada;
  • você vai criar o template na conta certa;
  • você já sabe se a mensagem é de Utilidade ou Marketing.
O que existe hoje no módulo

No frontend validado hoje, o topo do módulo mostra:

  • campo Conta WhatsApp;
  • botão Criar template;
  • botão Sincronizar da Meta;
  • botão de atualização;
  • aviso: Selecione uma conta para sincronizar e criar templates.

Isso significa que o fluxo certo começa por escolher a conta. Não é para abrir a criação “solta”.

---

Passo a passo visual

Passo 1 — Abrir Templates e selecionar a Conta WhatsApp

O que fazer agora: no módulo Templates, escolha a Conta WhatsApp no seletor do topo.

O campo validado no código aparece como:

  • Conta WhatsApp
  • opção inicial: Selecione uma conta...

#### Por que isso vem primeiro

O próprio módulo bloqueia a criação enquanto nenhuma conta é escolhida. O botão Criar template começa desabilitado até essa seleção acontecer.

#### Anti-erro deste passo

Evite:

  • tentar criar template sem escolher a conta;
  • escolher a conta errada e só perceber depois;
  • confundir conta WhatsApp com apenas nome interno da empresa.

Como saber que deu certo:

  • a conta fica selecionada no topo;
  • o botão Criar template deixa de estar bloqueado.

Captura visual: topo do módulo com Conta WhatsApp e botão Criar template.

Tela Templates
Tela Templates

---

Passo 2 — Se quiser, sincronizar antes com a Meta

O que fazer agora: se precisar atualizar a lista atual da conta, use Sincronizar da Meta antes de criar um modelo novo.

Esse botão existe no topo com o texto:

  • Sincronizar da Meta

Ele é útil para:

  • puxar os templates atuais da conta;
  • conferir o que já existe;
  • evitar criar algo duplicado por falta de atualização da tela.

#### Anti-erro deste passo

Evite criar no escuro quando:

  • você não sabe se o template já existe;
  • outra pessoa pode já ter criado algo parecido;
  • você quer revisar os aprovados, pendentes e rejeitados antes.

Como saber que deu certo:

  • a grade do módulo carrega os templates da conta;
  • a tela passa a refletir melhor o estado atual vindo da Meta.

Captura visual: botão Sincronizar da Meta e listagem carregada.

Conta WhatsApp e ações do topo
Conta WhatsApp e ações do topo

---

Passo 3 — Clicar em Criar template

O que fazer agora: com a conta selecionada, clique em Criar template.

Ao abrir o modal, o sistema mostra o título:

  • Criar template

E exibe uma barra de começo rápido com estas opções reais:

  • Do zero
  • Sugestão pronta
  • Gerar com IA

#### Como escolher a melhor forma de começar

Use assim:

  • Do zero: quando você já sabe exatamente o texto;
  • Sugestão pronta: quando quer partir de um modelo-base mais rápido;
  • Gerar com IA: quando quer ajuda para montar opções iniciais.

#### Anti-erro deste passo

Evite:

  • abrir o modal sem saber qual conta está ativa;
  • começar por IA sem antes saber o objetivo do template;
  • tratar sugestão pronta como texto final sem revisão.

Captura visual: modal Criar template com Do zero, Sugestão pronta e Gerar com IA.

Criar template
Criar template

---

Passo 4 — Preencher o Texto principal

O que fazer agora: escreva o conteúdo principal no campo Texto principal.

O formulário traz o bloco:

  • 1. Conteúdo principal
  • campo Texto principal

Esse é o núcleo do template.

#### Regra prática para começar bem

Antes de escrever, decida se a mensagem é:

  • aviso operacional;
  • confirmação;
  • atualização de serviço;
  • marketing/oferta.

Isso evita texto ambíguo e ajuda a escolher a categoria certa depois.

#### O módulo já ajuda nessa etapa

O frontend possui área de validação em tempo real e tratamento de erros de conteúdo, categoria, variável, link curto e outros riscos comuns.

#### Anti-erro deste passo

Evite:

  • escrever texto genérico sem objetivo;
  • misturar mensagem operacional com tom promocional sem necessidade;
  • começar a preencher sem saber qual uso real o template terá.

Captura visual: bloco Texto principal e alertas de validação.

Formulário do template
Formulário do template

---

Passo 5 — Escolher a Categoria correta

O que fazer agora: defina a categoria na Meta como Utilidade ou Marketing.

O formulário traz o bloco:

  • 2. Categoria
  • Utilidade
  • Marketing

Também existe uma dica contextual no próprio módulo:

  • Utilidade: atualizações de pedido, conta ou serviço já contratado;
  • Marketing: promoções e ofertas.

#### Regra prática

Use esta lógica simples:

  • Utilidade quando a mensagem informa, confirma ou atualiza algo ligado a serviço/relacionamento já existente;
  • Marketing quando a mensagem promove oferta, campanha ou ação comercial ativa.

#### Anti-erro deste passo

Evite:

  • marcar utilidade para mensagem com cara de oferta;
  • marcar marketing quando o objetivo real é aviso operacional;
  • escolher categoria só “para tentar passar”.

Captura visual: bloco Categoria com Utilidade e Marketing.

Categoria do template
Categoria do template

---

Passo 6 — Definir o Prazo de entrega

O que fazer agora: escolha o prazo em que a Meta ainda pode tentar entregar a mensagem se o cliente estiver offline.

No formulário existe o bloco:

  • 3. Prazo de entrega

E os atalhos reais:

  • 12 horas
  • 24 horas
  • 30 dias
  • além de outras durações no seletor complementar.

#### Como pensar nisso

Esse campo não é o “agendamento da campanha”. Ele orienta até quando a Meta pode insistir na entrega do template.

#### Anti-erro deste passo

Evite:

  • preencher sem entender o impacto operacional;
  • tratar prazo curto como padrão universal;
  • esquecer que uma mensagem promocional e um aviso operacional podem ter necessidades diferentes.

Captura visual: bloco Prazo de entrega.

Prazo de entrega
Prazo de entrega

---

Passo 7 — Configurar Topo, idioma e rodapé

O que fazer agora: se precisar, ajuste o bloco 4. Topo, idioma e rodapé.

No módulo foram encontrados estes tipos de topo:

  • Sem topo
  • Texto
  • Foto
  • Vídeo
  • PDF

Também existem os campos:

  • Idioma
  • Rodapé

#### Quando usar topo

Use topo quando ele realmente ajuda a mensagem:

  • Texto para reforço curto;
  • Foto para contexto visual;
  • Vídeo quando faz sentido operacional/comercial;
  • PDF quando existe documento real para anexar.

#### Regra importante da mídia

O módulo aceita upload de arquivo e mostra orientação técnica. Em templates com mídia, o material precisa estar adequado para a Meta processar o envio.

#### Anti-erro deste passo

Evite:

  • colocar topo só por enfeite;
  • usar mídia sem necessidade;
  • esquecer de revisar idioma e rodapé.

Captura visual: bloco Topo, idioma e rodapé.

Topo, idioma e rodapé
Topo, idioma e rodapé

---

Passo 8 — Adicionar Botões se fizer sentido

O que fazer agora: se a mensagem precisar de ação, configure os botões no bloco 5. Botões (opcional).

O módulo mostra dois grupos principais:

  • Links para site
  • Respostas rápidas

E os CTAs:

  • Adicionar link
  • Adicionar resposta

O próprio texto do módulo informa:

  • até 2 links;
  • até 3 respostas rápidas;
  • links devem usar URL completa, sem encurtador.

#### Quando usar cada um

  • Link para site: quando a ação principal é abrir página externa;
  • Resposta rápida: quando você quer que o cliente responda com um toque.

#### Anti-erro deste passo

Evite:

  • colocar botão sem objetivo claro;
  • usar link encurtado;
  • poluir o template com botões demais.

Captura visual: bloco Botões com Adicionar link e Adicionar resposta.

Formulário com seções do template
Formulário com seções do template

---

Passo 9 — Conferir a Prévia WhatsApp

O que fazer agora: antes de enviar, revise a Prévia WhatsApp no lado do modal.

O módulo possui um painel de prévia visual para ajudar a revisar:

  • estrutura da mensagem;
  • hierarquia do conteúdo;
  • topo;
  • botões;
  • leitura geral.

#### O que revisar nessa hora

Confirme:

  • se o texto faz sentido do começo ao fim;
  • se a categoria bate com a mensagem;
  • se o topo não atrapalha;
  • se os botões ajudam em vez de confundir.

Captura visual: painel Prévia WhatsApp.

Prévia WhatsApp
Prévia WhatsApp

---

Passo 10 — Enviar para aprovação

O que fazer agora: se estiver tudo certo, clique em Enviar para a Meta.

O CTA final encontrado no formulário é:

  • Enviar para a Meta

Esse é o ponto em que o template sai do rascunho local e entra no fluxo de aprovação.

#### Como saber que deu certo

Depois do envio, o template tende a entrar na listagem da conta e seguir um estado como:

  • aprovado;
  • pendente;
  • rejeitado.

O próprio módulo também foi preparado para trabalhar com leitura desses status.

#### Anti-erro deste passo

Evite:

  • enviar sem revisar a categoria;
  • enviar texto improvisado demais;
  • tratar rejeição como erro do painel antes de revisar o conteúdo e a conta certa.

Captura visual: botão Enviar para a Meta e estado do template na listagem.

Enviar para a Meta
Enviar para a Meta

---

Ordem curta para criar template sem se perder

Se quiser o caminho resumido:

  1. abrir Templates;
  2. escolher Conta WhatsApp;
  3. usar Sincronizar da Meta se precisar revisar o que já existe;
  4. clicar em Criar template;
  5. escolher Do zero, Sugestão pronta ou Gerar com IA;
  6. preencher Texto principal;
  7. definir Categoria;
  8. ajustar Prazo de entrega;
  9. revisar Topo, idioma, rodapé e botões;
  10. conferir a Prévia WhatsApp;
  11. clicar em Enviar para a Meta.

---

Erros mais comuns

Criar template sem selecionar a conta

O módulo já avisa isso no topo. Sem conta selecionada, o fluxo não é o correto.

Pular categoria ou escolher só no chute

Categoria errada aumenta a chance de rejeição ou de confusão operacional depois.

Querer campanha antes de template aprovado

No fluxo real do sistema, Templates vem antes de Campanhas.

Exagerar em topo e botões

Mais recurso não significa melhor template. Se não ajuda a mensagem, atrapalha.

---

Relação com o onboarding principal

Este manual complementa o onboarding geral salvo em:

`/opt/vg-ai/content/help/drafts/como-comecar-na-plataforma-vg-tech.md`

Dentro do fluxo completo, a etapa de Templates entra depois de Listas e antes de Campanhas.

Template aprovado em Campanhas
Template aprovado em Campanhas

---

Base técnica validada neste rascunho

Este material foi montado a partir da leitura real destes arquivos:

  • `frontend/templates.html`
  • `frontend/js/templates.js`
  • `frontend/campanhas.html`

---

Status deste material

Rascunho validado no código e com screenshots reais do painel.

O texto já está ancorado no módulo real. Antes da publicação final, ainda faltam apenas:

  • revisão visual 1:1 final;
  • aprovação da prévia;
  • publicação em `published/`.