Pular para o conteúdo principal

Perfex CRM Integration for WHMCS

O Perfex CRM Integration for WHMCS conecta a sua plataforma de faturamento WHMCS à sua instalação do Perfex CRM e mantém as duas em sintonia automaticamente. Clientes, contatos, faturas, pagamentos, pedidos, serviços, domínios e tickets de suporte circulam entre os sistemas em tempo quase real, de modo que o seu CRM sempre reflita a realidade do faturamento e o seu sistema de faturamento sempre reflita o que as suas equipes de vendas e suporte fizeram no CRM.

O plano Free oferece uma sincronização unidirecional confiável de clientes e contatos do WHMCS para o Perfex CRM. Uma licença Pro desbloqueia a sincronização bidirecional (as edições feitas no Perfex voltam para o WHMCS), além de faturas, pagamentos, pedidos, tickets de suporte, um painel de serviços e domínios dentro do Perfex e um assistente de backfill para os seus dados históricos existentes.

O problema que ele resolve​

O WHMCS é o seu sistema de faturamento e provisionamento. O Perfex CRM é onde você gerencia leads, projetos, tarefas e relacionamento com clientes. Sem uma ponte entre os dois, o mesmo cliente passa a existir duas vezes, em dois bancos de dados, e as duas cópias divergem em questão de semanas. Alguém atualiza um endereço no WHMCS, outra pessoa registra um telefone no Perfex, e nenhum dos dois sistemas é mais confiável.

Este produto elimina a cópia manual. Toda alteração relevante gera um evento, o evento entra em uma fila, e a fila é entregue ao outro sistema por um canal HTTPS assinado.

Dois módulos, ambos obrigatórios​

O produto é distribuído como dois componentes, e ambos precisam ser instalados. Nenhuma das metades faz algo útil sozinha.

ComponenteInstalado emO que fazLicenciamento
⚙️ perfexbridge (addon do WHMCS)WHMCS, em modules/addons/perfexbridgeO módulo pago. Escuta os eventos do WHMCS, coloca-os em fila, assina-os e envia-os ao Perfex. Guarda todas as configurações de sincronização e a chave de licença Pro. No admin do WHMCS aparece como Perfex CRM Bridge.Plano Free por padrão. Uma chave de licença Pro desbloqueia os recursos Pro.
🧩 whmcs_bridge (complemento do Perfex CRM)Perfex CRM, em modules/whmcs_bridgeO complemento gratuito. Recebe os eventos assinados e grava clientes, contatos, faturas, pagamentos, leads e tickets no Perfex. Renderiza a aba WHMCS no perfil do cliente. No admin do Perfex aparece em Setup > WHMCS Bridge.Sempre gratuito. Nunca exige chave de licença.
As duas metades são obrigatórias

Se você instalar apenas o addon do WHMCS, os eventos se acumulam numa fila sem destino. Se instalar apenas o complemento do Perfex, nada nunca lhe enviará dados. O plano (Free ou Pro) é definido inteiramente pela chave de licença do lado do WHMCS. O complemento do Perfex é idêntico nos dois casos.

Os dois componentes têm o mesmo número de versão, atualmente 1.3.4, e devem ser sempre atualizados juntos.

Nomes que você verá na tela

O produto chama-se Perfex CRM Integration for WHMCS. Dentro das duas aplicações, os módulos se identificam de forma mais curta: o addon do WHMCS aparece como Perfex CRM Bridge em Addon Modules, e o complemento do Perfex aparece como WHMCS Bridge em Setup > Modules. São esses os nomes que você deve procurar durante a instalação.

Free vs Pro​

RecursoFreePro
👥 Sincronização unidirecional de clientes, do WHMCS para o Perfex CRM✅✅
👤 Sincronização unidirecional de contatos, do WHMCS para o Perfex CRM✅✅
⚡ Captura de eventos em tempo real através dos hooks do WHMCS, entregues pelo cron do WHMCS✅✅
🔗 Emparelhamento com uma única colagem do Connection code✅✅
✅ Setup checklist e Test Connection✅✅
📝 Logs de atividade nos dois lados✅✅
🔁 Sincronização bidirecional de clientes e contatos, as edições do Perfex voltam para o WHMCS *➖✅
📄 Espelhamento de faturas, as faturas do WHMCS viram faturas do Perfex *➖✅
💳 Sincronização de pagamentos e transações, as faturas espelhadas são quitadas no Perfex *➖✅
🛒 Sincronização de pedidos, um pedido do WHMCS vira um lead ou uma nota de cliente no Perfex *➖✅
🎫 Sincronização de tickets de suporte, tickets, respostas e status nos dois sentidos *➖✅
🌐 Painel de serviços e domínios no perfil do cliente no Perfex *➖✅
⏬ Assistente de backfill para os dados históricos existentes *➖✅
🗂️ Menus suspensos de mapeamento de departamentos de tickets no Perfex *➖✅
⏱️ Tarefa do Perfex por ticket, para registro de tempo nas timesheets nativas *➖✅

