Templates Oficiais (API WhatsApp)
Quando voce usa uma conexao WhatsApp API Oficial (canal verificado pelo Meta/WhatsApp Business), os disparos de campanha precisam obrigatoriamente de um template aprovado pela Meta. Mensagens de texto livre so sao permitidas dentro da janela de 24h apos o contato ter respondido.
Por que usar templates?
O WhatsApp API Oficial nao permite enviar mensagens de marketing para numeros que nao iniciaram conversa recentemente. O template e o formato aprovado pela Meta para abrir conversas fora da janela de 24h — por isso e obrigatorio para campanhas massivas.
Cadastrar um template na conexao
Os templates sao gerenciados pela tela de Conexoes, nao diretamente em Campanhas.
- Va em Conexoes no menu lateral.
- Clique em Editar na conexao WhatsApp Oficial desejada.
- Na aba de templates, clique em Criar Template.
- Preencha o conteudo e envie para aprovacao da Meta.
- Aguarde o status mudar para APROVADO (pode levar horas ou dias).
Somente templates APROVADOS aparecem na campanha
Apenas templates com status APPROVED sao listados no seletor de campanha. Templates pendentes ou rejeitados nao aparecem.
Selecionar o template na campanha
Ao criar ou editar uma campanha:
- Selecione uma Conexao do tipo API Oficial. O sistema detecta automaticamente e exibe o campo de template.
- No campo Template, escolha o template aprovado desejado no menu suspenso.
- Se o template tiver variaveis (ex.:
1,2), campos adicionais aparecem para voce preencher os valores que serao substituidos em cada envio.
Templates com variaveis
Um template como "Ola, 1! Seu pedido 2 esta pronto." exige que voce informe o valor de 1 (ex.: nome do contato) e 2 (ex.: numero do pedido) no momento de criar a campanha. O sistema preenche esses valores para todos os contatos da lista.
Templates simples vs. com variaveis (follow-up)
| Tipo | Variaveis | Pode ser usado como follow-up? |
|---|---|---|
| Simples | Nao | Sim |
Com variaveis (ex.: 1) | Sim | Nao |
Para os slots de follow-up (mensagens adicionais enviadas apos a principal), somente templates simples (sem variaveis) sao aceitos, para evitar a necessidade de configurar valores por slot.
Status de follow-up no relatorio
Quando a campanha usa API Oficial e templates com follow-up configurados, o relatorio exibe uma coluna adicional Follow-up (API Oficial) com tres estados possiveis:
| Status | Significado |
|---|---|
| Aguardando resposta | O template foi entregue e estamos dentro da janela de 24h da Meta aguardando retorno do contato |
| Follow-up enviado | O contato respondeu e o follow-up automatico foi disparado |
| Expirado | A janela de 24h passou sem resposta — o follow-up nao sera enviado |
Restricoes da API Oficial em campanhas
Comportamentos diferentes da API Oficial
- Follow-up condicional de texto livre nao e suportado. Apenas templates simples como follow-up.
- Mensagens de texto nos slots 2 a 5 sao ignoradas quando a conexao e API Oficial — somente o template principal e enviado.
- O campo "Abrir ticket" funciona normalmente.
Problemas comuns
Selecionei uma conexao oficial mas nao aparece nenhum template. Verifique se ha templates com status APROVADO cadastrados nessa conexao. Va em Conexoes, edite a conexao e clique em "Sincronizar Templates" para atualizar a lista vinda do Meta.
O template foi aprovado mas ainda nao aparece na campanha. Clique em Sincronizar Templates na tela de Conexoes para forcar a atualizacao. Se o problema persistir, aguarde alguns minutos e tente novamente.
A variavel nao foi substituida corretamente no disparo. Verifique se os valores das variaveis foram preenchidos no modal de campanha. Variaveis em branco sao enviadas como texto vazio para o destinatario.