NOTIFICA ZAPIDocumentação do addon
Guia de instalação

Instale e configure o NOTIFICA ZAPI em poucos minutos

Este guia mostra, passo a passo, tudo o que você precisa fazer para colocar o addon no ar: enviar os arquivos, ativar no WHMCS, liberar o acesso, ativar sua licença e conectar seu número de WhatsApp.

Leva cerca de 15 minutos
8 passos guiados
Sem edição de código
1

Antes de começar

O que você vai precisar em mãos

  • Acesso de administrador ao painel WHMCS (área administrativa, não a área do cliente).
  • Acesso aos arquivos do servidor (FTP, SFTP ou gerenciador de arquivos do painel de hospedagem) para enviar a pasta do addon.
  • Sua Chave de Licença, enviada no momento da compra do addon.
  • Seu Token de Acesso à instância, também enviado junto com a licença — é ele que conecta o addon ao servidor de mensagens.
  • Um celular com WhatsApp disponível para ler um QR Code durante a configuração (igual ao WhatsApp Web).
Não tem a licença ou o token em mãos? Você pode instalar e ativar o addon normalmente — só peça esses dois dados a quem forneceu sua licença antes de chegar ao Passo 5.
2

Passo 1 de 6

Enviar os arquivos do addon

O addon é uma pasta única que precisa ser copiada para dentro da instalação do seu WHMCS.

  1. Localize a pasta notificazapi

    Ela contém todos os arquivos do addon (telas, estilos, lógica) já prontos, sem necessidade de nenhuma edição.

  2. Envie a pasta inteira para modules/addons/

    Use seu cliente de FTP/SFTP preferido ou o gerenciador de arquivos do painel de hospedagem. Ao final, o caminho completo deve ficar modules/addons/notificazapi/ dentro da raiz do seu WHMCS.

  3. Confirme que nada ficou de fora

    A pasta enviada deve conter, entre outros, os arquivos notificazapi.php e hooks.php na raiz dela — se algum subitem faltar, o addon pode não ativar corretamente.

Dica Se o seu provedor de hospedagem oferece upload por arquivo compactado (.zip), envie o .zip para a pasta modules/addons/ e extraia por lá — costuma ser mais rápido do que enviar centenas de arquivos individualmente por FTP.
3

Passo 2 de 6

Ativar o addon no painel administrativo

  1. Acesse a área administrativa do WHMCS

    Entre com seu usuário e senha de administrador.

  2. Vá até Configuração → Addon Modules

    No menu superior, clique no ícone de engrenagem e depois em Addon Modules (em instalações mais antigas: Setup → Addon Modules).

  3. Localize "NOTIFICA ZAPI" na lista

    A lista traz todos os addons disponíveis no seu WHMCS, instalados ou não.

  4. Clique em "Activate"

    O WHMCS vai criar automaticamente as tabelas internas do addon no banco de dados. Isso é feito uma única vez e não precisa de nenhuma ação manual sua.

4

Passo 3 de 6

Liberar o acesso para os administradores

Logo após ativar, o WHMCS abre a tela de configuração do addon. Nela você escolhe quais grupos de administradores podem enxergar e usar o NOTIFICA ZAPI.

  1. Marque o(s) grupo(s) de administrador

    Normalmente basta marcar o grupo padrão de administradores (ex.: "Full Administrator" / "Administrador Completo").

  2. Clique em "Save Changes"

    Pronto — um novo item de menu NOTIFICA ZAPI vai aparecer no topo do painel administrativo para os grupos liberados.

Atenção Se o menu do addon não aparecer após salvar, saia e entre novamente na área administrativa (logout/login) — o WHMCS às vezes só atualiza o menu numa nova sessão.
5

Passo 4 de 6

Ativar sua licença de uso

Abra o menu NOTIFICA ZAPI no topo do painel — você vai cair direto na aba Configurações.

  1. Encontre o campo "Chave de Licença"

    Fica no topo da tela, no card "Licença do Addon".

  2. Cole a chave que você recebeu na compra

    É um valor diferente do "Token da API" — não confunda os dois campos.

  3. Clique em "Salvar Configurações"

    O addon confirma automaticamente sua licença com o servidor de licenciamento.

Importante Sem uma licença ativa, o addon fica bloqueado: nenhuma mensagem é enviada, nem manual nem automaticamente, até que a chave seja validada.
6

