Tema
Modelos da Meta
Na API Oficial (Meta), a única mensagem que pode iniciar uma conversa — ou reabrir uma conversa parada há mais de 24 horas — é um modelo de mensagem aprovado pela Meta. A tela Configurações → Modelos da Meta (bloco Canais, ao lado de Conectores) reúne, dentro do Columba, tudo o que antes só existia no WhatsApp Manager: criar o modelo, acompanhar a revisão, editar, enviar um teste e excluir.
Modelo ≠ template de mensagens rápidas
"Modelo da Meta" é o modelo aprovado pela Meta para a API Oficial. É diferente dos templates de mensagens rápidas do Columba (Configurações → Templates), que são textos prontos para colar no Chat. E não confunda com Fluxos, que são as automações do Columba.
Quem vê e quem gerencia
- Ver modelos (
Modelos da Meta › Ver): administradores, gerentes e operadores. O operador precisa ver a lista para escolher o modelo no Chat. - Gerenciar modelos (
Modelos da Meta › Gerenciar): administradores e gerentes. Criar, editar, excluir, sincronizar e enviar teste.
Papéis personalizados podem receber as duas permissões em Configurações → Funções e permissões. Quem já tinha Configurações › Editar continua gerenciando modelos.
O card Modelos da Meta, em Configurações, aparece para todo mundo que pode ver, mas só abre quando há pelo menos um número conectado pela API Oficial. Sem número, ele fica esmaecido com a dica "Conecte um número pela API Oficial em Conectores".
A tela
A lista mostra os modelos do número selecionado (quando há mais de um número pela API Oficial, um seletor aparece no topo). Cada linha traz:
| Coluna | O que significa |
|---|---|
| Nome | O nome técnico do modelo (letras minúsculas, números e _). Abaixo, o tipo (Carrossel ou Oferta por tempo limitado, quando for o caso) e se foi criado no Columba ou direto no WhatsApp Manager. |
| Idioma | Um mesmo nome pode existir em vários idiomas (ex.: pt_BR e es). |
| Categoria | Utilidade, Marketing ou Autenticação — define o preço e as regras (ver abaixo). |
| Status | Aprovado, Em análise, Rejeitado, Pausado até … (o motivo aparece ao passar o mouse), Desativado. Modelos novos podem ganhar o selo em avaliação — veja abaixo. |
| Qualidade | ● verde (alta), amarelo (média), vermelho (baixa) ou cinza (sem dados ainda). |
| Atualizado | Última alteração vista pelo Columba. |
Na faixa acima da tabela estão a contagem, há quanto tempo foi a última sincronização, o botão Sincronizar (busca a lista mais recente na Meta) e o link Abrir WhatsApp Manager. Filtre por status e categoria, ou busque pelo nome.
Quando um modelo é rejeitado, a linha mostra o motivo já traduzido em uma ação ("Formato inválido: confira variáveis nas pontas…"). Quando é pausado por qualidade, mostra até quando (se a Meta informar) e o motivo enviado pela Meta; quando é desativado, mostra a data. Em modelos rejeitados ou desativados aparece o link Apelar no WhatsApp Manager — como apelar.
A aba Formulários reúne as telas preenchíveis dentro do WhatsApp — veja Formulários do WhatsApp.
Criar um modelo
O editor tem quatro abas, uma para cada tipo de modelo:
| Aba | Para quê | Categoria |
|---|---|---|
| Mensagem padrão | Texto com cabeçalho, rodapé e botões opcionais — a maioria dos casos | Utilidade ou Marketing |
| Carrossel | Vitrine com 2 a 10 cartões roláveis, cada um com imagem ou vídeo e botões — detalhes | Só Marketing |
| Oferta por tempo limitado | Promoção com contagem regressiva, código e link — detalhes | Só Marketing |
| Autenticação | Código de verificação (OTP) com texto fixo da Meta — detalhes | Autenticação |
Trocar de aba não apaga o que você já escreveu. Para criar uma mensagem padrão:
- Clique em Novo modelo.
- Dê um nome legível (ex.: "Lembrete de consulta"). O nome técnico é gerado automaticamente (
lembrete_de_consulta) e pode ser ajustado — só letras minúsculas, números e_. - Escolha o idioma (padrão Português do Brasil).
- Escolha a categoria em um dos cartões — veja a diferença.
- (Opcional) Adicione um cabeçalho: texto curto (até 60 caracteres, no máximo uma variável), uma imagem, um vídeo, um documento (PDF) ou localização. Para mídia, envie um arquivo de exemplo — a Meta usa esse arquivo só para revisar o modelo; no envio você pode usar outro.
- Escreva o corpo (até 1024 caracteres). Clique nos chips de variáveis para inserir o que o Columba preenche na hora do envio: Nome do contato, Primeiro nome, Protocolo, Atendente, Empresa, Data, Hora, Valor, Código — ou crie uma variável livre.
*negrito*,_itálico_e~tachado~funcionam como no WhatsApp. - Preencha um exemplo para cada variável (a Meta exige). Os chips já vêm com exemplo pré-preenchido.
- (Opcional) Adicione um rodapé (até 60 caracteres, sem variáveis).
- (Opcional) Adicione botões — regras abaixo.
- Confira a prévia à direita, em formato de balão de WhatsApp, atualizada a cada tecla.
- Quando o checklist no rodapé estiver todo verde, clique em Enviar para revisão.
O modelo entra como Em análise. A Meta costuma responder em minutos (às vezes horas). Quando o status muda, a equipe recebe um aviso no sino e a lista se atualiza sozinha.
Salvar rascunho
Salvar rascunho guarda o modelo no Columba sem enviar à Meta — útil para terminar depois ou para a coleção "Duplicar". Além disso, o editor guarda o que você está digitando no próprio navegador: se a página recarregar, o texto volta.
Categorias e preço
| Categoria | Para quê | Cobrança da Meta |
|---|---|---|
| Utilidade | Avisos sobre algo que o contato já pediu: confirmação, lembrete, status do pedido, 2ª via | Grátis dentro da janela de 24 h; cobrado fora dela |
| Marketing | Promoções, novidades, convites, reengajamento | Sempre cobrado, a cada envio. Exige consentimento prévio do contato |
| Autenticação | Códigos de verificação (OTP), com texto fixo da Meta | Sempre cobrado, com tarifa própria (menor que Marketing) |
A Meta pode recategorizar um modelo na revisão (um texto promocional enviado como Utilidade vira Marketing). A opção "Deixar a Meta ajustar a categoria" (ligada por padrão) evita a rejeição nesses casos — o Columba atualiza a categoria na lista quando isso acontece.
Os valores em reais variam por país e mudam com frequência; consulte a tabela oficial da Meta. O que a Meta cobrou aparece em Acompanhar o que a Meta cobra.
Variáveis e exemplos
- O editor gera modelos com variáveis nomeadas (
{{nome}},{{data}}). Modelos antigos com{{1}},{{2}}criados no WhatsApp Manager continuam funcionando e podem ser editados. - Nomes de variável só com letras minúsculas e
_. - O corpo não pode começar nem terminar com uma variável, e duas variáveis não podem ficar lado a lado — escreva algo entre elas.
- Toda variável precisa de um exemplo realista. Exemplos vazios ou genéricos ("teste", "xxx") costumam gerar rejeição.
- Cabeçalho de texto aceita no máximo uma variável; rodapé não aceita variáveis.
As variáveis dos chips são preenchidas automaticamente no envio pelo Chat, pelos fluxos e pelas campanhas (nome do contato, atendente, empresa…). Variáveis livres são pedidas na hora do envio.
Botões
Até 10 botões por modelo, destes tipos:
| Botão | Limite | Regras |
|---|---|---|
| Resposta rápida | até 10 | Texto de até 25 caracteres. O toque volta para o Columba e pode ramificar um fluxo. |
| Link | até 2 | Endereço completo (https://…), até 2000 caracteres. Marque "o fim do link varia a cada envio" para o Columba pedir o complemento no envio (ex.: número do pedido) — e informe um exemplo do link completo. |
| Telefone | 1 | Número no formato internacional (+5511999998888). |
| Copiar código | 1 | O texto é fixo pelo WhatsApp; o código real (até 15 caracteres) é informado a cada envio. Informe um código de exemplo. |
| Formulário | 1 | Abre um Formulário do WhatsApp publicado da mesma conta do WhatsApp Business, na tela escolhida. Texto de até 25 caracteres. Nada a preencher no envio — o Columba identifica cada envio para a resposta chegar ao formulário certo. |
Respostas rápidas precisam ficar agrupadas — todas antes ou todas depois dos outros tipos. O editor reordena sozinho ao enviar.
WhatsApp Desktop
Com 4 ou mais botões, o WhatsApp Desktop mostra só o texto da mensagem (os botões aparecem normalmente no celular). O editor avisa quando isso acontece.
Carrossel
Uma mensagem com um texto em cima e 2 a 10 cartões que o contato rola para o lado — bom para vitrine de produtos, imóveis, planos. Só existe na categoria Marketing.
- Cartões iguais: todos com a mesma mídia (todos imagem ou todos vídeo) e os mesmos botões, na mesma ordem. Por isso a mídia e os tipos de botão são escolhidos uma vez, no topo da seção Cartões.
- Cada cartão tem: a mídia de exemplo (JPG/PNG até 5 MB ou MP4 até 16 MB), um texto de até 160 caracteres (aceita variáveis, sem começar nem terminar com uma) e 1 ou 2 botões (resposta rápida, link ou telefone).
- O texto de cima segue as regras do corpo comum (até 1024 caracteres). Não há cabeçalho, rodapé nem botões fora dos cartões.
- A prévia mostra os cartões lado a lado, roláveis, como no WhatsApp.
No envio, cada cartão recebe a sua própria imagem ou vídeo — a mídia do editor é só o exemplo para a revisão. Veja Mídia e outros campos no envio.
Oferta por tempo limitado
Uma promoção com uma faixa de destaque acima do texto: o texto da oferta (até 16 caracteres, ex.: "Oferta expira!"), a contagem regressiva (opcional) e o código. Só existe na categoria Marketing.
- Botões obrigatórios: Copiar código (informe um código de exemplo; o real vai a cada envio) e um Link (com complemento variável, se quiser).
- Corpo de até 600 caracteres; sem rodapé; cabeçalho opcional, só imagem ou vídeo.
- Com Oferta com prazo ligado, cada envio informa quando a oferta termina e o WhatsApp mostra a contagem regressiva.
Só no celular
No WhatsApp Web e no Desktop o contato vê apenas um aviso para abrir a mensagem no celular.
Autenticação
Para enviar códigos de verificação (login, confirmação de cadastro, troca de senha). O texto é fixo e gerado pela Meta no idioma do modelo — "123456 é seu código de verificação." —, por isso o editor só pede:
Recomendação de segurança: acrescenta "Para sua segurança, não compartilhe este código."
Avisar a validade do código: rodapé "Este código expira em N minutos" (de 1 a 90).
Botão do código:
- Copiar código — funciona em qualquer celular;
- Um toque — o seu app Android preenche o código com um toque;
- Zero toque — o código chega direto no seu app Android, sem toque (exige aceitar os termos da Meta).
Um toque e zero toque pedem o nome do pacote e o hash da assinatura do app (até 5 apps). Quem não tem o app recebe o botão de copiar.
Sem cabeçalho, mídia, links ou variáveis próprias: no envio o Columba informa só o código (até 15 caracteres), que vai no texto e no botão. A prévia mostra o texto fixo.
Mídia e outros campos no envio
O que o modelo pede a cada envio aparece no seletor do Chat, no Enviar teste, no nó Enviar Modelo dos fluxos e nas campanhas:
| O modelo tem | No envio você informa |
|---|---|
| Cabeçalho de imagem, vídeo ou documento | O arquivo — envie pelo Columba (vai para o armazenamento da sua conta) ou cole um link público https. Imagem JPG/PNG até 5 MB, vídeo MP4 até 16 MB, documento PDF (até 10 MB pelo upload; até 100 MB por link). Documento pode ter o nome do arquivo mostrado no WhatsApp. |
| Cabeçalho de localização | Latitude e longitude (aceita vírgula), nome e endereço do local (opcionais). |
| Carrossel | A imagem ou vídeo de cada cartão e as variáveis do texto de cada um. |
| Oferta com prazo | Quando a oferta termina (no Chat, data e hora; padrão: 24 h a partir de agora). Nos fluxos, quanto tempo depois do envio. |
| Copiar código / link com complemento | O código do cupom (até 15 caracteres, sem espaço) / o fim do link. |
| Autenticação | O código de verificação. |
O Columba confere o tipo e o tamanho dos arquivos enviados pela conta antes de mandar à Meta; links externos são baixados direto pela Meta. Respostas rápidas voltam para o Columba identificadas pelo modelo e pelo botão — é o texto do botão que aparece na conversa e que os fluxos usam para ramificar.
Revisão e status
| Status | O que significa | O que fazer |
|---|---|---|
| Em análise | A Meta está revisando | Aguardar. Não dá para editar nem enviar. |
| Aprovado | Pode ser enviado pelo Chat, fluxos e campanhas | — |
| Rejeitado | A Meta recusou | Leia o motivo na linha, ajuste e envie novamente (editar) ou duplique com outra categoria. |
| Pausado até … | A Meta pausou por qualidade baixa. O Columba mostra até quando (quando a Meta informa) e o motivo | Revise o texto e o público; a pausa expira sozinha (3 h na primeira, 6 h na segunda e, na terceira vez, desativação). Enquanto pausado, o envio falha. |
| Desativado | Pausado três vezes ou desativado pela Meta. A lista mostra a data | Não pode mais ser enviado nem editado: crie um modelo novo com outro texto ou apele. |
Qualidade, pausa e ritmo de envio
A qualidade (verde, amarelo, vermelho) reflete bloqueios e denúncias dos contatos que receberam o modelo nas últimas 24 horas. Ficou vermelha: a equipe recebe um aviso no sino, e a Meta pode pausar o modelo se continuar.
Modelos de Marketing e Utilidade recém-criados ou recém-editados passam por um período de ritmo controlado (pacing): a Meta entrega primeiro para uma parte dos contatos, mede a reação e só então libera o volume total. Enquanto a qualidade ainda está "sem dados" (até 7 dias depois de criar ou editar pelo Columba), a lista mostra o selo em avaliação — passe o mouse para ler a explicação. É normal: envios grandes podem sair mais devagar nesses primeiros dias.
Apelar de uma decisão da Meta
Se você discorda de uma rejeição ou desativação, clique em Apelar no WhatsApp Manager na linha do modelo. O link abre os modelos da sua conta no WhatsApp Manager: abra o modelo e use Solicitar revisão, explicando por que o conteúdo segue as regras. A resposta da Meta chega na lista do Columba como uma mudança de status, com aviso no sino.
Editar um modelo
Só modelos Aprovados, Rejeitados ou Pausados podem ser editados. Em um modelo Aprovado, a Meta permite uma edição a cada 24 horas e até 10 edições em 30 dias; quando o limite está em vigor, o botão Editar fica desabilitado e a tela mostra "próxima edição possível em…".
Na edição, nome, idioma, categoria e tipo (aba) não mudam — só o conteúdo: cabeçalho, corpo, rodapé, botões, cartões do carrossel, faixa da oferta ou as opções da autenticação. Ao salvar, o modelo volta para Em análise e fica indisponível para envio até ser aprovado de novo.
Para mudar nome ou categoria, use Duplicar: o editor abre com o mesmo conteúdo como rascunho.
Enviar um teste
Em um modelo Aprovado, clique em Enviar teste, informe o seu número com DDI (+5511999998888) e confira as variáveis (vêm pré-preenchidas com os exemplos). Se o modelo tiver mídia, localização, cartões, prazo de oferta ou código de verificação, o teste pede os mesmos campos do envio pelo Chat — veja a tabela. O envio sai pela Meta como qualquer outro, mas não cria conversa no Inbox nem conta na cota de mensagens do plano. A Meta pode cobrar o envio conforme a categoria.
Excluir um modelo
Clique em Excluir na linha. Se o nome existir em vários idiomas, escolha excluir só este idioma ou todos. Atenção:
- A Meta bloqueia o nome por 30 dias — não dá para criar outro modelo com o mesmo nome nesse período.
- Mensagens já em trânsito ainda são entregues.
- Fluxos e campanhas que usam o modelo deixam de conseguir enviá-lo.
Sincronizar
O Columba sincroniza sozinho ao conectar o número e sempre que a Meta avisa uma mudança (aprovação, rejeição, pausa, qualidade, categoria). Se algo foi criado ou alterado direto no WhatsApp Manager e ainda não apareceu, clique em Sincronizar.
Token sem a permissão certa
No Modo avançado, o Access Token precisa da permissão whatsapp_business_management. Sem ela, a lista aparece vazia com um aviso amarelo e criar/editar falha.