WhatsApp do WHMCS

Documentação
Guia e informações de configuração do módulo do WHMCS para o WhatsApp

Requisitos para instalação e configuração do módulo

O módulo oficial do WhatsApp permite o envio de mensagens por meio de três plataformas principais: WhatsApp Meta Cloud API , Evolution API e Baileys API. Antes de começar a utilizá-lo, é necessário seguir algumas etapas de configuração. A principal vantagem desse módulo é a flexibilidade de escolha entre as três plataformas para o disparo das mensagens, garantindo que a entrega seja realizada de acordo com sua preferência.

WhatsApp Meta Cloud API

A Cloud API do WhatsApp Business é a solução oficial da Meta (Facebook) para permitir que empresas integrem o WhatsApp às suas plataformas, sistemas e aplicativos de forma escalável e segura. Diferente de soluções não oficiais, essa API roda na infraestrutura da Meta, eliminando a necessidade de servidores próprios para manter a comunicação com o WhatsApp.

1. O módulo de notificação do WHMCS para o WhatsApp precisa de uma conta verificada no Meta (Facebook), atual proprietária da plataforma do WhatsApp. Veja como verificar sua conta no Meta.
2. É necessário configurar uma conta e um app de desenvolvedor da Meta. Para atender a esses requisitos, acesse o link https://developers.facebook.com/docs/whatsapp/cloud-api/get-started
3. O número usado no WhatsApp API Cloud deve ser apenas para esse fim.
4. Criar modelos de mensagens, esses modelos serão as mensagens disparadas, elas precisam ficar definidas dentro da plataforma do WhatsApp, veja como criar.

• Curso gratuito para aprender a fazer as etapas
• Download módulo gratuito de WhatsApp API para o WHMCS

O que é o Evolution API

A Evolution API é uma solução de terceiros que atua como um intermediário para facilitar a integração e o envio de mensagens via WhatsApp Business API. Ela oferece uma interface simplificada e recursos adicionais, como automação de mensagens, gerenciamento de fluxos de comunicação e suporte para envio de diferentes tipos de conteúdo (texto, imagens, arquivos, etc.).

Essencialmente, ela permite que empresas ou desenvolvedores utilizem a infraestrutura do WhatsApp Business de forma mais acessível e personalizada, sem precisar lidar diretamente com a complexidade da API oficial do Meta. É ideal para quem busca escalabilidade, flexibilidade e facilidade na implementação de sistemas de comunicação empresarial.

Para utilizar o módulo com a Evolution API , é necessário que o serviço esteja rodando em uma infraestrutura como uma VPS, Docker ou similar. Caso precise de um serviço baseado na Evolution API, entre em contato para obter informações sobre valores e condições.

Você pode optar por usar o serviço conosco ou implementá-lo diretamente dentro da sua própria infraestrutura, de acordo com sua preferência.

O que é o Baileys API

O Baileys API é uma biblioteca em Node.js que permite a comunicação direta com o WhatsApp Web por meio de WebSockets, sem depender da API oficial do WhatsApp Business. Desenvolvido como um projeto open-source, o Baileys é amplamente utilizado por desenvolvedores que desejam criar bots, automações e integrações personalizadas para o WhatsApp.

Diferente da API oficial do WhatsApp Business, que requer aprovação do Meta Business e possui diversas restrições, o Baileys funciona simulando uma sessão do WhatsApp Web. Ele permite o envio e recebimento de mensagens, gerenciamento de grupos, manipulação de mídia (como imagens, áudios e vídeos), além de outras funcionalidades avançadas.

Para utilizar o módulo com a Baileys API , é necessário que o serviço esteja rodando em uma infraestrutura como uma VPS, Docker ou similar. Caso precise de um serviço baseado na Baileys API, entre em contato para obter informações sobre valores e condições.

Você pode optar por usar o serviço conosco ou implementá-lo diretamente dentro da sua própria infraestrutura, de acordo com sua preferência.

Qual API usar para o envio de notificações no WHMCS?

Quando se trata de integrar o WhatsApp ao WHMCS para o envio de notificações, é importante escolher a API que melhor atende às necessidades do seu negócio. As três principais opções são:

1. Baileys API (Não Oficial)

• Vantagens:
• ✅ Código aberto e gratuito
• ✅ Permite automações e personalizações avançadas
• ✅ Suporte a múltiplos números e instâncias
• ✅ Não exige aprovação da Meta
• Desvantagens:
• ❌ Maior risco de banimento do número
• ❌ Requer infraestrutura própria (servidor)
• ❌ Pode apresentar instabilidade em atualizações do WhatsApp Web

