1. Wiki
  2. Recursos

Templates de WhatsApp: criar, sincronizar e usar

Crie templates de WhatsApp na BIP, sincronize os da Meta e ligue cada variável a um campo do contato para mandar mensagens personalizadas.

Resposta rápida

Na aba Templates da tela WhatsApp, crie um template com cabeçalho de texto, corpo com variáveis, rodapé e botões, ou sincronize os que já estão na Meta, inclusive com imagem, vídeo ou documento. Depois de aprovado, escolha o template na campanha e ligue cada variável a um campo do contato.

EsforçoSem códigoCanalWhatsAppPlanoLite (pago)

Todo WhatsApp que a BIP envia parte de um template aprovado pela Meta. Aqui você monta os seus, acompanha a aprovação e personaliza cada mensagem com o nome, o cupom ou o curso de interesse de cada contato.

O que você precisa

  • O WhatsApp conectado à BIP (veja o guia Conectar o WhatsApp Business à BIP)
  • Os campos personalizados que vão preencher as variáveis, como Cupom, criados em Configurações
  • O texto da mensagem e um valor de exemplo para cada variável
  • Para cabeçalho com imagem, vídeo ou documento: acesso ao Gerenciador do WhatsApp da Meta

O que você vai conseguir

  • Templates prontos para campanha, criados sem sair da BIP e enviados direto para a aprovação da Meta.
  • Mensagens personalizadas: nome, cupom ou qualquer campo do contato no corpo, no cabeçalho e nos botões.
  • Os templates que você já tem na Meta, inclusive com imagem, vídeo ou documento, trazidos em um clique.
  • Status de aprovação e motivo de rejeição atualizados sozinhos.
  • Vários templates criados de uma vez, a partir de um JSON.

Como funciona

  1. 1Crie o template na BIP ou sincronize os que já estão na Meta
  2. 2Aguarde a aprovação: o status muda sozinho para Aprovado
  3. 3Na campanha, ligue cada variável a um campo do contato

Um template tem até quatro partes: Cabeçalho, Corpo, Rodapé e Botões. As partes que mudam de pessoa para pessoa são as variáveis:

  • no corpo, as variáveis são {{1}}, {{2}}, {{3}} e assim por diante, em ordem;
  • o cabeçalho de texto e cada botão de URL têm numeração própria e aceitam uma variável só, sempre {{1}}. O {{1}} do cabeçalho é outro valor, diferente do {{1}} do corpo;
  • na aprovação, a Meta vê os valores de exemplo; no envio, cada contato recebe os dados dele, conforme o mapeamento que você faz na campanha.

Passo a passo

1. Abra a aba Templates

  1. No menu, clique em WhatsApp e abra a aba Templates.
  2. Em Todos os templates, cada linha mostra o nome, o idioma, a categoria, o status e o começo do corpo.
  3. Filtre por Todas as categorias (Marketing ou Utilidade) e por Todos os status.
  4. Clique num template para ver a prévia ao lado, como a mensagem aparece no celular.
dash.bip.marketing/…/whatsapp?tab=templates
Aba Templates com a lista de templates, os filtros e a prévia de um template

Captura de tela em breve

Aba Templates com a lista de templates, os filtros e a prévia de um template

2. Crie o template e defina a identidade

  1. Clique em Criar template. Abre a tela Novo template do WhatsApp.
  2. Em Identidade, preencha o Nome (minúsculo): só letras minúsculas, números e underline, como horizonte_oferta_semana. Ao sair do campo, a BIP ajusta o nome para esse formato.
  3. Em Categoria, escolha Marketing para ofertas, novidades e convites. Escolha Utilidade só para avisos sobre uma transação que já existe, como um pedido ou um agendamento.
  4. Em Idioma, escolha o idioma do texto: Portuguese (BR) para português do Brasil.
dash.bip.marketing/…/whatsapp/templates/create
Tela Novo template do WhatsApp com a seção Identidade: nome, categoria e idioma

Captura de tela em breve

Tela Novo template do WhatsApp com a seção Identidade: nome, categoria e idioma

