Módulo ClientExec

O Clientexec é um sistema completo de gestão de clientes, faturamento e automação de suporte projetado para empresas de hospedagem de sites e provedores de serviços semelhantes. A plataforma oferece recursos integrados como acompanhamento de contas de clientes, faturamento automático, gestão de pagamentos, acompanhamento de tickets de suporte e gestão de domínios e serviços. Foi desenvolvido para agilizar as operações dos usuários e os fluxos de trabalho dos serviços.

Para revendedores de domínios, o Clientexec se integra diretamente à Domain Name API por meio de um módulo de registrador específico disponível em github.com/domainreseller. Depois que a conexão é estabelecida, o registro, a renovação, a transferência e a gestão de DNS dos domínios são realizados automaticamente pela API.

Com seu modelo de licença econômico, sua interface fácil de usar e seus recursos básicos de automação, o Clientexec é uma opção atraente, sobretudo para revendedores de hospedagem de pequeno e médio porte.

💡 O Clientexec é uma opção ideal, especialmente para revendedores de hospedagem de pequeno e médio porte que precisam de fluxos de trabalho simples e procuram uma plataforma econômica. O módulo da Domain Name API oferece ao Clientexec a mesma profundidade de recursos que ao WHMCS, ao Blesta e ao HostBill.

O módulo Clientexec da Domain Name API está disponível em github.com/domainreseller. Requisitos mínimos antes da instalação: Clientexec 6.x ou superior, PHP 7.4 ou superior e a extensão PHP SOAPClient habilitada no servidor.

Etapas de instalação:

• Baixe o pacote de módulo mais recente em github.com/domainreseller.
• Envie os arquivos do módulo para o diretório de instalação seguindo as convenções de posicionamento de módulos de registrador do Clientexec.
• No painel administrativo do Clientexec, vá para Configurações > Plugins > Domain Registrar e localize o módulo de registrador da Domain Name API.
• Clique em Ativar e informe seu nome de usuário e senha de revendedor da Domain Name API.
• Salve e use a opção Testar conexão para confirmar que suas credenciais foram reconhecidas.
• Configure os preços das extensões TLD que deseja vender. Use a ferramenta de importação em massa de TLDs para obter os preços em tempo real da Domain Name API e aplicar sua margem de lucro.
• Se você vende domínios .tr para o mercado turco, configure nesta etapa os campos personalizados de cliente para o número de identidade turco (T.C. Kimlik No), o número fiscal (Vergi No) e a repartição fiscal (Vergi Dairesi) — eles são obrigatórios para o registro .tr.

Observação: se estiver fazendo uma atualização, faça backup dos arquivos do módulo existentes.

💡 O problema mais comum após a instalação é esquecer de ativar a sincronização de domínios. Sem ela, as datas de expiração no Clientexec se afastam dos dados reais do registro na Domain Name API, o que gera faturas em datas erradas e quedas inesperadas de domínios. Ative a sincronização de domínios logo após a instalação e confirme que ela está funcionando corretamente antes de conquistar o seu primeiro cliente.

Para executar o Clientexec com o módulo da Domain Name API, seu servidor precisa atender aos seguintes requisitos:

• Clientexec 6.x ou superior
• PHP 7.4 ou superior (PHP 8.1 recomendado)
• Extensão PHP SOAPClient habilitada
• MySQL 5.7 ou superior
• Um servidor web (Apache ou Nginx)

Um certificado SSL é obrigatório para o painel administrativo e para a vitrine voltada ao cliente.

Para vender domínios .tr no mercado turco, é obrigatório configurar no Clientexec os campos personalizados de cliente para o número de identidade turco (T.C. Kimlik No), o número fiscal (Vergi No) e a repartição fiscal (Vergi Dairesi). Esses campos são exigidos pelo registro .tr — se estiverem ausentes, os registros .tr são recusados.

Consulte regularmente github.com/domainreseller para conhecer os requisitos atualizados do módulo; eles podem mudar com novas versões do Clientexec ou do PHP.

💡 Em produção, execute o Clientexec em um VPS com pelo menos 2 GB de RAM. Ambientes de hospedagem compartilhada causam problemas de estabilidade sob a carga da automação de faturamento — os cron jobs, a geração de faturas e a sincronização de domínios são executados de forma programada e disputam recursos. Um VPS dedicado ou em nuvem com backup automático diário é a escolha de infraestrutura certa para qualquer operação de revenda em produção.

