Central de Ajuda Quaza Provedores

Cadastro e importação de templates do WhatsApp

Como criar um modelo de mensagem (template) no Meta Business, esperar a aprovação e importá-lo para o Quaza, mapeando as variáveis do sistema (nome do cliente, valor, vencimento, link do boleto). Templates são obrigatórios para iniciar conversa fora da janela de 24h — é o que permite disparar fatura, aviso de vencimento e aviso de atraso pela API Oficial.

Quando usar templates

No WhatsApp, depois de 24h sem o cliente responder, a empresa só pode iniciar contato com uma mensagem modelo aprovada pela Meta — o template. É assim que o Quaza dispara avisos automáticos. Mensagens livres só valem dentro da janela de 24h após o cliente escrever.

Pré-requisitos

• Número ativo na API Oficial (integração "Meta business") — ver o guia de ativação .
• Acesso de administrador ao Meta Business da empresa para criar os modelos.
• Acesso ao módulo de templates do Quaza.

Passo a passo

1Criar o modelo no Meta Business

Acesse business.facebook.com, abra o Portfólio empresarial do número e vá ao Gerenciador do WhatsApp.

No Gerenciador do WhatsApp, abra "Modelos de mensagem" → "Gerenciar modelos".

1. Clique em Criar modelo e escolha a categoria Utilidade (não Marketing).
2. Dê um nome em minúsculas com sublinhado, identificando a função. Recomendado terminar com _meta_business para diferenciar. Ex.: aviso_vencimento_meta_business.
3. Defina o idioma Português (Brasil) e o tipo de variável Número.
4. Preencha o cabeçalho (opcional) e o corpo da mensagem, usando variáveis numeradas {{1}}, {{2}}, {{3}} onde os dados entram.
5. Confira a prévia à direita e envie para análise.

No editor, o corpo usa variáveis numeradas — ex.: "Olá {{1}}, sua fatura de {{2}} vence em {{3}}".

2Aguardar a aprovação da Meta

Após enviar, o modelo fica Em análise. A aprovação leva de 24 a 48h. Quando aprovado, o status muda e o template fica disponível para importar.

Lista de modelos: acompanhe o status (Em análise → Aprovado) e a categoria de cada um.

3Importar o template para o Quaza

1. Clique em Importar templates.
2. Selecione a configuração de WhatsApp (o número) de onde virão os modelos e clique em Avançar.
3. O Quaza lista os modelos aprovados daquela conta. Marque os que quer trazer e clique em Importar.

4Mapear as variáveis do Quaza

Cada variável numerada do template ({{1}}, {{2}}…) precisa apontar para um dado do sistema. No template importado, associe cada número à variável correspondente do Quaza.

No Quaza, em Editar template, cada variável recebe o dado do sistema (cliente, valor, vencimento).

O resultado, na prévia da conversa, fica com os dados reais no lugar das variáveis:

Prévia da mensagem: as variáveis do Quaza (ex.: {$cliente.primeiroNome}) são substituídas pelos dados reais no envio.

Variáveis do Quaza

São os campos que o Quaza substitui pelos dados reais no momento do envio. As mais usadas em avisos financeiros:

Modelos prontos (aviso de fatura)

Sugestões de corpo para os três avisos financeiros. Use {{1}} para o nome, {{2}} para o valor e {{3}} para a data.

Aviso antecipado (antes de vencer)

Olá {{1}}, sua fatura está disponível.
Valor a pagar: R$ {{2}}
Vencimento: {{3}}

Aviso no dia do vencimento

Olá {{1}}, lembrete: sua fatura vence em {{2}}.
Valor a pagar: R$ {{3}}

Aviso vencido (após o vencimento)

Olá {{1}}, identificamos que sua fatura está em atraso.
Valor a pagar: R$ {{2}}
Vencimento: {{3}}

No Quaza, mapeie: {{1}} → {$cliente.primeiroNome}, {{2}} → {$financeiro.valorAtualizado}, {{3}} → {$financeiro.reg_vencimento}.

Dicas para o template ser aprovado

• Selecione a categoria Utilidade manualmente. A Meta costuma pré-selecionar Marketing, que custa mais e exige opt-in do contato.
• Escreva texto transacional e objetivo (fatura, vencimento, valor). Evite linguagem promocional, "imperdível", excesso de emojis e CAIXA ALTA.
• Não prometa nem ofereça nada que não seja o aviso em si — isso joga o modelo para Marketing ou causa reprovação.
• Use as variáveis numeradas e preencha exemplos reais na criação (não deixe campos vazios nem "teste").
• Confira a prévia antes de enviar para análise.

Glossário

Pegadinhas frequentes

1. Categoria Marketing por engano. A Meta pré-seleciona Marketing; troque para Utilidade antes de enviar para análise.
2. Importar antes de aprovar. O Quaza só lista modelos já aprovados na conta. Se não aparecer, o modelo ainda está Em análise (ou foi reprovado).
3. Variáveis não mapeadas. Se {{2}} não for associado a uma variável do Quaza, o envio sai com o dado faltando ou falha.
4. Texto do Quaza diferente do aprovado. O texto do template é o que a Meta aprovou; no Quaza você mapeia variáveis, não reescreve o corpo.
5. Nenhum template padrão. A função de aviso precisa de pelo menos um template padrão habilitado, senão o disparo não acontece.
6. Importar do número errado. Na importação, selecione a configuração (número) correta — cada conta tem seus próprios modelos.

Perguntas frequentes

Documentos relacionados