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%. |
| Sistema de Fila de Envios | Ligado (padrão): as mensagens passam pela fila e são enviadas em segundo plano, respeitando horário, intervalo e teto diário. Desligado: todas as mensagens saem imediatamente, e a aba "Fila de Envios" fica oculta. |
| Lembrete Manual de Faturas | Quando ligado, o botão "Enviar Lembrete" da lista de faturas do WHMCS também dispara o template Lembrete de Fatura no WhatsApp para cada fatura selecionada. Não afeta os lembretes automáticos. |
| Horário Inicial/Final Permitido | Janela de horário em que os lembretes automáticos podem ser enviados — fora dela, ficam retidos até o horário voltar a ser permitido. Continua valendo mesmo com a fila desligada (os lembretes automáticos sempre respeitam essa janela); só as mensagens transacionais é que saem na hora. |
| Teto Diário de Envios | Limite máximo de lembretes automáticos por dia, 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 | "Não utilizar Proxy" (padrão), "Proxy Compartilhado da API" ou "Proxy Própria". Uso avançado — só altere se orientado. |
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 |
| %invoicelink% | Link direto para a fatura (sem login automático). Se o gateway da fatura for boleto/PIX, aponta para o boleto ou a página do PIX; senão, para viewinvoice.php. |
| %comprovante_pagamento% | Link do comprovante de pagamento emitido pelo Asaas (mensagem Fatura Paga). Só é preenchido quando a fatura foi paga por um gateway Asaas, com a integração Asaas ativa e a API Key do Asaas informada na aba Integrações; nos demais casos sai em branco. |
| %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 (ou da cotação) |
| %ticket_resposta% | Texto da resposta que o atendente acabou de publicar no chamado (mensagem Ticket Respondido) |
| %quoteid% | Número do orçamento/cotação |
| %quotestatus% | Novo status da cotação, em português (mensagem Status da Cotação) |
| %autologin% | Link de acesso automático à área do cliente (quando o módulo de autologin estiver disponível) |
| %dominio% %registrationdate% %expirydate% | Nome, data de registro e data de expiração do domínio (mensagens de domínio) |
Variáveis de serviço (mensagens de serviço)
Nas mensagens ligadas a um serviço (ex.: Serviço Criado), estão disponíveis também:
| Variável | Substituída por |
|---|---|
| %servico_id% | ID do serviço |
| %servico_dominio% | Domínio do serviço |
| %servico_status% | Status (Active, Suspended, etc.) |
| %servico_tipo% | Tipo do produto |
| %ciclo_cobranca% | Ciclo de cobrança |
| %data_contratacao% | Data de contratação |
| %proximo_vencimento% | Próximo vencimento |
| %proxima_fatura% | Data da próxima fatura |
| %valor_servico% | Valor recorrente |
| %valor_primeiro% | Valor do primeiro pagamento |
| %forma_pagamento% | Forma de pagamento do serviço |
| %servico_servidor% | Nome do servidor |
| %ip_dedicado% | IP dedicado |
| %servico_ns1% %servico_ns2% | Nameservers |
| %limite_disco% %limite_banda% | Limites de disco e de banda |
| %servico_usuario% %servico_senha% | Usuário e senha do serviço/painel |
{$variavel} dos e-mails do WHMCS, ela não é reconhecida aqui.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 — a mensagem de fatura passa a vir enriquecida conforme a forma de pagamento da cobrança.
| Integração | O que a mensagem de fatura leva |
|---|---|
| Asaas | Boleto → PDF do boleto anexado. PIX → imagem do QR Code + copia e cola. Cartão → botão "Pagar Agora". Fatura paga → link do comprovante de pagamento pela variável %comprovante_pagamento%. |
| Efi Pay | PIX — botão "Pagar Agora". |
| Mercado Pago - Checkout Transparente | Somente PIX — imagem do QR Code + copia e cola. |
| Mercado Pago - Checkout Pro | Boleto, PIX e cartão na página do Mercado Pago — botão "Pagar Agora". |
| Iugu (Edvan) | PDF do boleto anexado. |
| PagHiper | Boleto — botão "Pagar Agora". |
| 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
Alguns têm só o interruptor "Ativar"; no Asaas você ainda marca boleto/pix/cartão e informa a API Key do Asaas e o Ambiente (Produção ou Sandbox). A chave é necessária para enviar o link do comprovante de pagamento.
- 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 — a menos que você tenha desligado o "Sistema de Fila de Envios" em Configurações, caso em que tudo é enviado na hora e esta aba fica oculta.
- 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, "Administrador enfileirou manualmente…" quando alguém dispara uma notificação pela tela da fatura).
Registros do tipo Info que começam com "Comprovante Asaas não aplicado…" explicam por que o link do comprovante não entrou numa mensagem de fatura paga (integração desativada, API Key não informada ou inválida, cobrança ainda não confirmada no Asaas etc.).
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