NooviChatDocs

Troubleshooting

Guia pra diagnosticar respostas de erro comuns do sistema de licenças, trial e checkout. Se após seguir as ações aqui o problema persistir, abra ticket em suporte@noovichat.com.

status=suspect_multiple_ip

Sua instância foi detectada heartbeating a partir de 3+ IPs diferentes nos últimos 7 dias. O sistema bloqueia temporariamente como proteção contra extração de license_key pra outros servidores.

Quando acontece legitimamente

  • Redeploy da VPS em provedor diferente em curto período (muda IP público)
  • Mudança 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 produção)

O que fazer

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

Para prevenir

Evite reiniciar NooviChat em servidores diferentes sem antes fazer desregistro da instância antiga via POST /api/v1/licenses/deregister (enviando instance_id). Isso limpa o ip_address e não dispara ip_mismatch no próximo heartbeat.

status=domain_trial_used

O domínio que você configurou já foi usado em um trial anterior (seu ou de outro cliente). Trial é 1 por domínio forever — não é possível reativar.

O que fazer

  • Ativar uma licença NooviChat: noovichat.com/pricing
  • OU usar outro domínio ainda não testado (ex: beta.minhaempresa.com em vez do app.minhaempresa.com já utilizado)

status=instance_limit_reached

Seu plano tem um limite de instâncias simultâneas:

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

Você tem mais instâncias ativas do que seu plano permite. Ativa = enviou heartbeat nos últimos 15 minutos.

O que fazer

  1. Desligue ou desregistre instâncias antigas de que não precisa mais
  2. OU faça 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

Você tentou ativar um trial com email de provedor temporário (yopmail, mailinator, 10minutemail, guerrillamail, etc.). Bloqueamos esses provedores pra prevenir abuso 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 legítimo e recebeu esse erro, reporte parasuporte@noovichat.com pra revisão.

error=self_coupon_not_allowed

Você tentou aplicar um cupom criado pela própria conta autenticada. Admins e staff não podem usar próprios cupons — o sistema impede pra evitar auto-desconto.

O que fazer

  • Use um cupom criado por outro admin
  • OU utilize um código de indicação (referral) de outro cliente
  • OU faça checkout sem cupom (o sistema ignora silenciosamente)

Heartbeat offline / grace period

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

Possíveis causas

  • Firewall do cliente bloqueia saída para api.noovichat.com:443
  • DNS quebrado no servidor da instalação
  • 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