Troubleshooting & FAQ
Errori comuni dell'Operator SDK (microfono, WebSocket, token) con i relativi codici, e risposte alle domande frequenti.
Questa pagina raccoglie gli errori più comuni con i loro codici e le domande ricorrenti sull'Operator SDK.
Errori comuni
Gli errori non fatali arrivano sull'evento error come OperatorError
({ code, message, cause? }). Sottoscrivilo sempre durante lo sviluppo:
op.on("error", (e) => console.error(e.code, e.message, e.cause));| Codice | Significato | Cosa fare |
|---|---|---|
MIC_PERMISSION_DENIED | Il browser o il sistema operativo ha negato l'accesso al microfono. | Verifica i permessi del sito nel browser e nelle impostazioni del SO. La pagina deve essere su HTTPS (o localhost). Vedi Audio & microfono. |
WS_ERROR | Errore sul canale WebSocket (presenza o audio). | Controlla la connettività di rete e che coreUrl sia corretto. L'SDK tenta la riconnessione automatica del canale di presenza (backoff configurabile). |
UNAUTHORIZED | Token di sessione non valido in modo persistente (401). | Assicurati che getToken restituisca sempre un token fresco; verifica l'endpoint backend e l'X-API-Key. Vedi Token flow. |
REQUEST_FAILED | Errore di rete o di risposta su una richiesta dell'SDK (es. listPhoneNumbers). | Verifica la connettività e che coreUrl (core.audin.ai) sia raggiungibile dal browser: le richieste dell'SDK usano lo stesso servizio dei WebSocket, non l'endpoint del tuo backend. |
UNAUTHORIZED e REQUEST_FAILED sono anche i codici di OperatorRequestError
lanciato da listPhoneNumbers() su un fallimento persistente (vedi
Numeri & presenza).
Non si sente audio
Se l'operatore o la controparte non si sentono, segui la procedura di diagnosi
passo-passo nella pagina Audio & microfono:
permessi microfono (OS + browser), device corretto via setAudioConstraints,
stato di mute, contesto sicuro (HTTPS) e gesto utente per sbloccare l'audio.
Il token scade / errore 401
Il token di sessione vive circa un'ora. L'SDK richiama getToken ogni volta
che serve un token nuovo — alla connessione, a ogni riconnessione e all'apertura
del canale audio di una chiamata. Se vedi errori 401 / UNAUTHORIZED:
- Assicurati che la tua callback
getTokenrecuperi sempre un token fresco e non restituisca un token scaduto messo in cache. - Verifica che il tuo endpoint backend autentichi correttamente con l'header
X-API-Keyversohttps://api.audin.ai/operator-sessions/token.
Dettagli completi nella pagina Token flow & setup backend.