Tema
Modelos da Meta e Formulários do WhatsApp: como iniciar conversas pela API oficial (e o que é cada coisa)
Quem sai do QR Code para a API oficial da Meta costuma tropeçar no mesmo lugar no primeiro dia: a mensagem para um cliente antigo não sai. Não é defeito. Na API oficial existe a janela de 24 horas, e fora dela a única mensagem aceita é um modelo aprovado pela Meta.
Este artigo explica a janela, as categorias de modelo e o que cada uma custa, como criar modelos dentro do Columba sem tomar rejeição e, no fim, os Formulários do WhatsApp, a outra ferramenta que só existe na API oficial.
A janela de 24 horas
Na API oficial, a Meta só libera texto livre e mídia para um contato que escreveu para a empresa nas últimas 24 horas. Passou disso, só sai modelo. Quando o contato responde, a janela abre de novo e a conversa volta ao normal.
No Chat do Columba, com a janela fechada, o campo de texto dá lugar a uma faixa Fora da janela de 24 h com o botão Enviar modelo:
A regra vale para tudo que inicia contato: a mensagem do atendente para um cliente parado, a campanha, o parabéns de aniversário e o nó Enviar Modelo das automações. Nos números por QR Code não existe janela.
Quatro nomes parecidos
Antes de seguir, vale separar quatro coisas que têm nome parecido:
| No Columba | O que é | Onde fica |
|---|---|---|
| Modelo da Meta | Mensagem aprovada pela Meta; a única que inicia conversa na API oficial | Configurações › Modelos da Meta |
| Template (resposta pronta) | Texto pronto do Columba para colar no Chat, em qualquer conexão | Configurações › Templates |
| Formulário do WhatsApp | Telas preenchíveis que abrem dentro do WhatsApp (só API oficial) | Modelos da Meta › aba Formulários |
| Fluxo | A automação do Columba, desenhada no editor | Automações |
Categorias: o que a Meta cobra
Todo modelo tem uma categoria, e ela define preço e regras. Valores da Meta para o Brasil, por mensagem entregue, desde 1º de outubro de 2026:
| Categoria | Para quê | Por mensagem |
|---|---|---|
| Utilidade | Algo que o contato já pediu: confirmação, lembrete, status do pedido, segunda via | US$ 0,0068 (R$ 0,035) |
| Marketing | Promoção, novidade, convite, reengajamento. Exige consentimento prévio | US$ 0,0625 (R$ 0,3217) |
| Autenticação | Código de verificação, com texto fixo da Meta | US$ 0,0068 (R$ 0,035) |
Utilidade passou a ser cobrada em todo envio, dentro ou fora da janela. A Meta pode recategorizar um modelo na revisão (texto promocional enviado como Utilidade vira Marketing); a opção que deixa a Meta ajustar a categoria vem ligada e evita a rejeição. O consentimento de marketing fica na ficha de cada contato, e a regra padrão das campanhas é não enviar Marketing para quem não está como "Sim". As respostas dentro da janela também passaram a ser cobradas acima de 1.000 por número no mês; o detalhe está em A Meta passa a cobrar cada resposta.
Criar um modelo dentro do Columba
Em Configurações › Modelos da Meta, Novo modelo abre um editor com quatro abas: Mensagem padrão (a maioria dos casos), Carrossel (2 a 10 cartões com imagem ou vídeo), Oferta por tempo limitado (com contagem regressiva e código) e Autenticação. Na mensagem padrão:
- Dê um nome legível ("Lembrete de consulta"); o nome técnico é gerado sozinho.
- Escolha idioma e categoria.
- Cabeçalho opcional: texto curto, imagem, vídeo, documento ou localização.
- Escreva o corpo com os chips de variáveis (nome do contato, primeiro nome, protocolo, atendente, empresa, data, hora, valor, código) ou com uma variável livre.
- Preencha um exemplo realista para cada variável.
- Rodapé e botões opcionais: resposta rápida, link, telefone, copiar código ou Formulário.
- Confira a prévia em balão de WhatsApp e, com o checklist verde, Enviar para revisão.
Três regras evitam a maior parte das rejeições: o corpo não começa nem termina com variável, duas variáveis nunca ficam lado a lado, e exemplo genérico ("teste", "xxx") costuma ser recusado.
A Meta costuma responder em minutos, às vezes horas, e a equipe recebe o aviso no sino. Rejeitado, a linha mostra o motivo traduzido em ação. Modelos novos de Marketing e Utilidade passam alguns dias em avaliação: a Meta entrega primeiro para uma parte do público e libera o resto conforme a reação. Um modelo aprovado aceita uma edição a cada 24 horas e volta para revisão a cada edição. Excluir bloqueia o nome por 30 dias.
O botão Enviar teste manda o modelo aprovado para o seu número sem criar conversa no Inbox nem contar na cota do plano (a Meta pode cobrar o envio). As respostas rápidas voltam para o Columba com o texto do botão, e um fluxo pode seguir caminhos diferentes conforme o toque.
Formulários do WhatsApp
Um Formulário do WhatsApp é uma sequência de telas que abre dentro do próprio WhatsApp quando o contato toca no botão da mensagem: campos de texto, opções, datas, aceite, foto, documento. Ao concluir, as respostas voltam organizadas para o Columba. Serve para agendar, cadastrar, qualificar um lead ou fazer uma pesquisa, tudo que daria várias idas e vindas no chat.
Na aba Formulários, você parte de um modelo pronto (Agendamento, Cadastro, Pesquisa de satisfação, Qualificação de lead, Contato) ou do zero. O construtor mostra as telas à esquerda, o celular no centro e as propriedades à direita. Validar confere as regras da Meta, Prévia oficial mostra exatamente o que o contato vai ver e Enviar teste funciona até em rascunho.
Depois de publicada, uma versão não muda mais (regra da Meta): para alterar, crie uma Nova versão, e a anterior é descontinuada.
O que torna o formulário útil é o destino das respostas. Cada campo pode gravar:
- no cadastro do contato (nome, e-mail ou um atributo seu);
- num campo do chamado ativo da conversa;
- num campo do negócio aberto no funil;
- numa variável do fluxo, para a automação continuar com a resposta.
Com dados em tempo real, as opções são preenchidas na hora em que o contato abre a tela: os próximos dias da agenda, as etapas do funil ou uma lista vinda de um endereço seu.
Para enviar: com a janela aberta, pelo Chat (Mensagem interativa › Formulário) ou pelo nó Enviar Formulário, que espera a resposta e segue pela saída Respondido. Fora da janela, dentro de um modelo com botão Formulário, que também funciona em campanhas.
Formulário não é fluxo
No Columba, Fluxo é sempre a automação que você desenha no editor. Formulário do WhatsApp é a tela preenchível da Meta. Um fluxo pode enviar um formulário e usar as respostas, e um formulário respondido pode iniciar um fluxo (gatilho Formulário Respondido), mas são coisas diferentes e ficam em lugares diferentes.
Para começar
- Cadastre a forma de pagamento na conta do WhatsApp Business; a checklist Saúde do número avisa se faltar.
- Crie dois ou três modelos de Utilidade: retomar o atendimento, lembrete, status do pedido.
- Crie modelo de Marketing só para quem deu consentimento.
- Troque por um formulário a pergunta que hoje mais gera ida e volta.
O guia completo está em Modelos da Meta e Formulários do WhatsApp. Ainda decidindo a conexão? Veja API oficial ou QR Code.
Modelos e formulários estão disponíveis em todo número conectado pela API oficial no Columba. Ainda não usa? Teste por 7 dias sem cobrança.
