A conexão com o painel é testada quando você adiciona o painel, quando clica em Test Connection e, automaticamente, mais ou menos a cada 30 minutos. Quando ela falha, o portal explica o problema em palavras simples. Este guia lista essas mensagens e o que fazer em cada caso.

1Step 1 of 3Encontre a mensagem

Ao adicionar um painel: a mensagem começa com Panel not saved (painel não salvo). Nada foi salvo, então corrija o dado e adicione o painel de novo.
Para um painel que você já adicionou: acesse Panels → All panels. O card de um painel com falha tem borda vermelha e o rótulo Connection problem, um título curto (por exemplo XUI is blocking our servers), a causa e os passos para corrigir. A mensagem do próprio painel fica em Raw error.

2Step 2 of 3Corrija a causa

Procure o título na lista abaixo. Na maioria dos casos, a solução é uma configuração do lado do painel ou um dado nas configurações do painel aqui. Para alterar o endereço, o login ou a chave, clique em Manage no painel e depois em Fix connection settings (ou Edit). Altere o campo e clique em Save Changes.

3Step 3 of 3Teste novamente

Na página do painel, clique em Test Connection. Em Connection Status, os cards API Authentication e Browser Automation têm cada um o seu próprio botão Test (em um painel que usa apenas o login pelo navegador, o botão se chama Test & fetch packages). Quando o teste passa, o erro do painel desaparece. Os pedidos que falharam enquanto o painel estava fora do ar são tentados de novo automaticamente; para os que sobrarem, veja Corrigir pedidos travados no painel.

Mensagens e o que fazer

"… is blocking our servers" (o painel bloqueia nossos servidores)

O painel, ou o Cloudflare ou um firewall na frente dele, recusa as requisições dos nossos servidores. Libere os endereços dos nossos servidores no firewall do painel ou no Cloudflare, e também na lista de IPs permitidos do próprio painel, se ele tiver uma. No Cloudflare, isso fica em Security → WAF → Tools → IP Access Rules → Allow. Se o Bot Fight Mode ou o modo Under Attack do Cloudflare estiver ativado, adicione uma regra que pule esses modos para o endereço da API do painel.

Os endereços a liberar aparecem nos passos do card de um painel com falha e na mensagem Panel not saved quando um painel bloqueado não pode ser adicionado. Para um painel NXT, eles também estão na página Edit dele: em Cloudflare / Captcha Protection, clique em Show. Você também pode pedir os endereços em Help → Contact platform support. Se você é revendedor e não tem acesso às configurações do painel, envie os endereços ao fornecedor do seu painel.

"The address of … cannot be found", "Nothing answers at the saved … address" ou "We could not reach that … address" (endereço errado)

O endereço salvo está errado: um erro de digitação, uma porta faltando, http em vez de https (ou o contrário), ou uma página de login ou de dashboard em vez da raiz do painel. Abra o painel no seu próprio navegador e copie o endereço exatamente: http:// ou https://, o host e a porta, por exemplo https://panel.example.com:8080. Não inclua caminhos como /login ou /dashboard. Uma exceção: em um painel NXT em que o login fica em /login/<your name>, cole esse endereço do jeito que está.

Se o endereço funciona no seu navegador, mas mesmo assim não conseguimos acessá-lo, o painel provavelmente está bloqueando nossos servidores (veja acima).

"That address is a web page, not the … API" ou "No … login form at that address" (endereço ou tipo de painel errado)

O endereço abre uma página web, mas não é a parte do painel de que precisamos, ou é um tipo de painel diferente do que você escolheu.

Para o NXT, use o endereço em que você faz login como revendedor: a API responde nesse mesmo endereço.
Para a API do XUI, use o endereço da API que o fornecedor do seu painel passou. Ele pode ser diferente da página em que você faz login.
Para painéis com login pelo navegador, use o endereço da página de login.
Não sabe qual é o tipo do seu painel? Em Panels → All panels, clique em Detect my panel. Se você escolheu um tipo que não corresponde a um endereço de painel conhecido, a mensagem diz qual tipo escolher.

"… rejects the login" ou "… rejected the request" (login ou requisição recusados)

O usuário, a senha ou a chave de API salvos aqui não são mais aceitos, ou a conta de revendedor não tem permissão de API. Entre no painel você mesmo com o mesmo login para conferir se ele ainda funciona. Se o painel usa uma chave de API, crie uma nova lá. Depois, salve aqui o login ou a chave que funciona.

No NXT, o API Token é necessário para a API. Sem ele, o painel recusa a própria API.

No Activation Panel, isso aparece como Activation Panel returned status=error: copie a Reseller API Key de novo e confira se o endereço termina em /api/api.php. Veja Como conectar um Activation Panel.

"… shows a captcha on login" (captcha no login)

O painel pede um captcha antes do login. Adicione sua chave do 2Captcha em Panels → Captcha for panel login. Sem uma chave própria, cada captcha que resolvemos custa €0.05 do seu crédito na plataforma.

"… sits behind an extra password prompt" (senha extra antes do login)

Uma janela de senha do servidor web aparece antes da página de login do painel. Abra as configurações do painel, marque This panel is behind an nginx / login gate e informe esse usuário e essa senha. Ou use o endereço do painel que abre a página de login diretamente, sem a janela. O seu fornecedor pode dizer qual é.

"… asks for a two-factor code" (código de dois fatores)

Se o login de revendedor pede um código de uso único, o login automático para aí. A solução mais simples é um login de revendedor separado para a sua loja, sem verificação em duas etapas.

"… has a certificate problem" (problema de certificado)

O certificado https do painel é inválido, expirou ou é autoassinado. Se o painel normalmente é acessado por http simples, salve o endereço com http://. Caso contrário, o certificado precisa ser renovado no painel, por você ou pelo seu fornecedor.

"… refuses the connection" ou "… does not answer in time" (conexão recusada ou sem resposta)

Nada responde nessa porta, ou o painel está muito lento. Confira a porta no endereço salvo e abra o painel no navegador para ver se ele está no ar. Se funciona para você, mas não para nós, o painel pode estar bloqueando nossos servidores.

"… is temporarily unavailable" ou "… answered with an internal error" (painel indisponível ou com erro)

O próprio painel está com uma queda ou um erro (HTTP 500, 502, 503 ou 504). O problema está do lado do painel. Aguarde um pouco: as verificações continuam sozinhas e o alerta some no primeiro sucesso. Se durar horas, fale com o fornecedor do seu painel.

"…: your reseller account is out of credits" (conta de revendedor sem créditos)

O painel se recusa a criar ou estender linhas até você recarregar seus créditos com o fornecedor do painel. Os pedidos que falharam por esse motivo são tentados de novo assim que houver créditos.

"This failed on our side, not yours" (falha do nosso lado, não do seu)

A parte do nosso sistema que faz login nos painéis estava reiniciando naquele momento. Tente de novo em um minuto; não é preciso mudar nada.

Ainda com problemas?

Envie para nós o tipo de painel e o texto de Raw error em Help → Contact platform support. Se o seu painel nem aparece na lista, use Request a panel no final de Add New Panel.

Como corrigir um painel que não conecta