2. Cloud API do WhatsApp Business (Oficial)

• Vantagens:
• ✅ Solução oficial da Meta, evitando bloqueios
• ✅ Hospedada na nuvem da Meta, sem necessidade de servidores próprios
• ✅ Conformidade com as políticas do WhatsApp
• ✅ Melhor escalabilidade e suporte técnico
• Desvantagens:
• ❌ Custo por mensagem enviada
• ❌ Exige aprovação de templates para mensagens proativas
• ❌ Processo de verificação e conformidade necessário

3. Evolution API (Alternativa Profissional)

• Vantagens:
• ✅ Maior estabilidade em comparação com soluções não oficiais
• ✅ Melhor taxa de entrega e suporte a alto volume de mensagens
• ✅ Possibilidade de integração com múltiplos números
• ✅ Suporte a recursos avançados como mensagens interativas
• Desvantagens:
• ❌ Não é uma solução oficial da Meta
• ❌ Possui custos operacionais
• ❌ Pode exigir configurações avançadas para otimização

A vantagem do módulo WHMCS desenvolvido

Nosso módulo exclusivo para WHMCS resolve esse dilema ao permitir o uso simultâneo de todas essas plataformas. Isso possibilita configurar estratégias híbridas, onde:

• ✅ O Baileys API pode ser utilizado para mensagens internas e automações personalizadas.
• ✅ A Cloud API do WhatsApp Business pode ser utilizada para mensagens críticas, como faturas e notificações importantes, garantindo entrega segura.
• ✅ O Evolution API pode ser usado para atender demandas mais robustas, oferecendo maior estabilidade e suporte a mensagens em larga escala.
• ✅ Envio de mensagem de acordo com a definição do idioma do usuário definido no perfil do cliente.
• ✅ Uso de múltiplos números de WhatsApp para disparo de mensagens.

Dessa forma, você tem flexibilidade e redundância, garantindo que as notificações do WHMCS sejam entregues pelo melhor canal disponível, reduzindo custos e riscos de falhas.

Download WhatsApp para WHMCS

Para fazer a sua instalação no sistema WHMCS. O primeiro passo é fazer o Download do módulo de notificação. Após o Download, inicia-se o processo de instalação e configuração do módulo de notificações no WHMCS. A seguir as etapas desse processo:

Passo 1 | Preparando os arquivos

Primeiro, extraia o arquivo .zip do módulo (baixado no seu computador), os arquivos descompactados ficam dentro da pasta whmcs-gateway-preferences, dentro dessa pasta tem um arquivo INSTALL.txt e uma pasta modules. Faça o upload da pasta modules no raiz do sistema WHMCS;

Passo 2 | Acessando as opções

Depois, dentro do WHMCS, acesse o item de configurações do menu superior (cujo ícone é uma chave fixa) e clique no subitem Opções;

Passo 3 | Ativando Módulos Addon

Na página seguinte, vá até o campo de pesquisa (na lateral esquerda da tela) e digite o termo “Módulos Addon” (para ativar os módulos complementares). Depois, clique no card que aparecerá com esse mesmo nome.

Passo 4 | Concluindo a ativação

Na página dos módulos complementares, procure na tabela o módulo Notificação WhatsApp. Depois, clique no botão Ativar.

O banco de dados preferencialmente deve estar definido com a ENGINE InnoDB, a tabela tblclients obrigatoriamente precisa estar em InnoDB, caso contrário não irá conseguir ativar e irá aparecer um erro similar a este: Unable to create database table: PDOException: SQLSTATE[HY000]: General error: 1005 Can’t create table: errno: 150 “Foreign key constraint is incorrectly formed.

Passo 5 | Configurando o módulo

Defina primeiro quem terá acesso à página de configuração do módulo. Para isso, clique no botão Configurar e escolha entre: Administrador, Operador de venda e Operador de suporte. Para finalizar essa parte, clique no botão Salvar alterações.

Passo 6 | Acessando configurações

Em seguida, para entrar na página de configuração do módulo, acesse o item Addons do menu superior e clique no subitem Notificação WhatsApp;

Passo 7 | Configurando o módulo

A página seguinte é a de configurações gerais. No campo “Licença Link Nacional”, deixe o campo de licença sem preencher. Caso tenha adquirido uma licença conosco insira ela nesse campo. Recomendamos habilitar a opção Depurar (que faz o registro dos logs de erro). O campo opcional Nome padrão, é o nome utilizado quando um cliente não tem nome definido no seu perfil, nossa sugestão é definir como: Cliente. Depois, clique no botão Salvar.

Passo 8 | Opções do Whatsapp

Na aba WhatsApp, clique no subitem Configurações.