* Requer licença Pro.

Todos os campos Pro ficam visíveis e podem ser salvos no plano Free. Eles simplesmente não têm efeito enquanto não houver uma licença válida ativa, e a página de administração avisa isso ao lado de cada um. Veja Licenciamento e ativação do Pro para saber como comprar e ativar.

Requisitos​

RequisitoDetalhe
🖥️ WHMCS8.x ou 9.x. Testado a partir da 8.1.3.
🐘 PHPDa 7.2 até a 8.5. Uma única compilação roda em todas elas. Os dois módulos trazem as suas próprias camadas de compatibilidade, portanto não existe um download separado por versão do PHP.
📇 Perfex CRM3.x, verificado com a 3.4.0.
🔒 HTTPS dos dois ladosObrigatório. O transporte exige HTTPS e valida o certificado TLS. Uma URL http:// simples faz todos os envios falharem, por design, e o campo de URL do WHMCS no lado do Perfex se recusa a salvar se o valor não começar com https://.
⏰ Cron do sistema do WHMCSPrecisa estar em execução. A ponte entrega os eventos em fila e revalida a licença a cada execução do cron. Sem cron, nada é entregue.
🌐 Rede, para a sincronização bidirecional do ProA sua instalação do WHMCS também precisa estar acessível a partir do servidor do Perfex por HTTPS.
🔌 Extensões do PHPcURL, nos dois servidores.
O HTTPS não é opcional

Esta é, isoladamente, a causa mais comum do relato "ele nunca envia nada". O transporte HTTP está restrito ao protocolo https e valida o certificado nas duas pontas. Um certificado autoassinado só é aceitável se realmente for validado no servidor que faz a chamada. Não existe configuração para desligar isso, e isso é deliberado: o segredo compartilhado e os dados dos seus clientes trafegam por esse canal.

Como a sincronização funciona, em um parágrafo​

Nada é enviado de forma síncrona enquanto um administrador espera. Um hook do WHMCS é disparado, o evento é gravado numa tabela de outbox, e o cron do sistema do WHMCS esvazia essa fila e envia cada evento por POST para o Perfex via HTTPS. Toda requisição é assinada com HMAC-SHA256 usando um segredo compartilhado que os dois lados possuem, dentro de uma janela de repetição de 300 segundos. As falhas são repetidas com backoff crescente e, após 15 tentativas, ficam em estado de dead-letter para que um operador as examine. No Pro, o sentido Perfex para WHMCS usa o mesmo canal assinado no sentido inverso, acionado pelo cron do Perfex. Camadas de supressão de eco impedem que uma única alteração fique quicando entre os sistemas para sempre. A explicação completa está em Como funciona e uso diário.

Antes de começar​

Reúna estes itens e toda a configuração leva cerca de dez minutos:

  • Acesso administrativo aos dois sistemas, WHMCS e Perfex CRM.
  • Acesso ao File Manager do seu painel de hospedagem, ou a FTP, para o servidor do WHMCS. O WHMCS não tem instalador de módulos dentro do admin.
  • As duas instalações acessíveis por HTTPS, com certificados válidos.
  • Confirmação de que o cron do sistema do WHMCS está em execução. O WHMCS informa a última execução do cron em Utilities > System > System Health Status.
  • O upload.zip (themesic.com/marketplace/whmcs-perfex.zip) que você baixou, descompactado, de forma que você tenha whmcs-addon/addon.zip e perfex-module/module.zip.

O que vem a seguir​

WHMCS é uma marca registrada da WHMCS Ltd. Perfex CRM é uma marca registrada da MSTdev. A Themesic Interactive é uma desenvolvedora independente e não é afiliada, endossada nem patrocinada por nenhuma das duas.