3. Escreva o cabeçalho, o corpo e o rodapé

  1. Em Cabeçalho, escolha o Tipo do cabeçalho: Nenhum ou Texto. Com Texto, escreva a linha em negrito no Texto do cabeçalho. Ela aceita uma variável {{1}}; se usar, preencha o valor de exemplo.
  2. Em Corpo, escreva a mensagem no Texto do corpo, com {{1}}, {{2}} onde entram os dados do contato. Em Amostras de variáveis, preencha um exemplo realista para cada uma.
  3. Em Rodapé, use o Texto do rodapé (opcional) para uma linha curta e fixa, como o nome da loja e a validade da oferta.
  4. Acompanhe a Pré-visualização: ela mostra a mensagem ao vivo, com os exemplos no lugar das variáveis.

A BIP confere as regras da Meta enquanto você escreve. Se algo estiver fora, aparece Corrija estes itens antes de enviar: com a lista do que ajustar, e Salvar Template fica desativado até você corrigir.

dash.bip.marketing/…/whatsapp/templates/create
Seções Cabeçalho, Corpo e Rodapé preenchidas, com as amostras de variáveis e a pré-visualização ao vivo

Captura de tela em breve

Seções Cabeçalho, Corpo e Rodapé preenchidas, com as amostras de variáveis e a pré-visualização ao vivo

4. Adicione os botões

  1. Em Botões, clique em Adicionar botão. São até 10 botões.
  2. Em Tipo, escolha Resposta rápida ou URL, e escreva o Texto do botão.
  3. Num botão URL, informe o endereço completo. Para um link que muda por contato, termine a URL com {{1}}, como https://www.exemplo.com.br/verao?cupom={{1}}, e preencha o exemplo.
  4. Use as setas para mudar a ordem e a lixeira para remover um botão.

Um toque em Resposta rápida conta como resposta nas estatísticas da campanha. A conversa que vem depois continua no app WhatsApp Business.

dash.bip.marketing/…/whatsapp/templates/create
Seção Botões com um botão de URL com variável e um botão de resposta rápida

Captura de tela em breve

Seção Botões com um botão de URL com variável e um botão de resposta rápida

5. Envie para aprovação

  1. Clique em Salvar Template. A BIP envia o template para a Meta, mostra Template enviado para a Meta e volta para a aba Templates.
  2. O template entra na lista com o status que a Meta devolve, normalmente Pendente. Quando a Meta decide, o status muda sozinho para Aprovado ou Rejeitado.
  3. Se for rejeitado, selecione o template: o Motivo da rejeição aparece acima da prévia.
  4. A Meta pode trocar a categoria de um template quando entende que o conteúdo é de outra categoria. A BIP mostra sempre a categoria que a Meta definiu.

A BIP não edita um template depois de enviado. Para mudar o texto, crie outro template com um nome novo. Excluir remove o template da BIP e da sua conta na Meta.

dash.bip.marketing/…/whatsapp?tab=templates
Lista de templates com um template Pendente recém-enviado e outro Rejeitado com o motivo da rejeição

Captura de tela em breve

Lista de templates com um template Pendente recém-enviado e outro Rejeitado com o motivo da rejeição

6. Sincronize os templates da Meta

  1. Templates com cabeçalho de imagem, vídeo ou documento e templates com botão de copiar código são criados no Gerenciador do WhatsApp, na Meta.
  2. Na aba Templates da BIP, clique em Sincronizar com a Meta. A BIP traz todos os templates da sua conta, com categoria, status e motivo de rejeição, e mostra quando cada um foi sincronizado.
  3. Templates apagados na Meta saem da lista na próxima sincronização. Templates Pendente recém-criados ficam.
  4. A mídia do cabeçalho de um template sincronizado vira a mídia padrão dele nas campanhas.
dash.bip.marketing/…/whatsapp?tab=templates
Template com imagem no cabeçalho, sincronizado da Meta, na prévia da aba Templates

Captura de tela em breve

Template com imagem no cabeçalho, sincronizado da Meta, na prévia da aba Templates

7. Importe vários templates de uma vez

  1. Clique em Importar do JSON. Abre a janela Importar templates do JSON.
  2. Em Array JSON, cole uma lista de templates no formato da Meta: name, category, language e components. O JSON pronto está em Pronto para copiar.
  3. Clique em Importar. Cada template vai para a Meta separadamente.
  4. Confira o resultado: o total com sucesso e com falha e, em cada linha, o nome e o erro, se houver. Um template com erro não impede os outros.
