# Templates de WhatsApp: criar, sincronizar e usar

> 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.

Fonte: https://wiki.bip.marketing/pt-br/templates-whatsapp · Atualizado: 2026-10-08

<UseCaseMeta effort="nocode" channel="whatsapp" plan="lite" />

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.

<Checklist items="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

<Steps items="Crie o template na BIP ou sincronize os que já estão na Meta|Aguarde a aprovação: o status muda sozinho para Aprovado|Na 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.

<Shot src="/img/templates-whatsapp/1-pt-br.png" alt="Aba Templates com a lista de templates, os filtros e a prévia de um template" url="dash.bip.marketing/…/whatsapp?tab=templates" />

### 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.

<Shot src="/img/templates-whatsapp/2-pt-br.png" alt="Tela Novo template do WhatsApp com a seção Identidade: nome, categoria e idioma" url="dash.bip.marketing/…/whatsapp/templates/create" />

### 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.

<Shot src="/img/templates-whatsapp/3-pt-br.png" alt="Seções Cabeçalho, Corpo e Rodapé preenchidas, com as amostras de variáveis e a pré-visualização ao vivo" url="dash.bip.marketing/…/whatsapp/templates/create" />

### 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.

<Shot src="/img/templates-whatsapp/4-pt-br.png" alt="Seção Botões com um botão de URL com variável e um botão de resposta rápida" url="dash.bip.marketing/…/whatsapp/templates/create" />

### 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.

<Shot src="/img/templates-whatsapp/5-pt-br.png" alt="Lista de templates com um template Pendente recém-enviado e outro Rejeitado com o motivo da rejeição" url="dash.bip.marketing/…/whatsapp?tab=templates" />

### 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.

<Shot src="/img/templates-whatsapp/6-pt-br.png" alt="Template com imagem no cabeçalho, sincronizado da Meta, na prévia da aba Templates" url="dash.bip.marketing/…/whatsapp?tab=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](#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.

<Shot src="/img/templates-whatsapp/7-pt-br.png" alt="Janela Importar templates do JSON com o resultado da importação por template" url="dash.bip.marketing/…/whatsapp?tab=templates" />

### 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.

<Shot src="/img/templates-whatsapp/8-pt-br.png" alt="Janela Testar template do WhatsApp com o contato e os valores das variáveis" url="dash.bip.marketing/…/whatsapp?tab=templates" />

### 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.

<Shot src="/img/templates-whatsapp/9-pt-br.png" alt="Seção Template do WhatsApp da campanha com o template, o número e o mapeamento de variáveis para campos do contato" url="dash.bip.marketing/…/campaigns" />

## Referência

### Campos do construtor

| Seção      | Campo                          | Regras                                                                                                |
| ---------- | ------------------------------ | ----------------------------------------------------------------------------------------------------- |
| Identidade | **Nome (minúsculo)**           | Letras minúsculas, números e underline. Obrigatório.                                                  |
| Identidade | **Categoria**                  | **Marketing** ou **Utilidade**.                                                                       |
| Identidade | **Idioma**                     | **English (US)**, **Portuguese (BR)**, **Spanish (ES)** ou **Spanish (LATAM)**.                       |
| Cabeçalho  | **Tipo do cabeçalho**          | **Nenhum** ou **Texto**.                                                                              |
| Cabeçalho  | **Texto do cabeçalho**         | Uma linha em negrito, com no máximo uma variável `{{1}}` e o exemplo dela.                            |
| Corpo      | **Texto do corpo**             | Obrigató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ões     | **Tipo**                       | **Resposta rápida** ou **URL**. Até 10 botões.                                                        |
| Botões     | **Texto**                      | O rótulo do botão.                                                                                    |
| Botões     | **URL**                        | Endereç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

| Mensagem                                                                        | Como 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

