Troubleshooting

Guia pra diagnosticar respostas de erro comuns do sistema de licencas, trial e checkout. Se apos seguir as acoes aqui o problema persistir, abra ticket em suporte@noovichat.com.

`status=suspect_multiple_ip`

Sua instancia foi detectada heartbeating a partir de 3+ IPs diferentes nos ultimos 7 dias. O sistema bloqueia temporariamente como protecao contra extracao de license_key pra outros servidores.

Quando acontece legitimamente

Redeploy da VPS em provedor diferente em curto periodo (muda IP publico)
Mudanca de datacenter ou region do seu provedor
Falha de roteador/firewall que te jogou em NAT diferente
VPN em frente ao Docker host (raro em producao)

O que fazer

Confira seu instance_id em /app/config/instance.json (ou equivalente no stack)
Contate suporte com: license_key (somente prefixo tipo NOOVI-XXXX-...), motivo real da mudanca de IP, e IP atual atual (curl ifconfig.me).
Admin de suporte valida e libera via /admin/security

Para prevenir

Evite reiniciar NooviChat em servidores diferentes sem antes fazer desregistro da instancia antiga via POST /api/v1/licenses/deregister (enviando instance_id). Isso limpa o ip_address e nao dispara ip_mismatch no proximo heartbeat.

`status=domain_trial_used`

O dominio que voce configurou ja foi usado em um trial anterior (seu ou de outro cliente). Trial e 1 por dominio forever — nao e possivel reativar.

O que fazer

Ativar uma licenca NooviChat: noovichat.com/pricing
OU usar outro dominio ainda nao testado (ex: beta.minhaempresa.com em vez do app.minhaempresa.com ja utilizado)

`status=instance_limit_reached`

Seu plano tem um limite de instancias simultaneas:

Trial / Mensal: 1 VPS
Semestral: 3 VPS
Anual: 10 VPS

Voce tem mais instancias ativas do que seu plano permite. Ativa = enviou heartbeat nos ultimos 15 minutos.

O que fazer

Desligue ou desregistre instancias antigas que nao precisa mais
OU fazer upgrade do plano: upgrade aqui

Para desregistrar manualmente:

bash

curl -X POST "https://api.noovichat.com/api/v1/licenses/deregister" \
  -H "Content-Type: application/json" \
  -d '{
    "license_key": "NOOVI-XXXX-XXXX-XXXX-XXXX",
    "instance_id": "uuid-da-instancia-antiga"
  }'

`error=disposable_email_blocked`

Voce tentou ativar um trial com email de provedor temporario (yopmail, mailinator, 10minutemail, guerrillamail, etc.). Bloqueamos esses provedores pra prevenir abuse do trial gratuito.

O que fazer

Use um email comercial (nome@suaempresa.com) ou pessoal permanente (Gmail, Outlook, ProtonMail, iCloud). Se usa um provedor comercial legitimo e recebeu esse erro, reporte parasuporte@noovichat.com pra revisao.

`error=self_coupon_not_allowed`

Voce tentou aplicar um cupom criado pela propria conta autenticada. Admins e staff nao podem usar proprios cupons — o sistema impede pra evitar auto-desconto.

O que fazer

Use um cupom criado por outro admin
OU utilize um codigo de indicacao (referral) de outro cliente
OU faca checkout sem cupom (o sistema ignora silenciosamente)

Heartbeat offline / grace period

Se o NooviChat nao consegue contatar api.noovichat.com, ele entra em grace period: funciona normalmente por ate 72h antes de bloquear.

Possiveis causas

Firewall do cliente bloqueia saida para api.noovichat.com:443
DNS quebrado no servidor da instalacao
Cert TLS expirado no SO antigo (raro)
Rede do provedor com problema

Como diagnosticar

bash

# de dentro da VPS do NooviChat
curl -v https://api.noovichat.com/health
# deve retornar {"status":"ok"}

# DNS
nslookup api.noovichat.com

# firewall saida (Debian/Ubuntu)
sudo iptables -L OUTPUT -v | head