dash.bip.marketing/…/whatsapp?tab=templates
Janela Importar templates do JSON com o resultado da importação por template

Captura de tela em breve

Janela Importar templates do JSON com o resultado da importação por template

8. Teste o template

  1. Selecione um template Aprovado e clique em Enviar teste. Abre a janela Testar template do WhatsApp.
  2. Em Contato, informe o e-mail, o ID, o rastreador ou o telefone (com + e código do país, sem espaços) de um contato seu na BIP.
  3. Preencha as Variáveis do corpo e clique em Enviar Teste. A mensagem é real e sai do número padrão.

O teste daqui preenche só as variáveis do corpo. Para templates com variável no cabeçalho ou em botão, salve a campanha e use Testar Campanha: o teste segue o mapeamento de variáveis completo.

dash.bip.marketing/…/whatsapp?tab=templates
Janela Testar template do WhatsApp com o contato e os valores das variáveis

Captura de tela em breve

Janela Testar template do WhatsApp com o contato e os valores das variáveis

9. Use na campanha e mapeie as variáveis

  1. Na campanha, em Canal, escolha WhatsApp. Aparece a seção Template do WhatsApp.
  2. Em Template, escolha um template aprovado. A lista mostra o nome, o idioma e a categoria.
  3. Em Número de telefone, deixe Usar número de telefone padrão da conta ou escolha outro número.
  4. Se o template tiver cabeçalho de mídia, aparece Imagem do cabeçalho (quando é imagem, para você enviar o arquivo) ou URL da mídia do cabeçalho (quando é vídeo ou documento). É uma mídia só para todo o envio. Em branco, vale a mídia do próprio template.
  5. Em Mapeamento de variáveis, clique em Adicionar mapeamento de variável para cada variável. Em Variável, escolha a parte do template, como Corpo · {{1}}. Em Campo do contato, escolha o dado que entra no lugar dela.

Cada variável é mapeada uma vez só, e a campanha só é ativada com todas as variáveis mapeadas. Se você trocar o template, o mapeamento e a mídia são limpos. No BIP Full, o nó Enviar WhatsApp dos Fluxos usa o mesmo mapeamento.

dash.bip.marketing/…/campaigns
Seção Template do WhatsApp da campanha com o template, o número e o mapeamento de variáveis para campos do contato

Captura de tela em breve

Seção Template do WhatsApp da campanha com o template, o número e o mapeamento de variáveis para campos do contato

Referência

Campos do construtor

SeçãoCampoRegras
IdentidadeNome (minúsculo)Letras minúsculas, números e underline. Obrigatório.
IdentidadeCategoriaMarketing ou Utilidade.
IdentidadeIdiomaEnglish (US), Portuguese (BR), Spanish (ES) ou Spanish (LATAM).
CabeçalhoTipo do cabeçalhoNenhum ou Texto.
CabeçalhoTexto do cabeçalhoUma linha em negrito, com no máximo uma variável {{1}} e o exemplo dela.
CorpoTexto do corpoObrigatório. Variáveis {{1}}, {{2}}… em ordem, cada uma com exemplo em Amostras de variáveis.
RodapéTexto do rodapé (opcional)Uma linha curta e fixa abaixo da mensagem.
BotõesTipoResposta rápida ou URL. Até 10 botões.
BotõesTextoO rótulo do botão.
BotõesURLEndereço completo. Para link dinâmico, uma variável {{1}} no fim, com exemplo.

Cabeçalho com imagem, vídeo ou documento e botão de copiar código: crie no Gerenciador do WhatsApp e use Sincronizar com a Meta.

Mensagens de validação

MensagemComo resolver
O corpo da mensagem não pode começar com uma variável.Comece com texto: "Olá, {{1}}!".
O corpo da mensagem não pode terminar com uma variável.Termine com texto ou pontuação depois da última variável.
Adicione texto entre as variáveis — duas variáveis não podem ficar coladas.Separe as variáveis com palavras.
Numere as variáveis em ordem, começando em {{1}} e sem pular números.Use {{1}}, {{2}}, {{3}}, sem lacunas.
Informe um valor de exemplo para cada variável do corpo.Preencha todas as Amostras de variáveis.
O cabeçalho aceita no máximo uma variável.Deixe só {{1}} no cabeçalho.
Informe um valor de exemplo para a variável do cabeçalho.Preencha o exemplo abaixo do Texto do cabeçalho.