| Categoria        | Quando usar                                                                                             | Envia pela BIP? |
| ---------------- | ------------------------------------------------------------------------------------------------------- | --------------- |
| **Marketing**    | Ofertas, lançamentos, convites, reengajamento.                                                          | Sim             |
| **Utilidade**    | Avisos sobre uma transação que já existe. Conteúdo promocional é rejeitado ou reclassificado pela Meta. | Sim             |
| **Autenticação** | Códigos de acesso. O construtor não cria; aparece quando vem da Meta.                                   | Não             |

### Status do template

| Status           | O que significa                                           |
| ---------------- | --------------------------------------------------------- |
| **Pendente**     | Em análise na Meta.                                       |
| **Aprovado**     | Pronto para campanhas e testes.                           |
| **Rejeitado**    | A Meta recusou. Leia o **Motivo da rejeição**.            |
| **Pausado**      | A Meta pausou o template por qualidade.                   |
| **Desabilitado** | A Meta desativou o template.                              |
| **Em recurso**   | A 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 template                       | Como aparece em **Variável**      | O 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ódigo                  | **Botão 2 · código do cupom**     | Um campo do contato com o código que a pessoa copia.                    |
| Cabeçalho de imagem, vídeo ou documento | Campo próprio acima do mapeamento | Uma 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 lista                                           | O que entra                                                  |
| -------------------------------------------------- | ------------------------------------------------------------ |
| **first name**                                     | O primeiro nome: "Marina".                                   |
| **name**                                           | O nome completo: "Marina Alves".                             |
| **email**                                          | O e-mail principal.                                          |
| **phone in national format**                       | O telefone no formato do país.                               |
| **"Cupom" field value**                            | O valor do campo personalizado _Cupom_.                      |
| **formatted date from "Data de nascimento" field** | A data do campo _Data de nascimento_, no formato AAAA-MM-DD. |
| **kpi "Pontos" value**                             | O 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)

<WaTemplate name="horizonte_oferta_semana" category="MARKETING" header="Oferta para {{1}} na Loja Horizonte" footer="Loja Horizonte · Oferta válida até domingo" buttons="Ver coleção">
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!
</WaTemplate>

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

| Variável na campanha  | Campo do contato        | Valor de exemplo |
| --------------------- | ----------------------- | ---------------- |
| **Corpo · {{1}}**     | **first name**          | Marina           |
| **Corpo · {{2}}**     | **"Cupom" field value** | VERAO20          |
| **Cabeçalho · {{1}}** | **first name**          | Marina           |
| **Botão 1 · {{1}}**   | **"Cupom" field value** | VERAO20          |

### Fornada de sábado com reserva (Padaria Aurora)

<WaTemplate name="aurora_fornada_sabado" category="MARKETING" header="Fornada especial de sábado" footer="Padaria Aurora · Retirada no balcão" buttons="Quero reservar|Agora não">
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?
</WaTemplate>

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 campanha | Campo do contato | Valor de exemplo |
| -------------------- | ---------------- | ---------------- |
| **Corpo · {{1}}**    | **first name**   | Tiago            |

### Matrículas abertas (Escola Atlas)

<WaTemplate name="atlas_matriculas_abertas" category="MARKETING" footer="Escola Atlas · Matrículas 2027" buttons="Ver horários|Falar com a escola">
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.
</WaTemplate>

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

| Variável na campanha | Campo do contato                     | Valor de exemplo |
| -------------------- | ------------------------------------ | ---------------- |
| **Corpo · {{1}}**    | **first name**                       | Sofia            |
| **Corpo · {{2}}**    | **"Curso de interesse" field value** | Inglês           |

### Os três templates em JSON

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

<Copy label="templates-whatsapp.json" code>
[
  {
    "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" }
      ] }
    ]
  }
]
</Copy>

## 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

- [Conectar o WhatsApp Business à BIP](/pt-br/conectar-whatsapp)
- [Campanhas: única, recorrente e por API](/pt-br/campanhas)
- [Importar contatos de uma planilha](/pt-br/importar-contatos)
- [Segmentos: os 10 critérios para filtrar contatos](/pt-br/segmentos)