Passo 9 | Preenchendo os campos

Dentro da página das configurações do WhatsApp preencha os campos:
ID do campo personalizado do número do WhatsApp no perfil do cliente;
Token de acesso do usuário: preencha com o seu token de acesso à API do WhatsApp;
ID da conta comercial: preencha este campo com o número identificador da sua conta no WhatsApp Business;
Identificação do número de telefone: preencha com o número de telefone usado na sua conta do WhatsApp Business.

Passo 10 | Salvando as configurações

Clique no botão Salvar para concluir a configuração do módulo de notificações via WhatsApp.

Passo 11 | Message templates

Os templates na API WhatsApp Cloud da Meta se referem a formatos de mensagens predefinidos que são usados para enviar mensagens automatizadas, estruturadas e consistentes por meio do WhatsApp. Esses templates são projetados para simplificar a comunicação com usuários, clientes ou clientes, fornecendo uma maneira padronizada de transmitir informações ou atualizações. Veja como criar.

Passo 12 | Configurando o WHMCS WhatsApp Message template

É chegada a hora de realizar a configuração da notificação utilizando o modelo de mensagem do WhatsApp API. Ao criar o modelo de mensagem no Meta, é possível estabelecer parâmetros que serão substituídos pelos dados do sistema do WHMCS.

Você pode selecionar o idioma que deseja que as notificações sejam enviadas. Cada template pode ser traduzido para diversos idiomas:

Passo 13 | Message templates

Após a criação dos modelos de mensagem no Meta, é o momento de vinculá-los ao WHMCS, permitindo que sejam acionados de acordo com as notificações ativadas. Após a instalação das notificações disponíveis para download gratuito no Github, ativá-las é simples: basta clicar no botão ‘Ativar’.

Passo 14 | Notificações WHMCS com WhatsApp

Agora é o momento de configurar a notificação utilizando o modelo de mensagem do WhatsApp. Ao criar o modelo de mensagem no Meta, é possível definir parâmetros que serão substituídos pelos dados do sistema do WHMCS. Esses parâmetros podem ser personalizados no cabeçalho, corpo e nos botões da mensagem. Após a configuração com os parâmetros desejados, basta clicar no botão ‘Salvar’.

Notificações WHMCS com Evolution WhatsApp

Agora é hora de configurar as notificações utilizando a Evolution API . O processo com a Evolution é mais simplificado, mas será necessário fornecer algumas informações essenciais: o URL da API da Evolution, a chave de licença da API e a definição do campo do WhatsApp. Após adicionar as informações, salve-as. Se tudo estiver configurado corretamente, será exibido um QR Code para que você realize a leitura diretamente no seu WhatsApp.

Mensagens de Notificações WHMCS com Evolution WhatsApp

Para criar as mensagens de disparo, o processo é realizado diretamente no módulo. Acesse a aba Plataforma > WhatsApp Evolution > Notificações .

Criando ou Editando as Mensagens de Notificações

O primeiro passo é clicar no botão Configurar na lista de notificações. Isso permitirá iniciar a criação, edição ou adição de mensagens em outro idioma.

Criando uma Nova Mensagem de Notificações

O primeiro passo é clicar no botão Configurar na lista de notificações. Ao criar pela primeira vez, você precisa selecionar o idioma da mensagem.

Após selecionar o idioma, o campo de mensagem será disponibilizado para a criação da notificação. É possível utilizar parâmetros do próprio WHMCS dentro da mensagem. Veja um exemplo na imagem abaixo:

Após preencher a mensagem, clique em Salvar para que ela fique disponível no idioma selecionado anteriormente. A notificação será configurada de acordo com o hook especificado. No exemplo, ela será usada toda vez que um usuário responder a um chamado.

Adicionar Novo Idioma para a Mensagem

Para adicionar um novo idioma, após salvar a mensagem pela primeira vez, será exibida uma opção para incluir outro idioma. Basta clicar no link para criar a mensagem em um idioma diferente para a mesma notificação (Hook).

Clique em Salvar para que o novo idioma seja adicionado como opção da notificação. A notificação será utilizada com base no idioma definido no perfil do cliente. Por exemplo, se o perfil do cliente estiver configurado em inglês e a notificação incluir inglês e português, a mensagem será enviada no idioma inglês.

Passo 15 | Visualizar licença da Link Nacional

A chave de licença da Link Nacional é opcional, caso tenha aquirido ela, acesse a área do cliente, entre no item Serviços do menu superior e clique no subitem Minhas licenças. Ao entrar na página, copie o código da licença e o adicione nas configurações do Addon dentro do administrativo do seu WHMCS.