Passo 5 de 6

Configurar o acesso à instância de mensagens

Ainda na aba Configurações, logo abaixo da licença:

  1. Preencha o campo "Token da API"

    Cole o token de acesso fornecido junto com sua licença — é ele que identifica sua instância pessoal no servidor de mensagens.

  2. Clique em "Testar Conexão"

    O addon confirma na hora se o token é válido e se o servidor de mensagens está respondendo, sem sair da tela.

  3. Ajuste as demais opções, se desejar

    Origem do número (padrão ou personalizado), assinatura das mensagens, horário permitido de envio e teto diário podem ser configurados aqui — todos têm um valor padrão sensato e podem ser revisados a qualquer momento depois.

  4. Clique em "Salvar Configurações"
7

Passo 6 de 6

Conectar seu número de WhatsApp

Vá até a aba QR Code no menu do addon.

  1. Aguarde o QR Code aparecer na tela

    A imagem é gerada automaticamente assim que a aba carrega, com base no token configurado no passo anterior.

  2. No celular, abra o WhatsApp

    Toque em Configurações → Aparelhos conectados → Conectar um aparelho (em alguns modelos: menu de três pontos → Aparelhos conectados).

  3. Aponte a câmera para o QR Code exibido na tela do addon
  4. Aguarde a confirmação

    O status muda automaticamente para "Dispositivo Conectado" assim que a leitura é concluída — não é preciso atualizar a página.

Dica Use um número dedicado ao envio de notificações (não o WhatsApp pessoal do dono do negócio). Isso evita que conversas pessoais se misturem com o histórico de mensagens automáticas.
QR Code não carregou? Confirme se o Token da API foi salvo corretamente na aba Configurações e se o teste de conexão do passo anterior foi bem-sucedido. Sem um token válido, nenhum QR Code pode ser gerado.
8

Confirmação final

Fazer um teste antes de liberar para todos os clientes

Com a licença ativa, o token configurado e o WhatsApp conectado, o addon já está pronto para enviar mensagens de verdade. Antes de contar com ele no dia a dia, vale um teste rápido:

  1. Abra a aba Templates

    Confirme se pelo menos um modelo de mensagem (ex.: "Fatura Criada") está marcado como Ativo.

  2. Gere ou use uma fatura de teste

    Crie uma fatura para um cliente de teste (ou para você mesmo) com um número de WhatsApp válido cadastrado.

  3. Acompanhe a aba Fila de Envios

    A mensagem deve aparecer ali em instantes. Você também pode usar o botão "Pular fila" para forçar o envio imediato, sem esperar o processamento automático.

  4. Confira o resultado na aba Envios

    Um envio bem-sucedido aparece lá com o status enviado. Qualquer problema é detalhado na aba Logs.

✓

Antes de avisar sua equipe

Checklist final de instalação

Marcados todos os itens? A instalação está completa. Para aprender a usar cada aba no dia a dia — templates, automações e mais — siga para o Guia de Utilização.

?

Precisa de ajuda?

Problemas comuns na instalação

O menu "NOTIFICA ZAPI" não aparece no painel administrativo
Confirme se o addon foi realmente ativado (não só configurado) em Configuração → Addon Modules, se o seu grupo de administrador está marcado na lista de acesso, e faça logout/login na área administrativa.
A mensagem "Licença inválida" aparece mesmo com a chave preenchida
Verifique se a chave foi colada sem espaços extras no início/fim. Se o problema persistir, confirme com quem forneceu a licença se ela está realmente ativa para o seu domínio.
"Testar Conexão" falha mesmo com o token correto
Confira se o token foi colado por completo (tokens longos às vezes são cortados em copiar/colar) e se o servidor onde o WHMCS roda tem saída de internet liberada (a checagem depende de uma conexão externa).
O QR Code não é gerado, ou aparece "Não foi possível carregar o QR Code"
Esse erro normalmente indica que o Token da API ainda não foi salvo corretamente, ou que a licença não está ativa. Volte à aba Configurações, confirme os dois campos e tente novamente.
Já escaneei o QR Code, mas o status não muda para "Conectado"
A tela verifica o status automaticamente a cada poucos segundos — aguarde um instante. Se o número já estiver conectado a outro serviço de WhatsApp Web, desconecte-o lá antes de tentar novamente.