Integrações

Conecte o WHMCS para ver serviços, faturas, domínios e tickets do cliente dentro da conversa, sem sair do painel.

Menu Configurações > aba Integrações (só admins configuram). Hoje a integração disponível é o WHMCS, o sistema de cobrança e suporte usado por empresas de hospedagem e serviços recorrentes.

Conectar o WHMCS

1. Em Integrações, clique em Conectar WHMCS.
2. Preencha:
   • Nome: só para identificar (por exemplo, WHMCS da empresa).
   • Endereço do WHMCS: a pasta onde o WHMCS está instalado, sem /admin (por exemplo, https://www.suaempresa.com.br/clientes).
   • API Identifier e API Secret: as credenciais criadas no WHMCS (veja abaixo).
   • Access Key (opcional): só se o seu WHMCS usar esse recurso no lugar da liberação por IP.
3. Clique em Salvar e testar. O selo muda para Conectada ou Falhou, com a mensagem do erro.

Criar as credenciais no WHMCS

1. No admin do WHMCS, abra Configurações > Staff Management > Manage API Credentials.
2. Clique em Generate New API Credential e escolha um papel (role) com permissão de leitura de clientes, faturas, serviços, domínios e tickets.
3. Copie o Identifier e o Secret e cole no WayChat. O Secret só aparece uma vez.

Liberar o acesso do WayChat

O WHMCS só aceita chamadas de endereços autorizados. Faça uma das duas opções:

• Liberar o IP do servidor do WayChat em General Settings > Security > API IP Access Restriction. Peça a quem administra o seu WayChat o IP de saída do servidor (a tela de cadastro da integração mostra o IP).
• Usar uma Access Key: defina a chave no configuration.php do WHMCS ($api_access_key) e informe a mesma chave no campo Access Key.

O WHMCS precisa ser público

Por segurança, o WayChat não chama endereços internos ou de rede privada. O WHMCS precisa estar acessível pela internet, por https.

Gerenciar a integração

Cada integração aparece num cartão com estas ações:

Ação	O que faz
Testar conexão	Confere se o WayChat consegue falar com o WHMCS agora.
Editar	Muda nome, endereço ou credenciais. Os segredos já salvos não são exibidos; para trocar, cole um novo, ou apague.
Desativar / Ativar	Pausa sem perder as credenciais.
Excluir	Remove a integração e apaga as credenciais guardadas.

As credenciais ficam guardadas cifradas no servidor.

O que aparece no painel do contato

Na conversa, abra o painel do contato. A seção Integrações busca o cliente no WHMCS automaticamente, procurando primeiro pelo e-mail e depois pelo telefone, e mostra:

• Cliente: nome, empresa, situação (ativo, inativo, etc.), "cliente desde" e o link Abrir no WHMCS.
• Resumo financeiro: quantidade de faturas em aberto e o valor em aberto. Fica destacado quando há atraso.
• Serviços: produto, domínio, situação, valor, ciclo e vencimento.
• Faturas: as mais recentes, com número, situação, total e vencimento.
• Domínios: com situação e vencimento.
• Tickets: assunto, departamento, situação e a última atualização.

O botão Atualizar busca os dados de novo. Para não sobrecarregar o WHMCS, o resultado fica guardado por 2 minutos.

Mensagens que você pode ver:

• Cliente não encontrado no WHMCS (procuramos por e-mail e telefone): o contato não tem o mesmo e-mail ou telefone cadastrado lá. Peça o e-mail ao cliente e atualize o contato em Clientes.
• Não deu para consultar: confira a integração (credenciais, endereço e liberação de IP). Quem não é admin deve avisar um admin.

Uso pela IA

O WayChat sabe montar um resumo curto do cliente no WHMCS (serviços ativos e faturas em aberto) para os agentes de IA usarem na conversa. Esse recurso está preparado no sistema, mas ainda não tem opção na tela de agentes. Enquanto isso, os dados do WHMCS aparecem para a equipe, no painel do contato. Veja IA no atendimento.

Em breve

A tela já mostra o que vem a seguir, ainda sem funcionar: Perfex CRM, Asaas, Google Planilhas e Webhook genérico.

Se você precisa chamar outro sistema agora, use o nó HTTP / Webhook do editor de fluxos.