Como usar o NOTIFICA ZAPI no dia a dia
Um guia completo, aba por aba, para tirar o máximo proveito do addon: quais mensagens são enviadas automaticamente, como personalizá-las e como acompanhar tudo o que foi enviado.
Pré-requisito
Antes de usar, confirme estes dois pontos
O addon só envia mensagens quando ambas as condições abaixo estiverem atendidas. Se ainda não configurou nenhuma delas, siga primeiro o Guia de Instalação.
Verifique na aba Configurações se a Chave de Licença está preenchida e válida.
Verifique na aba QR Code se o status é "Dispositivo Conectado".
Aba Configurações
Ajustes gerais do addon
Além da licença e do token (definidos na instalação), esta aba concentra os ajustes que você pode querer revisar de tempos em tempos:
| Campo | Para que serve |
|---|---|
| Origem do Número | Define de onde vem o número de WhatsApp de cada cliente: um campo padrão do WHMCS ou um campo personalizado configurado por você. |
| Assinatura das Mensagens | Texto (ex.: nome da equipe) inserido automaticamente onde o modelo usar a variável %assinatura%. |
| Horário Inicial/Final Permitido | Janela de horário em que mensagens podem ser enviadas — fora dela, os envios ficam retidos até o horário voltar a ser permitido. |
| Teto Diário de Envios | Limite máximo de mensagens enviadas por dia pela instância, para reduzir o risco de bloqueio pelo WhatsApp. |
| Intervalo Entre Envios | Tempo mínimo/máximo de espera entre uma mensagem e outra, simulando um envio mais humano. |
| Mensagem de Aniversário | Liga/desliga o envio automático de parabéns e define o campo personalizado onde fica a data de nascimento do cliente. |
| Modo do Proxy | Uso avançado — só altere se orientado, pois pode impedir a conexão da instância se configurado incorretamente. |
Aba QR Code
Mantendo a conexão do WhatsApp saudável
Esta aba mostra o status da conexão em tempo real e se atualiza sozinha a cada 30 segundos enquanto estiver aberta.
Se o status cair para "Desconectado"
- Abra a aba QR Code
Um novo QR Code é gerado automaticamente.
- Escaneie novamente com o celular
Mesmo processo da instalação: WhatsApp → Aparelhos conectados → Conectar um aparelho.
Se precisar trocar de número/aparelho
- Clique em "Desconectar"
Encerra a sessão atual sem apagar o histórico de configuração.
- Escaneie o novo QR Code com o novo aparelho
Aba Templates
O texto (e o interruptor) de cada mensagem automática
Cada evento do WHMCS que pode gerar uma mensagem automática — fatura criada, ticket respondido, serviço suspenso, aniversário do cliente, e assim por diante — tem um modelo (template) nesta aba.
- Ative ou desative cada modelo individualmente
O interruptor Ativo em cada card decide se aquele tipo de mensagem é enviado ou não. Um modelo desativado nunca dispara, mesmo que o evento aconteça no WHMCS.
- Edite o texto livremente
Escreva a mensagem do seu jeito, mantendo (ou não) as variáveis que quiser.
- Insira variáveis com um clique
Use os botões de variável acima do campo de texto para inserir dados reais do cliente/fatura/serviço automaticamente na hora do envio.
- Salve o modelo
Variáveis disponíveis
Nem toda variável faz sentido em todo modelo — use apenas as que combinam com o contexto da mensagem (ex.: %invoiceid% só em mensagens de fatura).
| Variável | Substituída por |
|---|---|
| %name% | Nome do cliente |
| %email% | E-mail do cliente |
| %company% | Nome da sua empresa (configurado no WHMCS) |
| %invoiceid% | Número da fatura |
| %duedate% | Data de vencimento da fatura |
| %value% | Valor total da fatura |
| %product% | Produto(s)/serviço(s) relacionado(s) |
| %domainwhmcs% | Domínio configurado do seu WHMCS |
| %date% | Data atual do envio |
| %hour% | Hora atual do envio |
| %assinatura% | Assinatura configurada na aba Configurações |
| %ticketid% | Número do chamado/ticket |
| %subject% | Assunto do chamado/ticket |
| %quoteid% | Número do orçamento/cotação |
| %autologin% | Link de acesso automático à área do cliente (quando disponível para o contexto) |
Aba Automações
Lembretes e alertas com dias configuráveis
Enquanto a aba Templates liga/desliga cada tipo de mensagem, a aba Automações configura especificamente os lembretes que dependem de contagem de dias — quantos dias antes (ou depois) de uma data cada aviso deve disparar.
Até 3 lembretes independentes, cada um com sua própria quantidade de dias de antecedência (padrão: 7, 3 e 1 dia antes).
Aviso no próprio dia do vencimento, sem contagem de dias.
Até 3 cobranças independentes após o vencimento (padrão: 1, 3 e 5 dias depois).
Avisa o cliente com antecedência configurável antes de um serviço ser suspenso ou cancelado por falta de pagamento.
- Ative o lembrete desejado
- Ajuste a quantidade de dias
Cada lembrete tem seu próprio campo numérico — não é possível repetir a mesma quantidade de dias duas vezes dentro do mesmo grupo.
- Salve
Aba Integrações
Botão "Pagar Agora" direto na mensagem de fatura
Se você já usa um dos gateways de pagamento suportados, o addon detecta automaticamente o módulo instalado no seu WHMCS e permite ativar a integração — o link de pagamento passa a vir embutido como um botão nas mensagens de fatura.
| Gateway | Formas de pagamento |
|---|---|
| Asaas | Boleto, Pix e Cartão |
| Efi Pay | Pix |
| Mercado Pago | Pix |
| Iugu | Pix |
| PagHiper | Boleto |
| Nota Fiscal (Asaas) | Não é gateway — envia automaticamente o PDF da nota fiscal quando disponível |
- Abra a aba Integrações
Gateways não instalados no seu WHMCS aparecem desabilitados — isso é esperado.
- Ative o gateway que você usa
- Marque as formas de pagamento desejadas
Quando aplicável (ex.: Asaas permite escolher boleto/pix/cartão separadamente).
- Salve
Aba Fila de Envios
Acompanhando o que está prestes a ser enviado
Toda mensagem passa primeiro por esta fila antes de ser efetivamente enviada.
- Ver detalhes — abre o conteúdo completo da mensagem antes de ser enviada.
- Pular fila — envia a mensagem imediatamente, sem esperar o processamento automático.
- Reprocessar — tenta reenviar um item que falhou.
- Exclusão em massa — remove vários itens da fila de uma vez, com filtros.
No topo da aba, os indicadores de Saúde da Instância mostram, em tempo real: teto diário utilizado, mensagens enviadas e falhas nas últimas 24h, tamanho atual da fila pendente e quantos QR Codes foram gerados no período.
Aba Envios
Histórico completo do que já foi enviado
Toda mensagem que sai da fila — com sucesso ou com falha — gera um registro permanente aqui, com data, cliente, status final (enviado ou falhou) e o motivo em caso de falha.
Use os filtros de cliente (nome ou ID) e número da cobrança para localizar rapidamente o histórico de um caso específico, e o botão Remover registro para limpar itens que não precisa mais manter.
Aba Logs
Diagnosticando problemas
Sempre que algo sai do esperado — uma falha de conexão, uma rejeição de segurança, uma mudança relevante de estado — um registro é gravado aqui, com filtro por data e por tipo:
Falhas técnicas — normalmente exigem alguma correção sua (ex.: token inválido).
Um envio específico não foi concluído (ex.: número inválido).
Eventos informativos de auditoria (ex.: instância conectada/desconectada).
Recomendado
Boas práticas para não ser bloqueado pelo WhatsApp
- Use um número dedicado só para o addon, de preferência já com algum histórico de uso normal antes de começar a enviar em volume.
- Respeite o teto diário configurado na aba Configurações — evite aumentá-lo bruscamente de uma vez.
- Mantenha o horário permitido de envio dentro de um período comercial razoável.
- Só envie lembretes automáticos para quem consentiu receber mensagens — use o campo de opt-in do cliente em Configurações.
Ajuda rápida