NexusSegurança e troubleshooting
Diagnosticar erros comuns
Identifique problemas de conexão, permissão, envio e recebimento.
Para integrações, use o identificador de correlação para localizar a etapa que falhou. No painel, o estado Conectado não substitui a confirmação de uma mensagem real.
| Sintoma | Verifique primeiro | Próxima ação segura |
|---|---|---|
401 | Scheme, credencial e ambiente | Gere ou rotacione pelo fluxo autorizado |
403 | Escopo, conta e vínculo do chip | Corrija a permissão sem ampliar acesso global |
404 | Identificador, conta e versão da rota | Não tente identificadores de outro ambiente |
409 | Estado ou idempotência | Consulte a operação existente antes de repetir |
400 | Formato, telefone e campos obrigatórios | Corrija a requisição conforme a referência da API |
5xx | Correlação, conexão e logs sanitizados | Não faça tentativas infinitas nem novo disparo |
| Conectado sem entrega | Destino, subconta, canal e histórico | Faça um único teste controlado |
| QR expirado | Tela de conexão do chip | Gere outro QR sem criar um chip duplicado |
| Conexão caiu | Estado do chip e celular vinculado | Use Reconectar e confirme uma mensagem real |
Evidência mínima
Registre horário, ambiente, operação, operationId, correlação e status. Remova credenciais, telefones, conteúdo de mensagens e dados de clientes.