Sim — e a automação completa é o principal motivo para usar essa integração. Depois que o módulo da Domain Name API é configurado no Clientexec, as seguintes operações são realizadas automaticamente pela API, sem intervenção manual:

• registro de domínios e ativação instantânea
• renovação e faturamento de domínios
• transferência de domínios com código EPP
• gestão de registros DNS (A, MX, servidores de nomes)
• atualizações dos dados de contato WHOIS
• privacidade WHOIS e gestão do bloqueio de transferência

No lado da hospedagem, o Clientexec se integra a grandes painéis de controle como cPanel/WHM, Plesk e DirectAdmin, oferecendo, além da automação de domínios, o provisionamento, a suspensão e o encerramento automáticos de contas de hospedagem.

Os clientes podem gerenciar domínios, registros DNS e dados WHOIS diretamente pelo portal do cliente do Clientexec — o que reduz significativamente a carga de suporte para os revendedores.

💡 Uma instalação Clientexec + Domain Name API bem configurada deve gerenciar a grande maioria das operações do ciclo de vida dos domínios sem nenhuma participação da equipe. Casos excepcionais, como transferências com falha ou problemas de conformidade com .tr, aparecem claramente nos logs do módulo do Clientexec, o que agiliza a resolução.

As principais vantagens do Clientexec são:

• Interface amigável: oferece uma experiência intuitiva tanto para administradores quanto para clientes.
• Automação e integração: oferece faturamento automático, acompanhamento de pagamentos, sistema de tickets de suporte e integração com diversos aplicativos de terceiros, como os gateways de pagamento mais populares.
• Portal do cliente: um portal de autoatendimento no qual os clientes podem gerenciar seus serviços, o histórico de faturas e os tickets de suporte.
• Relatórios avançados: inclui ferramentas de relatórios detalhados para análises de negócios e financeiras.
• Escalabilidade: sua estrutura modular permite a adaptação às necessidades de um negócio em crescimento.
• Segurança: inclui protocolos de segurança atualizados e soluções de backup de dados para proteger as informações dos clientes.

💡 A arquitetura modular do Clientexec oferece flexibilidade a revendedores que precisam de fluxos de faturamento fora do padrão ou de integrações personalizadas. Seu modelo de licença econômico pode representar uma vantagem importante no cálculo do TCO para revendedores em fase inicial.

Nos pagamentos, o Clientexec oferece suporte a PayPal, Authorize.Net, 2Checkout, processamento de cartão de crédito, transferência bancária e diversos gateways de pagamento regionais. É compatível com todos os cartões bancários e de crédito disponíveis na Turquia. O faturamento em várias moedas é suportado nativamente — os clientes são cobrados em sua moeda local, enquanto seus custos na Domain Name API são definidos em USD.

Nos painéis de controle, o Clientexec se integra ao cPanel/WHM, Plesk, DirectAdmin e outros grandes painéis de controle. Assim, além da gestão de domínios, oferece suporte ao provisionamento, à suspensão e ao encerramento automáticos de contas de hospedagem.

💡 O suporte a várias moedas, combinado com os dados de custo em USD da Domain Name API, cria uma gestão de margens limpa. Defina USD como moeda de custo no módulo da Domain Name API, estabeleça seu percentual de lucro e deixe a conversão para a moeda do cliente a cargo do Clientexec. Essa abordagem elimina o trabalho manual de ajuste de preços quando as taxas de câmbio oscilam — algo especialmente importante para revendedores que atendem os mercados da Turquia, MENA ou Ásia Central.

O Clientexec gera faturas automaticamente e envia lembretes de pagamento de acordo com o ciclo de faturamento configurado para cada produto. Nas renovações de domínios, o Clientexec verifica as datas de expiração e gera faturas de renovação antes do vencimento. Se a renovação automática estiver ativada e o cliente tiver um método de pagamento válido cadastrado, a renovação é processada automaticamente.

As sequências de lembretes de pagamento são totalmente personalizáveis — você pode definir vários lembretes em intervalos diferentes, antes e depois da data de vencimento, e criar um modelo de e-mail distinto para cada etapa. Faturas não pagas podem acionar a suspensão automática do serviço dentro de um cronograma configurável.

