Construir um template do WhatsApp passo a passo

O construtor de templates é onde você escreve um template de mensagem do WhatsApp, o vê em um celular enquanto digita, corrige tudo o que a Meta rejeitaria e o envia para análise. Ele abre em WhatsApp → Modelos → Novo template; um template salvo abre no mesmo construtor.

Antes de começar

• Um número de WhatsApp conectado (WhatsApp Business).
• A tarefa Gerenciar templates do WhatsApp (Proprietários, Administradores e Editores a têm por padrão; veja Funções e tarefas). Sem ela você pode abrir e ver um template, mas não alterá-lo, e Novo template não aparece.

Passo a passo

1. Abra WhatsApp e a aba Modelos. A lista mostra os templates do número com o status (Rascunho, Em análise, Aprovado, Rejeitado...). Clique em Novo template. A partir de uma transmissão, Criar template na etapa Número e template abre o mesmo construtor em uma nova aba. Um template novo pergunta primeiro Como você quer começar?: escolha um em Templates iniciais, Biblioteca da Meta ou Escrever com IA, ou clique em Começar do zero em Em branco (veja "Pontos de partida" abaixo).
2. Informações básicas: escolha o Número de WhatsApp (quando você tem mais de um), digite o Nome do template (minúsculas; espaços viram sublinhados enquanto você digita, ex.: eid_offer_2026), escolha o Idioma em que o texto está escrito e a Categoria (veja abaixo). Em Variáveis, escolha Numeradas {{1}} ou Nomeadas {{first_name}}. Validade da mensagem diz por quanto tempo o WhatsApp continua tentando entregar a um celular desligado; deixe Padrão da Meta ou veja "Validade da mensagem" abaixo.
3. Tipo de template: Padrão, Carrossel, Oferta por tempo limitado, Código de cupom, WhatsApp Flow, Catálogo, Lista de produtos ou Autenticação. O editor abaixo muda conforme o que o tipo tem; cada um é explicado em Tipos de template mais adiante. Mudar o tipo mantém a sua mensagem. O tipo só pode mudar enquanto o template é novo ou rascunho.
4. Cabeçalho (opcional): Nenhum, Texto, Imagem, Vídeo, Documento ou Localização. Para uma imagem, vídeo ou PDF, clique em Escolher arquivo (ou solte o arquivo na caixa); uma barra mostra o envio, e a Meta analisa o template com este exemplo.
5. Mensagem: digite o texto. A barra de ferramentas adiciona Negrito, Itálico, Tachado, Monoespaçado, Lista com marcadores, Lista numerada, Citação e Emoji. Clique em Adicionar variável onde um valor muda por cliente (no modo nomeado, digite antes o nome da variável, ex.: first_name).
6. Variáveis e valores de exemplo (sob a mensagem, uma caixa por variável): digite um Valor de exemplo realista (Sara, A-1042, 12 de outubro; nunca "teste"). Preenchido a partir de diz de onde as transmissões tiram o valor: Um campo do contato (depois escolha, ex.: Nome), Um campo personalizado do contato, O mesmo texto para todos, Perguntado em cada transmissão ou Escolher ao enviar. Se estiver vazio, usar é o valor alternativo, ex.: "cliente".
7. Rodapé (opcional): uma pequena linha cinza. Para Marketing, Adicionar uma linha de opt-out escreve "Reply STOP to unsubscribe" (em árabe para um template em árabe).
8. Botões (opcional): Resposta rápida, Acessar o site, Ligar para o número, Copiar código da oferta ou Ligar pelo WhatsApp. Digite o Texto do botão; para um site, o Endereço do site (https://), e marque Adicionar ao link um final próprio de cada cliente (ex.: um número de pedido) para um link por cliente, com um Final de exemplo. As setas movem um botão; as respostas rápidas ficam juntas automaticamente.
9. Acompanhe a prévia no celular e as Verificações enquanto avança (abaixo). Clique em Salvar rascunho a qualquer momento.
10. Quando Verificações disser Passa em todas as verificações. Pronto para enviar. (ou restarem só alertas), clique em Enviar para análise, leia o aviso e clique em Enviar para a Meta. Você vê Enviado para análise da Meta e o status passa a Em análise.
11. A Meta decide, geralmente em minutos e no máximo em 24 horas. A OmniBrand obtém o resultado sozinha (em no máximo 15 minutos) e avisa você em Notificações. Depois de Aprovado, o template pode ser escolhido em uma transmissão.

Pontos de partida

A tela inicial de um template novo tem quatro abas.

• Templates iniciais: templates que a OmniBrand escreveu para empresas do Golfo, cada um em inglês e árabe, que já passam em todas as verificações. Digite em Buscar templates iniciais ou clique em um tema (Datas e ocasiões, Pedidos e entrega, Consultas e reservas, Pagamentos, Engajamento de clientes, Boas-vindas e cadastro), escolha Inglês ou العربية e clique em Prévia ou Usar este template. Ele abre no editor com valores de exemplo e Preenchido a partir de já definido (o primeiro nome do cliente, ou Perguntado em cada transmissão). Adapte o texto à sua empresa antes de enviar.
• Marketing (cada um termina com um botão Parar promoções e "Reply STOP to unsubscribe"): saudação de Ramadã, saudação de Eid al-Fitr, saudação de Eid al-Adha, Dia Nacional da Arábia Saudita (23 de setembro), Dia Nacional dos Emirados (Eid Al Etihad, 2 de dezembro), promoção de White Friday, De volta ao estoque, Carrinho abandonado.
• Utilidade (sem nenhuma promoção, para que a Meta os mantenha em Utilidade): Lembrete de consulta, Confirmação de reserva, Confirmação de pedido, Confirmação de pagamento na entrega, Pedido enviado, Pronto para retirada, Lembrete de pagamento (educado, nunca ameaçador), Pagamento recebido, Pedido de avaliação, Boas-vindas, Confirmação de opt-in.
• Autenticação: Código de verificação (OTP), um código de uso único com botão de copiar (veja "Autenticação" em Tipos de template).
• Biblioteca da Meta: templates prontos da própria Meta (pedidos, pagamentos, contas, avaliações). Com mais de um número, escolha-o primeiro. Digite em Buscar na biblioteca da Meta, escolha um Idioma da biblioteca ou um tema e clique em Visualizar e criar. A Meta mantém o texto como está: você digita o Nome do template e preenche o que os botões precisam, Site do botão "…" (começa com https://; termine com {{1}} para um final próprio de cada cliente e então preencha Endereço completo de exemplo) e Número de telefone do botão "…" (com o código do país, ex.: +966512345678). Clique em Criar template. A Meta costuma aprová-lo em segundos (Criado a partir da biblioteca da Meta e aprovado.) e ele abre como template salvo.
• Escrever com IA: descreva a mensagem em O que a mensagem deve dizer? (quem a recebe, por quê e o que pode fazer; nunca cole dados de clientes), escolha o Idioma, a Categoria (Deixar a IA decidir, Utilidade ou Marketing) e o Tom, e clique em Escrever 3 rascunhos. Cada rascunho é verificado segundo as regras da Meta antes de você vê-lo e mostra Pronto para enviar ou quantas verificações restam a corrigir. Clique em Usar este rascunho para abri-lo no editor. Leia com atenção: a IA pode errar detalhes da sua empresa.
• Em branco: clique em Começar do zero para escrevê-lo você mesmo.

Cada solicitação de IA (Escrever 3 rascunhos, uma tradução, uma verificação de categoria) usa 1 geração de IA do seu plano; nenhuma quando você usa a sua própria chave de IA (Configurações de IA). Se a solicitação falhar, a geração é devolvida.

Ajuda da IA no construtor

Ao lado das verificações (no celular: no fim da aba Verificações), Ajuda da IA oferece:

• Traduzir para o árabe ou Traduzir para o inglês. Cada variável, link, número de telefone, valor de exemplo e Preenchido a partir de fica como estava; a tradução é verificada como qualquer template. Em um template novo, clique em Usar esta tradução para substituir o texto. Em um template salvo, clique em Criar o rascunho: um novo rascunho abre no outro idioma com o texto traduzido (salve as suas alterações antes).
• Verificar a categoria com IA (só templates de Utilidade): diz se a Meta provavelmente trataria o template como Marketing e por quê, lista as Palavras promocionais encontradas e sugere uma Redação de Utilidade que mantém as suas variáveis. Clique em Usar esta redação, ou em Mudar para Marketing quando a mensagem é realmente uma promoção.

Escolher a categoria

• Marketing: ofertas, promoções, novidades, novos produtos, convites, lembretes para voltar. O preço mais alto, e só é enviado a pessoas que aceitaram marketing.
• Utilidade: uma atualização sobre algo que o cliente fez ou pediu (um pedido, entrega, reserva, pagamento ou alteração de conta), sem nenhuma promoção. Preço menor.
• Autenticação: códigos de uso único. A Meta escreve o texto deles; escolher esta categoria muda o Tipo de template para Autenticação (veja abaixo).
• A Meta decide no fim. Desde abril de 2025, um template de Utilidade que soa promocional é aprovado como Marketing (preço de Marketing, aceitação de marketing necessária); a verificação CATEGORY_ADVICE avisa você antes de enviar.

Validade da mensagem

Quando o celular do cliente está desligado ou sem conexão, o WhatsApp continua tentando entregar a mensagem. Validade da mensagem (em Informações básicas, abaixo de Categoria) é por quanto tempo ele continua tentando; quando o tempo acaba, o WhatsApp para e a mensagem nunca é entregue. Uma promoção que já terminou, um horário de entrega que já passou ou um código que expirou é pior que nenhuma mensagem, então não escolha um período maior do que o tempo em que a mensagem continua útil.

1. Em Validade da mensagem, deixe Padrão da Meta (30 dias para Marketing e Utilidade, 10 minutos para Autenticação) ou escolha um período na lista. 2. Para outro período, escolha Personalizado…, digite a Quantidade e escolha a Unidade (Segundos, Minutos, Horas ou Dias). 3. O que a Meta aceita por categoria: - Autenticação: de 30 segundos a 15 minutos, ou 30 dias. Não ultrapasse a validade do código (a verificação MESSAGE_TTL_ADVICE avisa você). - Utilidade: de 30 segundos a 12 horas, ou 30 dias. - Marketing: de 12 horas a 30 dias. A Meta a aplica a mensagens enviadas com Entrega otimizada (Marketing Messages API, veja Custos, limites e janelas gratuitas do WhatsApp); mensagens enviadas pela Cloud API comum continuam sendo tentadas por 30 dias. 4. Um período fora do intervalo aparece como a verificação MESSAGE_TTL (correção obrigatória); Corrigir o volta ao padrão. Mudar a Categoria para uma que não aceita o período o remove sozinho. 5. O período vai para a Meta com o template. Alterá-lo em um template já enviado é uma edição: conta para os limites de edição e o template volta para análise. A página do template mostra o período aplicável em Validade da mensagem.

Tipos de template

Cada tipo segue as regras próprias da Meta; as Verificações listam o que falta para o tipo escolhido.

Padrão

Texto com cabeçalho e rodapé opcionais e até 10 botões: Resposta rápida, Acessar o site (no máximo 2), Ligar para o número, Copiar código da oferta e Ligar pelo WhatsApp (um de cada). Ligar pelo WhatsApp permite que o cliente ligue para o número da sua empresa dentro do WhatsApp; as chamadas do WhatsApp precisam estar ativadas para esse número.

Carrossel

Só Marketing. A mensagem é seguida de 2 a 10 cartões que o cliente desliza; não há cabeçalho, rodapé nem botão acima dos cartões. 1. Em Cartões, escolha a Mídia em todos os cartões: Imagem ou Vídeo (todos os cartões usam a mesma). 2. Marque Adicionar um texto curto a cada cartão (até 160 caracteres) se os cartões devem ter texto (todos ou nenhum). 3. Em Botões em todos os cartões, adicione 1 ou 2 botões: Resposta rápida, Acessar o site ou Ligar para o número. Eles são adicionados a todos os cartões na mesma ordem (a Meta exige isso); as setas e a lixeira os alteram em todos os cartões de uma vez. 4. Em cada Cartão, clique em Escolher arquivo em Imagem ou vídeo do cartão para o exemplo, digite o Texto do cartão (com Adicionar variável se um valor muda por cliente, e o Valor de exemplo dele), depois o Texto do botão de cada botão e o Endereço do site ou o Número de telefone. 5. Adicionar cartão adiciona mais um (até 10), no formato do último. As setas movem um cartão para antes ou depois; a lixeira o remove (ficam pelo menos 2). 6. A prévia no celular mostra os cartões sob a mensagem; deslize-os para o lado. Toda transmissão precisa enviar o mesmo número de cartões que o template tem.

Oferta por tempo limitado

Só Marketing. Uma linha de oferta com contagem regressiva acima da mensagem, um cabeçalho de imagem ou vídeo, uma mensagem de no máximo 600 caracteres e nenhum rodapé. 1. Em Cabeçalho, escolha Imagem ou Vídeo e envie o exemplo. 2. Em Oferta, digite o Texto da oferta (até 16 caracteres, sem variáveis, ex.: Até sexta). 3. Deixe Mostrar uma contagem regressiva até o fim da oferta marcado para mostrar quando ela termina; cada transmissão define a data e a hora de término (a prévia mostra uma daqui a 2 dias). 4. Digite o Código de oferta de exemplo (até 15 caracteres, sem espaços); cada transmissão envia o próprio código. 5. Marque Adicionar um botão de site para um segundo botão que abre o seu site. O WhatsApp no computador mostra a oferta como uma mensagem simples.

Código de cupom

Uma mensagem com exatamente um botão Copiar código da oferta; você também pode adicionar respostas rápidas, um site ou um botão de ligação. Digite um Código de exemplo de até 20 caracteres sem espaços; cada transmissão envia o próprio código.

Tipo WhatsApp Flow

Um botão que abre um dos seus WhatsApp Flows (um formulário dentro do WhatsApp, ex.: uma reserva). Marketing ou Utilidade. 1. O botão WhatsApp Flow é adicionado para você; digite o Texto do botão dele. 2. Em Flow, escolha um Flow publicado deste número de WhatsApp (os rascunhos aparecem, mas não podem ser escolhidos; publique-os no WhatsApp Manager → Ferramentas da conta → Flows e clique em Recarregar). Se os seus Flows não puderem ser listados, ou se preferir, clique em Colar um ID de Flow e digite o ID do Flow. 3. Quando o botão é tocado: Abrir uma tela do Flow (então digite o ID da primeira tela do JSON do Flow, ex.: WELCOME_SCREEN) ou Pedir a primeira tela ao endpoint do Flow (para Flows que usam o seu próprio servidor).

Catálogo

Só Marketing. A mensagem abre com uma imagem de produto, e um botão Ver catálogo mostra o seu catálogo inteiro dentro do WhatsApp. Exige um catálogo conectado à conta do WhatsApp; a caixa Produtos diz Catálogo conectado: … ou pede que você conecte um no WhatsApp Manager → Ferramentas da conta → Catálogo antes de enviar (a Meta pode analisar o template enquanto isso). 1. Em Produtos, altere o Texto do botão se quiser. 2. Produto da imagem do cabeçalho (opcional): um ID de produto do seu catálogo. Vazio: o WhatsApp usa o primeiro produto do catálogo.

Lista de produtos

Só Marketing. Um cabeçalho de texto, a mensagem e um botão Ver itens que mostra até 30 produtos em até 10 seções. 1. Digite o texto do Cabeçalho (obrigatório para este tipo). 2. Em Produtos, clique em Adicionar seção, digite o Título da seção (até 24 caracteres) e os IDs dos produtos do seu catálogo, separados por vírgulas ou quebras de linha. O contador mostra quantos dos 30 produtos você usou. 3. Produto da imagem do cabeçalho (opcional): vazio usa o primeiro produto da primeira seção. As seções são o que os envios de teste e as transmissões mostram, a menos que uma transmissão defina as suas próprias; a Meta não as analisa. Na prévia, clique no botão para vê-las.

Autenticação

Códigos de uso único. A própria Meta escreve a mensagem no idioma do template ("123456 é o seu código de verificação."); não há cabeçalho, rodapé, links, mídia nem emoji. O seu próprio sistema envia essas mensagens com o código de cada cliente. 1. Escolha Autenticação em Categoria ou Tipo de template. 2. Em Mensagem de código, marque Adicionar “Para sua segurança, não compartilhe este código.” e Informar quando o código expira (depois os Minutos, de 1 a 90), conforme precisar. 3. Botão: Copiar código (o cliente copia o código), Preenchimento com um toque (um toque o preenche no seu app Android) ou Zero toque (o seu app Android o recebe sem nenhum toque). Texto do botão de copiar e Texto do botão de preenchimento automático são opcionais. 4. Um toque e zero toque exigem os seus Apps Android: clique em Adicionar app e digite o Nome do pacote (ex.: com.example.app) e o Hash de assinatura (11 caracteres) de cada app; até 5. 5. Zero toque também exige marcar a caixa de aceite dos termos de zero toque da Meta. Enviar teste preenche um código aleatório de 6 dígitos.

A prévia no celular

• Ela mostra o template como um cliente o vê no WhatsApp e muda enquanto você digita: cabeçalho, mensagem formatada, rodapé e botões.
• Exemplos preenche as variáveis com os seus valores de exemplo; Variáveis mostra {{1}} no lugar. Uma variável sem exemplo fica marcada em amarelo.
• O sol e a lua alternam entre claro e escuro; Android e iOS trocam o celular. Um template em árabe é lido da direita para a esquerda.
• Com mais de 3 botões, o cliente vê 2 e Ver todas as opções; clique nele na prévia para ver o resto. Um aviso sob o celular informa quando o WhatsApp no computador não mostrará o template.
• Notificação e lista de chats mostra a linha que o cliente vê antes de abrir a conversa.
• No celular, o construtor mostra Editar, Prévia e Verificações como abas; o número vermelho em Verificações é quantos problemas de correção obrigatória restam.

As verificações

• Correção obrigatória: a Meta rejeitaria o template. Enviar para análise fica desativado até que todos sejam corrigidos.
• Provável rejeição: motivos comuns de rejeição ou de mudança de categoria. Você ainda pode enviar.
• Dicas: apenas conselhos.
• Cada verificação também aparece sob o campo a que se refere. Corrigir resolve com um clique quando possível (torna o nome válido, agrupa as respostas rápidas, renumera as variáveis, adiciona um opt-out, encurta um texto, preenche um exemplo para uma variável que reconhece, como first_name). Mostrar leva ao campo. Por quê? abre a explicação em Regras de templates do WhatsApp.
• Algumas verificações precisam dos seus outros templates (um nome já usado, o mesmo texto de outro template, limites de edição); elas aparecem logo depois que você para de digitar.

Alterar um template

• Rascunho: altere qualquer coisa e clique em Salvar rascunho ou Enviar para análise.
• Em análise: não pode ser alterado até a Meta decidir.
• Aprovado, Rejeitado ou Pausado: altere e clique em Salvar alterações, depois em Salvar alterações no aviso. Se o que os clientes veem mudou, ele volta para análise da Meta (Salvo e enviado para análise da Meta); se só Preenchido a partir de ou Se estiver vazio, usar mudou, ele é salvo apenas na OmniBrand. A Meta permite uma alteração por dia e 10 em 30 dias em um template aprovado, e nunca uma mudança de categoria. O nome e o idioma nunca mudam.
• Desativado, excluído ou arquivado: não pode ser alterado; clique em Duplicar para começar um novo rascunho a partir dele.
• O selo Alterações não salvas aparece ao lado do nome até você salvar; fechar ou recarregar a aba pede confirmação antes.

Outro idioma

A Meta nunca traduz. Salve o template, clique em Adicionar idioma, escolha o Idioma e clique em Criar rascunho. Abre-se um rascunho com o mesmo nome, com o texto original em uma caixa no topo para traduzir. Cada idioma é analisado separadamente. Entre inglês e árabe, Traduzir para o árabe / Traduzir para o inglês em Ajuda da IA faz os dois passos para você (veja acima).

Enviar um teste

Um template Aprovado pode ser enviado para os seus próprios números de teste: clique em Enviar teste, escolha o número em Enviar para e clique em Enviar teste. Ele é preenchido com os valores de exemplo, não aparece na caixa de entrada e é limitado a 30 por workspace por dia. Adicione números de teste em Configurações → Regras de mensagens.

Se algo der errado

• Enviar para análise está esmaecido → resta uma verificação de Correção obrigatória (o número vermelho em Verificações), ou nenhum Número de WhatsApp foi escolhido.
• A Meta rejeitaria este template, então nada foi enviado. Corrija estes itens e tente novamente: → o servidor encontrou um problema que o navegador não conseguiu ver (por exemplo, o nome já é usado neste idioma). Corrija cada um.
• A Meta recusou o template: → a própria Meta disse não; o motivo dela é mostrado. Veja Regras de templates do WhatsApp.
• Este arquivo é grande demais ou Escolha uma imagem JPEG ou PNG. → imagens JPEG ou PNG até 5 MB, vídeos MP4 até 16 MB, documentos PDF até 100 MB.
• Nenhum número de teste ainda. → adicione-os em Configurações → Regras de mensagens.
• Não foi possível carregar a biblioteca de templates da Meta para este número. → a Meta recusou a solicitação para este número (o motivo aparece abaixo). Reconecte o número na página Contas; Templates iniciais e Escrever com IA continuam funcionando.
• Criar template fica cinza em Biblioteca da Meta → preencha o Nome do template e todos os dados dos botões: um site que comece com https:// (com um Endereço completo de exemplo quando terminar em {{1}}) e um número de telefone que comece com + e o código do país.
• O rascunho por IA falhou, A tradução por IA falhou ou A sugestão de categoria por IA falhou → o serviço de IA não respondeu ou alterou uma variável; nada foi cobrado. Tente novamente em instantes.
• Não foi possível listar os seus Flows → a conta do WhatsApp não permitiu que a OmniBrand lesse os Flows dela (o motivo da Meta é mostrado). Clique em Colar um ID de Flow e digite o ID do WhatsApp Manager → Flows.
• Nenhum catálogo está conectado a esta conta do WhatsApp → conecte um no WhatsApp Manager → Ferramentas da conta → Catálogo e clique na seta de atualizar em Produtos. Até lá, mensagens de catálogo e de lista de produtos não podem ser enviadas.
• Uma verificação de carrossel diz que os botões dos cartões são diferentes → todos os cartões precisam dos mesmos botões na mesma ordem; adicione e remova-os em Botões em todos os cartões, não em um cartão só.

Relacionado

• Criar um modelo do WhatsApp
• Regras de templates do WhatsApp
• O que significa cada status de modelo
• Transmissões do WhatsApp