Licenciamento e ativação do Pro

O plano Free é uma forma suportada e permanente de usar o Perfex CRM Integration for WHMCS. Ele sincroniza clientes e contatos em um único sentido, do WHMCS para o Perfex, em tempo real. Você nunca precisa de uma chave para isso.

Uma licença Pro desbloqueia o resto. Esta página cobre como comprá-la, ativá-la, verificá-la e removê-la.

O que o Pro desbloqueia

Desbloqueado pelo Pro	O que isso significa no dia a dia
🔁 Sincronização bidirecional de clientes e contatos	Um endereço corrigido no Perfex volta para o WHMCS, conforme a política de conflitos que você escolheu
📄 Espelhamento de faturas	As faturas do WHMCS aparecem no cliente do Perfex com os seus itens, a linha de imposto e o status
💳 Sincronização de pagamentos e transações	Uma fatura paga no WHMCS muda o espelho no Perfex para Paga, com o gateway e o ID da transação registrados
🛒 Sincronização de pedidos	Um pedido do WHMCS vira um lead do Perfex, ou uma nota no cliente, ou nada, como você preferir
🎫 Sincronização de tickets de suporte	Tickets, respostas e mudanças de status circulam nos dois sentidos, com tarefas opcionais do Perfex por ticket para as timesheets
🌐 Painel de serviços e domínios	Uma aba WHMCS em todo perfil de cliente do Perfex, listando os serviços e domínios daquele cliente
⏬ Assistente de backfill	Importa os seus clientes, faturas, serviços e domínios já existentes, não apenas a atividade nova
🗂️ Menus de mapeamento de departamentos	Mapeia os departamentos de tickets do WHMCS para departamentos do Perfex escolhendo numa lista, em vez de digitar IDs

A comparação completa lado a lado está na tabela Free vs Pro.

A licença fica apenas do lado do WHMCS

O complemento do Perfex é gratuito e nunca guarda uma chave. O addon do WHMCS decide o plano e informa ao Perfex qual é ele, para que a página de configurações do Perfex possa explicar por que a sincronização bidirecional está ou não em funcionamento. A sua chave de licença em si nunca trafega até o Perfex.

Comprar o Pro: a sobreposição de checkout

Este é o caminho rápido, e ele não exige nenhuma cópia e cola.

1. Em qualquer uma das páginas administrativas, clique num link de upgrade:
   • WHMCS: Addons > Perfex CRM Bridge. O link aparece como Buy a Pro licence ao lado da caixa Pro License Key, e como Upgrade to Pro na linha da checklist referente à licença e nas caixas de destaque do Pro.
   • Perfex: Setup > WHMCS Bridge, painel WHMCS plan, botão Upgrade to Pro.
2. Uma sobreposição de checkout segura abre ali mesmo, por cima da página em que você já estava.
3. Conclua a compra.
4. A ativação acontece automaticamente:
   • Iniciada pelo WHMCS: a chave de licença vinda da resposta do checkout é escrita na própria caixa Pro License Key do formulário de configurações, e esse formulário é enviado por você. O salvamento verifica a chave ao vivo, muda o plano para Pro e avisa o lado do Perfex, tudo na mesma requisição.
   • Iniciada pelo Perfex: a chave é repassada à sua instalação do WHMCS pelo canal assinado da ponte. O WHMCS verifica a chave ao vivo antes de armazenar qualquer coisa, ativa o Pro e devolve imediatamente o novo estado do plano, de modo que o painel de plano do Perfex muda para Pro no lugar, sem recarregar. O Perfex nunca armazena a chave.
5. O Pro entra em funcionamento imediatamente. Não é preciso esperar uma execução do cron, nem digitar nada.

A sobreposição é um aprimoramento, não uma dependência

Se o script da sobreposição for bloqueado por uma extensão do navegador, por uma política de segurança de conteúdo restritiva ou por uma rede lenta, o link simplesmente se comporta como sempre e abre a página de checkout hospedada numa nova aba. Nada quebra; você apenas conclui com a colagem manual descrita abaixo.

Se o navegador fechou antes de a ativação terminar

Você continua com a sua chave. Duas redes de proteção, nesta ordem:

1. Na página. Se a compra foi concluída, mas a ativação automática não pôde ser executada, a chave é exibida na página num campo selecionável, com um botão Copy do lado do Perfex, e com instruções exatas sobre onde colá-la. Uma chave paga nunca existe apenas dentro de uma sobreposição fechada.
2. Na sua caixa de entrada. A chave é sempre enviada por e-mail no momento da compra, e também fica disponível no seu portal de cliente do provedor de pagamentos. Se o navegador travou na hora errada, confira o seu e-mail.

Depois siga o caminho manual abaixo.

Ativar uma chave manualmente