💡 Configure uma sequência de pelo menos 3 lembretes para as renovações de domínios: 30 dias, 14 dias e 3 dias antes da data de expiração. Combine isso com a sincronização de domínios ativada no módulo da Domain Name API, para que o Clientexec mantenha sempre as datas de expiração corretas vindas do registro. Datas de expiração desatualizadas no Clientexec — causadas pela sincronização de domínios desativada — são a principal causa de faturas de renovação incorretas e de quedas inesperadas de domínios.

Sim. O Clientexec inclui um sistema de tickets de suporte integrado que permite aos clientes abrir tickets, acompanhá-los e receber respostas diretamente pelo portal do cliente. O sistema de tickets oferece suporte a encaminhamento por departamento, níveis de prioridade e criação de tickets por e-mail.

Os fluxos de tickets de suporte podem ser personalizados — por exemplo, para encaminhar automaticamente as solicitações de transferência de domínios a uma equipe específica ou definir regras de escalonamento para lembretes de faturas não pagas.

Para problemas específicos de domínios, o log do módulo do Clientexec registra todas as solicitações e respostas de API entre o Clientexec e a Domain Name API; assim, é possível diagnosticar rapidamente a maioria dos erros em operações de domínio sem precisar escalar para o suporte.

💡 Treine sua equipe de suporte para verificar o log do módulo do Clientexec antes de encaminhar problemas de domínios à Domain Name API. O registro de log de uma operação de domínio com falha contém a resposta completa da API — na maioria dos casos, o erro é autoexplicativo (código EPP inválido, bloqueio do registro, saldo insuficiente, divergência de identidade do .tr). Anexar esse registro de log a qualquer ticket aberto na Domain Name API reduz significativamente o tempo de resolução.

Você pode acessar seu histórico de faturas das seguintes formas:

• Pelo painel do cliente: após fazer login, os clientes podem acessar a seção 'Faturas' ou 'Transações da conta' para ver uma lista com o número da fatura, a data de emissão e o status do pagamento.
• Painel administrativo: administradores e equipes de suporte podem pesquisar, filtrar e gerar relatórios dos dados de faturamento usando ferramentas avançadas.
• Páginas detalhadas: ao clicar em uma fatura, é exibido um detalhamento completo, incluindo as descrições dos serviços, os impostos e as taxas.

Para cancelar um serviço, o serviço correspondente é selecionado no painel do cliente ou no painel administrativo e o cancelamento é iniciado pela opção 'Cancelar serviço'. O sistema notifica o cliente automaticamente e registra a operação. Como o cancelamento de um serviço pode ser irreversível, as condições do serviço devem ser analisadas com atenção antes do cancelamento.

Observação: no caso de serviços de domínio, o cancelamento não afeta o status do domínio na Domain Name API. Se o domínio não for renovado, ele expira ao fim do período.

💡 O sistema de histórico de faturas do Clientexec também é útil para acompanhar os prazos de renovação dos domínios. Com o módulo da Domain Name API ativo, todas as operações de domínio realizadas são refletidas automaticamente na fatura do cliente correspondente.

As plataformas de automação de hospedagem em desenvolvimento ativo e totalmente compatíveis com a Domain Name API são: WHMCS (o maior ecossistema, assinatura mensal, padrão global), Blesta (favorável ao código aberto, licença perpétua, voltado para desenvolvedores), HostBill (nível corporativo, mais de 150 integrações) e WiseCP (interface moderna, foco na Turquia e MENA, licença vitalícia).

As quatro plataformas contam com módulos de registrador dedicados da Domain Name API em github.com/domainreseller, oferecendo funcionalidades de automação de domínios equivalentes em todas as opções.

A escolha certa depende do seu mercado, da capacidade técnica da sua equipe e do modelo de custos — e não da capacidade de automação de domínios, que é equivalente em todas as plataformas suportadas.

💡 Se você está escolhendo entre o Clientexec e suas alternativas especificamente para uma operação de revenda de domínios: o Clientexec se destaca pelo custo inicial econômico e pela facilidade de uso. O Blesta vence em custo a longo prazo e flexibilidade para desenvolvedores. O WHMCS leva vantagem na amplitude do ecossistema e nas integrações de terceiros. O WiseCP é a melhor escolha para adequação aos mercados da Turquia e MENA. A Domain Name API oferece suporte às quatro plataformas com integração da mesma qualidade.