Categorias

CategoriaQuando usarEnvia pela BIP?
MarketingOfertas, lançamentos, convites, reengajamento.Sim
UtilidadeAvisos sobre uma transação que já existe. Conteúdo promocional é rejeitado ou reclassificado pela Meta.Sim
AutenticaçãoCódigos de acesso. O construtor não cria; aparece quando vem da Meta.Não

Status do template

StatusO que significa
PendenteEm análise na Meta.
AprovadoPronto para campanhas e testes.
RejeitadoA Meta recusou. Leia o Motivo da rejeição.
PausadoA Meta pausou o template por qualidade.
DesabilitadoA Meta desativou o template.
Em recursoA rejeição foi contestada e está em nova análise na Meta.

A BIP também mostra os demais status que a Meta informa, como Sinalizado, Limite excedido, Bloqueado, Arquivado, Desarquivado, Restabelecido, Exclusão pendente e Excluído. Só templates Aprovado, de Marketing ou Utilidade, aparecem na campanha.

Variáveis no envio

Parte do templateComo aparece em VariávelO que preencher
Corpo {{n}}Corpo · {{1}}Um campo do contato para cada variável.
Cabeçalho de texto {{1}}Cabeçalho · {{1}}Um campo do contato.
Botão de URL {{1}}Botão 1 · {{1}}Um campo do contato. O valor entra no fim do link.
Botão de copiar códigoBotão 2 · código do cupomUm campo do contato com o código que a pessoa copia.
Cabeçalho de imagem, vídeo ou documentoCampo próprio acima do mapeamentoUma imagem ou uma URL para todo o envio. Em branco, vale a do template.

O número do botão segue a ordem dos botões no template. Templates com cabeçalho de localização não podem ser usados em campanhas.

Campos do contato mais usados

A lista Campo do contato mostra os dados com nomes em inglês. Os mais comuns:

Na listaO que entra
first nameO primeiro nome: "Marina".
nameO nome completo: "Marina Alves".
emailO e-mail principal.
phone in national formatO telefone no formato do país.
"Cupom" field valueO valor do campo personalizado Cupom.
formatted date from "Data de nascimento" fieldA data do campo Data de nascimento, no formato AAAA-MM-DD.
kpi "Pontos" valueO valor de um KPI, como Pontos.

Dicas para aprovação

  • Escolha a categoria certa: oferta e promoção são Marketing. Utilidade é só para uma transação que já existe.
  • Use exemplos realistas em cada variável. É com eles que a Meta entende a mensagem.
  • Diga quem está falando: o nome da empresa no corpo ou no rodapé.
  • Escreva texto antes e depois das variáveis, sem variáveis coladas.
  • Use links completos do seu próprio domínio, sem encurtador.
  • Escolha o Idioma do texto que você escreveu.
  • Evite pedir dados sensíveis, como documentos e senhas.

Pronto para copiar

Antes de usar, crie em Configurações → Geral → Campos os campos Cupom e Curso de interesse, do tipo String. Troque www.exemplo.com.br pelo endereço do seu site.

Oferta da semana com cupom (Loja Horizonte)

Botão URL: https://www.exemplo.com.br/verao?cupom={{1}}

Variável na campanhaCampo do contatoValor de exemplo
Corpo · {{1}}first nameMarina
Corpo · {{2}}"Cupom" field valueVERAO20
Cabeçalho · {{1}}first nameMarina
Botão 1 · {{1}}"Cupom" field valueVERAO20

Fornada de sábado com reserva (Padaria Aurora)

Os dois botões são de Resposta rápida. Quem toca em qualquer um em até 24 horas depois do envio entra em Respostas, e a reserva continua no app WhatsApp Business.

Variável na campanhaCampo do contatoValor de exemplo
Corpo · {{1}}first nameTiago

Matrículas abertas (Escola Atlas)

Botão URL fixo: https://www.exemplo.com.br/matriculas. O segundo botão é de Resposta rápida.

Variável na campanhaCampo do contatoValor de exemplo
Corpo · {{1}}first nameSofia
Corpo · {{2}}"Curso de interesse" field valueInglês

Os três templates em JSON

Cole em Importar do JSON para criar os três de uma vez:

templates-whatsapp.json
[
  {
    "name": "horizonte_oferta_semana",
    "category": "MARKETING",
    "language": "pt_BR",
    "components": [
      { "type": "HEADER", "format": "TEXT", "text": "Oferta para {{1}} na Loja Horizonte", "example": { "header_text": ["Marina"] } },
      { "type": "BODY", "text": "Olá, {{1}}! Nesta semana, a coleção de verão da Loja Horizonte está com 20% de desconto. Use o cupom {{2}} no site ou na loja até domingo. Boas compras!", "example": { "body_text": [["Marina", "VERAO20"]] } },
      { "type": "FOOTER", "text": "Loja Horizonte · Oferta válida até domingo" },
      { "type": "BUTTONS", "buttons": [
        { "type": "URL", "text": "Ver coleção", "url": "https://www.exemplo.com.br/verao?cupom={{1}}", "example": ["https://www.exemplo.com.br/verao?cupom=VERAO20"] }
      ] }
    ]
  },
  {
    "name": "aurora_fornada_sabado",
    "category": "MARKETING",
    "language": "pt_BR",
    "components": [
      { "type": "HEADER", "format": "TEXT", "text": "Fornada especial de sábado" },
      { "type": "BODY", "text": "Oi, {{1}}! Neste sábado, a Padaria Aurora tira do forno pão de fermentação natural e torta de maçã da casa. Reserve até sexta e retire a partir das 7h. Quer que a gente separe o seu?", "example": { "body_text": [["Tiago"]] } },
      { "type": "FOOTER", "text": "Padaria Aurora · Retirada no balcão" },
      { "type": "BUTTONS", "buttons": [
        { "type": "QUICK_REPLY", "text": "Quero reservar" },
        { "type": "QUICK_REPLY", "text": "Agora não" }
      ] }
    ]
  },
  {
    "name": "atlas_matriculas_abertas",
    "category": "MARKETING",
    "language": "pt_BR",
    "components": [
      { "type": "BODY", "text": "Oi, {{1}}! As matrículas para o curso de {{2}} da Escola Atlas estão abertas, com turmas à noite e aos sábados. Quem garante a vaga até sexta ganha 30% de desconto na primeira mensalidade. Toque no botão para ver horários e valores.", "example": { "body_text": [["Sofia", "Inglês"]] } },
      { "type": "FOOTER", "text": "Escola Atlas · Matrículas 2027" },
      { "type": "BUTTONS", "buttons": [
        { "type": "URL", "text": "Ver horários", "url": "https://www.exemplo.com.br/matriculas" },
        { "type": "QUICK_REPLY", "text": "Falar com a escola" }
      ] }
    ]
  }
]

Como medir

  • Na aba Templates, filtre por Todos os status → Pendente para ver o que ainda está em análise, e por Rejeitado para ler cada Motivo da rejeição.
  • Clique em Sincronizar com a Meta quando quiser conferir o status de todos de uma vez. A prévia mostra quando cada template foi sincronizado.
  • Antes da primeira campanha, faça o envio de teste e confira no celular o texto com os dados reais do contato.
  • Para comparar templates, envie cada um para uma parte do público e compare Taxa de leitura e Taxa de resposta em Estatísticas da Campanha.

Perguntas frequentes

Por que não consigo criar um template com imagem na BIP?

O construtor da BIP cria cabeçalhos de texto. Para imagem, vídeo ou documento, crie o template no Gerenciador do WhatsApp, na Meta, e clique em Sincronizar com a Meta. Na campanha, você escolhe a mídia do envio ou usa a do próprio template.

Posso editar um template aprovado?

Pela BIP, não. Crie um template novo com outro nome e o texto ajustado, e exclua o antigo se não for mais usar. Se você editar o template no Gerenciador do WhatsApp, clique em Sincronizar com a Meta para trazer a versão nova para a BIP.

Por que meu template não aparece na campanha?

A campanha lista só templates Aprovado das categorias Marketing e Utilidade. Confira o status na aba Templates. Se o template foi criado direto na Meta, clique em Sincronizar com a Meta primeiro.

Qual a diferença entre Marketing e Utilidade?

Marketing é para ofertas, novidades e convites. Utilidade é para avisos sobre algo que o cliente já fez, como um pedido ou um agendamento. Se o conteúdo de um template de Utilidade for promocional, a Meta rejeita ou muda a categoria para Marketing.

Veja também