Use este caminho sempre que você já tiver uma chave: do e-mail de compra, do seu portal de cliente, ou quando estiver movendo uma licença para outra instalação do WHMCS.

1. No WHMCS, abra Addons > Perfex CRM Bridge.
2. Role até Settings > Pro licence.
3. Cole a chave em Pro License Key. As chaves começam com sk_.
4. Clique em Save Settings.

Essa é toda a ativação. Salvar uma chave que realmente mudou dispara a verificação ao vivo na hora, de modo que a página já volta mostrando o seu plano. Você não precisa pressionar mais nada, nem esperar uma execução do cron.

O aviso lhe diz exatamente uma de três coisas:

Aviso	Significado	O que fazer
🟢 Verde - "Settings saved. Licence verified - your Pro plan is active..."	O servidor de licenças confirmou a chave. O cabeçalho da página e a linha License / plan da checklist já indicam Pro, as caixas de destaque do Pro desapareceram e o assistente de backfill está desbloqueado.	Nada. Terminou.
🔴 Vermelho - "Settings saved. The licence server rejected this key..."	A chave foi recusada, e a mensagem indica o motivo dado pelo próprio servidor: chave desconhecida, assinatura expirada, licença cancelada ou cota de ativações já esgotada.	Confira se a chave foi colada exatamente como aparece no e-mail de compra, sem caracteres faltando ou sobrando, e salve novamente.
🟠 Âmbar - "Settings saved. Could not reach the licence server..."	Nem aprovação nem recusa: o seu servidor não conseguiu alcançar o serviço de licenciamento neste momento.	A chave está salva e as tentativas continuam automaticamente. Verifique se o seu servidor consegue alcançar api.freemius.com por HTTPS e depois clique em Check licence now. O período de carência protege você enquanto isso.

"Settings saved." é sempre verdade, seja qual for a cor

As configurações são gravadas no banco de dados antes de qualquer verificação de licença, portanto um aviso vermelho nunca significa "o seu salvamento falhou". Ele significa "salvo, e a sua chave foi recusada". Você nunca precisa redigitar o formulário.

Salvar configurações não relacionadas não custa nada

Somente uma chave de licença que realmente mudou dispara uma verificação. Pausar a sincronização, mudar o destino dos pedidos ou editar o administrador de resposta de tickets não faz nenhuma chamada de rede, e o aviso continua sendo um simples "Settings saved."

Check licence now

O botão Check licence now fica no topo da página do módulo no WHMCS, ao lado de Test Connection e Run Sync Now.

Ele força uma reverificação imediata da chave já armazenada, ignorando o limite de uma verificação por dia. Use-o quando:

• você acabou de renovar ou estender a sua licença e quer o Pro de volta imediatamente;
• um salvamento voltou em âmbar e você já corrigiu o problema de rede ou de firewall;
• você quer confirmar o estado atual antes de abrir um ticket de suporte.

O botão tem um curto intervalo anticlique duplo de alguns segundos. Pressione-o duas vezes seguidas e a segunda vez responde "checked a moment ago" sem enviar uma segunda requisição. Espere alguns segundos e ele verifica normalmente de novo.

Sem nenhuma chave armazenada, o botão responde com um aviso vermelho dizendo que a chave está vazia e que a instalação está no plano Free. Nenhuma requisição sai do seu servidor.

Manter-se ativado: reverificação diária e o período de carência de 14 dias

Uma vez armazenada a chave, o cron do WHMCS a revalida uma vez por dia. Você não precisa fazer nada.

Se o serviço de licenciamento não puder ser alcançado, o módulo não desliga o seu Pro. Esse caso é lido como "não sabemos", nunca como "recusado", e um período de carência de 14 dias mantém o Pro funcionando plenamente enquanto ele tenta de novo.

Três detalhes que vale a pena conhecer:

• O relógio da carência conta a partir da última verificação bem-sucedida, e não da última tentativa. A contagem regressiva exibida na página é de dias realmente restantes, e ela não se reinicia a cada tentativa que falha.
• Uma recusa real encerra a carência imediatamente. Se o servidor de licenciamento afirmar ativamente que a licença está expirada, cancelada ou inválida, isso é uma resposta, e a carência não se aplica. Bloquear o endpoint de licenciamento no seu firewall não mantém viva uma licença revogada.
• A carência estende, nunca inicia. Uma chave que nunca foi confirmada uma única vez não tem carência para se apoiar. Se você colar uma chave novinha enquanto o serviço de licenciamento estiver inacessível, a chave é armazenada e reprocessada, mas o Pro não é ativado até que uma verificação realmente tenha sucesso.

Estados de plano que você pode ver no cabeçalho da página

