Risolvi problemi comuni
Soluzioni ai problemi più frequenti con NexusPass: bot che non risponde, ruoli non assegnati, errori webhook e molto altro.
wrangler tail discord-interactions e wrangler tail stripe-webhook-handler. Nella maggior parte dei casi l'errore è chiaramente indicato nel log.?Il bot non risponde al comando slash
Cause possibili
- Il comando non è stato registrato sul server
- L'Interactions Endpoint URL non è impostato correttamente nel Developer Portal
- La Public Key nel DB è errata
- Il Worker di NexusPass è offline
Come risolvere
Verifica che il comando sia registrato: vai su Discord Developer Portal → la tua app → sezione "Bot" → cerca i comandi registrati
Controlla l'Interactions Endpoint URL: Developer Portal → General Information → deve essere l'URL del tuo Worker NexusPass
Verifica la Public Key nel DB: deve corrispondere esattamente al valore in Developer Portal → General Information → Public Key
Testa il Worker: apri l'URL direttamente nel browser, deve rispondere con "Method Not Allowed"
?Il pagamento è andato a buon fine ma il ruolo non è stato assegnato
Cause possibili
- Il webhook Stripe non è configurato o non sta chiamando NexusPass
- Il bot token nel DB è scaduto o errato
- Il bot non ha il permesso "Manage Roles"
- Il ruolo del bot è più basso del ruolo da assegnare nella gerarchia
Come risolvere
Controlla i log webhook su Stripe: Dashboard → Developers → Webhooks → il tuo endpoint → Events. Cerca errori 4xx o 5xx.
Verifica il bot token: nelle impostazioni del server su NexusPass aggiorna il bot token con uno nuovo dal Developer Portal.
Controlla i permessi: nel server Discord → Impostazioni → Ruoli → trova il ruolo del bot → deve avere "Gestisci Ruoli" attivo.
Controlla la gerarchia: il ruolo del bot deve essere più in alto dei ruoli che deve assegnare. Vai su Impostazioni → Ruoli e trascina il ruolo del bot in cima.
?Il webhook Stripe restituisce errore 401
Cause possibili
- Il Stripe Webhook Secret (whsec_xxx) è errato o mancante
- Il secret è stato rigenerato su Stripe ma non aggiornato su NexusPass
Come risolvere
Vai su Stripe → Developers → Webhooks → il tuo endpoint → Signing secret → Reveal. Copia il valore.
Vai su NexusPass → Servers → il tuo server → Impostazioni → Stripe Webhook Secret. Incolla il nuovo valore e salva.
?Errore "Limite raggiunto" quando aggiungo un server o prodotto
Cause possibili
- Hai raggiunto il limite del tuo piano attuale
Come risolvere
Vai su NexusPass → Pricing e upgradia al piano superiore.
Se sei già su Agency (illimitato) e vedi questo errore, contatta il supporto.
?Il comando slash non appare nel server
Cause possibili
- Il comando è stato registrato come globale invece che sul guild specifico
- I comandi globali richiedono fino a 1 ora di propagazione
- Il bot non è stato invitato con lo scope "applications.commands"
Come risolvere
NexusPass registra i comandi a livello di guild (istantaneo). Se non vedi il comando, aspetta 1-2 minuti e riavvia il client Discord.
Verifica che il bot sia stato invitato con lo scope "applications.commands". Se non lo è, genera un nuovo link OAuth2 con questo scope e reinvita il bot.
Prova a digitare "/" nel campo testo: se il comando non appare, il bot probabilmente non ha i permessi per quel canale.
?L'utente vede "L'applicazione non ha risposto" dopo il comando
Cause possibili
- Il Worker non risponde entro 3 secondi (timeout Discord)
- La query al database è troppo lenta
- Il Worker è in cold start
Come risolvere
Questo errore è spesso temporaneo — riprova il comando. Se persiste, controlla i log del Worker con "wrangler tail discord-interactions".
Verifica che Supabase risponda correttamente: controlla la sezione Database nel dashboard Supabase.
I Cloudflare Workers in piano gratuito hanno cold start. Considera il piano Workers Paid per eliminare il problema.
Problema non risolto?
Entra nel nostro Discord e descivi il problema nel canale #supporto. Includi i log del Worker e il tipo di errore.
Entra nel Discord →