Texto do cabeçalho	Significado
Free plan - no licence key set.	Nenhuma chave. Este é o plano Free, funcionando normalmente.
Pro license set - awaiting first verification.	Há uma chave armazenada, mas ela nunca foi confirmada. Clique em Check licence now.
Pro active until YYYY-MM-DD (UTC)	Está tudo certo.
Pro active - lifetime licence	Uma licença sem data de expiração.
Pro (grace) - could not reach the licence server, retrying daily. Pro keeps working for N more day(s).	Indisponibilidade temporária. Nada está quebrado para você ainda.
Free plan - this licence has expired.	Renove e depois clique em Check licence now.
Free plan - this licence was cancelled.	A licença foi cancelada ou reembolsada. Fale com o suporte se isso for um engano.
Free plan - the licence key was rejected.	Chave errada, ou a cota de ativações está esgotada. A mensagem traz o texto do próprio servidor.
Free plan - the licence server could not be reached and the grace period has run out.	Corrija a conectividade com o endpoint de licenciamento e depois clique em Check licence now.

A mesma frase aparece na linha License / plan da setup checklist, portanto você nunca precisa caçá-la.

Slots de ativação

Uma instalação do WHMCS consome um slot de ativação da sua licença. O módulo gera um identificador estável uma única vez e o reutiliza para sempre, portanto reverificar, salvar de novo ou mover o seu site para outro domínio nunca queima um segundo slot.

Se você vir uma recusa mencionando que a licença já está em uso no número máximo de instalações, remova a chave da instalação que não precisa mais dela, o que libera o slot imediatamente, ou fale com o suporte sobre a sua cota.

Remover uma chave e voltar para o Free

1. No WHMCS, abra Addons > Perfex CRM Bridge > Settings > Pro licence.
2. Marque Remove the stored key (revert to Free).
3. Clique em Save Settings.

O que acontece:

• A instalação volta para o Free imediatamente, independentemente do que ainda esteja em cache. Os recursos Pro param.
• O slot de ativação é liberado, para que a licença possa ser ativada em outra instalação.
• O lado do Perfex é avisado do downgrade, para que o painel WHMCS plan dele não continue anunciando o Pro pelo resto do dia.

Remova a chave antes de migrar ou desativar um site

Se você apagar uma instalação do WHMCS sem remover a chave antes, o slot de ativação dela continua consumido. Remover a chave leva cinco segundos e evita uma ida e volta com o suporte depois.

O que acontece com os seus dados quando o Pro termina

Nada é apagado. Numa instalação Free:

• A sincronização de clientes e contatos continua funcionando, em um único sentido, exatamente como sempre funcionou.
• O WHMCS para de colocar em fila eventos de faturas, pagamentos, pedidos, serviços, domínios e tickets. A barreira fica na origem, portanto nada se acumula e nada é reprocessado inutilmente.
• As alterações do lado do Perfex que já estavam na fila para o WHMCS são recusadas com uma mensagem clara, "Two-way sync requires Pro on the WHMCS side", no painel Outbound queue, são reprocessadas e acabam indo para dead-letter.
• Tudo o que já foi sincronizado permanece no Perfex. A aba WHMCS nos perfis de clientes continua exibindo os últimos snapshots armazenados; ela apenas deixa de ser atualizada.

Reative uma chave válida e tudo volta a funcionar no próximo evento.

Solução de problemas de licenciamento

Sintoma	Causa	Solução
Salvar uma chave não produz nenhum efeito visível	Você colou a mesma chave que já estava armazenada. Somente uma chave alterada dispara uma verificação.	Clique em Check licence now.
O aviso fica âmbar todas as vezes	O seu servidor não consegue alcançar o endpoint de licenciamento por HTTPS.	Libere HTTPS de saída para api.freemius.com em qualquer firewall de saída ou proxy no servidor do WHMCS. Depois clique em Check licence now.
"The licence key was rejected" com uma chave aparentemente correta	Uma colagem truncada, ou a cota de ativações está esgotada.	Copie a chave do e-mail de compra de uma vez só. As chaves têm 32 caracteres e podem conter pontuação, portanto não corte nada. Se a mensagem mencionar instalações, libere um slot.
O Perfex ainda mostra Free depois de o WHMCS mostrar Pro	O estado do plano ainda não tinha chegado ao Perfex.	Clique em Check licence now ou em Test Connection no WHMCS; os dois entregam o estado do plano ao Perfex na hora. Recarregue a página de configurações do Perfex.
O painel de plano do Perfex diz Unknown	O lado do WHMCS nunca reportou, ou não reporta há muito tempo.	Clique em Test Connection no WHMCS e depois recarregue a página do Perfex. Se continuar Unknown, o cron do WHMCS pode ter parado, ou os dois lados não estão mais emparelhados.

Mais detalhes em Solução de problemas.