Risoluzione dei problemi relativi ai codici di risposta di fine chiamata per l'SDK di chiamata, SDK di automazione chiamate, PSTN, SDK di chat e SDK di SMS
Questo articolo descrive la risoluzione dei problemi relativi ai codici di risposta di fine chiamata per SDK di chiamata, SDK di automazione chiamate e Chiamate PSTN.
Suggerimenti per la risoluzione dei problemi
Quando si esegue la risoluzione dei problemi, considerare i suggerimenti seguenti:
- L'applicazione non riceve un evento
IncomingCall Event Grid
: assicurarsi che l'endpoint dell'applicazione sia convalidato con Griglia di eventi durante la creazione di una sottoscrizione di eventi. Lo stato del provisioning per la sottoscrizione di eventi viene contrassegnato come completato se la convalida ha avuto esito positivo. - Per l'errore
The field CallbackUri is invalid
: l'automazione delle chiamate non supporta gli endpoint HTTP. Assicurarsi che l'URL di callback fornito supporti HTTPS. - L'azione
PlayAudio
non riproduce nulla: attualmente è supportato solo il formato file Wave (.wav) per i file audio. Il contenuto audio nel file Wave deve essere mono (canale singolo), con campionamento a 16 bit e una frequenza di campionamento di 16.000 (16 KHz). - Le azioni sugli endpoint PSTN non funzionano: per
CreateCall
,Transfer
,AddParticipant
eRedirect
per chiamare numeri di telefono, è necessario impostareSourceCallerId
nella richiesta di azione. A meno che non si usi il routing diretto, l'ID chiamante di origine deve essere un numero di telefono di proprietà della risorsa di Servizi di comunicazione affinché l'azione abbia esito positivo.
Per altre informazioni sui problemi rilevati dal team del prodotto, vedere Problemi noti.
Nota
Le categorie di messaggi e risultati elencate nelle tabelle seguenti sono in anteprima pubblica. Per altre informazioni, vedere le Condizioni supplementari per l'uso delle anteprime di Microsoft Azure.
Informazioni sui codici di chiamata e sugli errori dei codici secondari
Codici di errore, codici secondari e categorie di risultati corrispondenti consentono agli sviluppatori di identificare e diagnosticare gli errori. Questi codici di errore vengono esposti tramite la proprietà call.callEndReason
al termine di una chiamata.
I dettagli del codice di errore includono:
Codice : sono numeri interi a 3 cifre che rappresentano lo stato di risposta del client o del server. Categorie di codice:
- Risposte riuscite (200-299)
- Errore del client (400-499)
- Errore del server (500-599)
- Errore globale (600-699)
Codice secondario: sono definiti come numero intero, dove ogni numero indica un motivo univoco, specifico per un gruppo di scenari o un risultato specifico dello scenario.
Messaggio: descrive il risultato e fornisce suggerimenti su come attenuare il problema se un risultato è un errore.
ResultCategory: indica il tipo di errore. A seconda del contesto, il valore può essere Success
, ExpectedError
, UnexpectedClientError
o UnexpectedServerError
.
Codici di errore e codici secondari del client SDK per chiamate di Servizi di comunicazione di Azure
Per gli errori del client, se la proprietà resultCategories è ExpectedError
, l'errore è previsto dal punto di vista dell'SDK. Tali errori vengono comunemente rilevati negli errori di precondizione, ad esempio argomenti non corretti passati dall'app o quando lo stato del sistema corrente non consente la chiamata API. L'applicazione deve controllare il motivo dell'errore e la logica per richiamare l'API.
Codice secondario | Codice | Messaggio | Categoria dei risultati | Comunicazione |
---|---|---|---|---|
40101 | 408 | Non è possibile creare CallAgent. Riprovare; se il problema persiste, raccogliere i log della console del browser, il file .HAR e contattare il supporto di Servizi di comunicazione di Azure. |
UnexpectedClientError | |
40104 | 408 | Non è possibile creare CallAgent. Riprovare; se il problema persiste, raccogliere i log della console del browser, il file .HAR e contattare il supporto di Servizi di comunicazione di Azure. |
UnexpectedClientError | |
40114 | 408 | Impossibile connettersi all'infrastruttura di Servizi di comunicazione di Azure. Riprovare e controllare le richieste di rete del browser. Se le richieste continuano a dare esisto negativo, raccogliere i log della console del browser, il file .HAR e contattare il supporto di Servizi di comunicazione di Azure. |
UnexpectedClientError | Per altre informazioni, vedere Requisiti di rete. |
40115 | 412 | Impossibile creare CallAgent. Impossibile inizializzare la connessione all'infrastruttura di Servizi di comunicazione di Azure. Riprovare e controllare le richieste di rete del browser. Se le richieste continuano a dare esisto negativo, raccogliere i log della console del browser, il file .HAR e contattare il supporto di Servizi di comunicazione di Azure. |
UnexpectedClientError | Per altre informazioni, vedere Requisiti di rete. |
40216 | 500 | Non è possibile creare CallAgent. Riprovare, se il problema persiste, raccogliere i log della console del browser e contattare il supporto di Servizi di comunicazione di Azure. | UnexpectedClientError | |
40228 | 409 | Impossibile creare CallAgent. Esiste già un'istanza di CallAgent associata a questa identità. Eliminare l'oggetto CallAgent esistente o crearne uno nuovo con un'identità differente. | ExpectedError | |
40230 | 409 | Impossibile creare TeamsCallAgent. Esiste già un'istanza di TeamsCallAgent associata a questa identità. Eliminare teamsCallAgent esistente prima di crearne uno nuovo. | ExpectedError | |
40606 | 405 | Impossibile enumerare gli altoparlanti, non è supportata l'enumerazione/la selezione degli altoparlanti in Android Chrome, iOS Safari o macOS Safari. | ExpectedError | L'enumerazione/selezione degli altoparlanti non è supportata in Android Chrome, iOS Safari o macOS Safari. Il sistema operativo seleziona automaticamente l'altoparlante (dispositivo di output). Altre informazioni sulla gestione dei dispositivi e su come attenuare al meglio questi problemi. |
40613 | 400 | Non è stato possibile ottenere l'autorizzazione per l'utilizzo del microfono e/o della fotocamera, è stato negato o non è riuscito. Assicurarsi di consentire le autorizzazioni nel browser e nelle impostazioni del sistema operativo. | ExpectedError | Altre informazioni su come gestire al meglio le autorizzazioni dei dispositivi. |
40614 | 500 | Impossibile richiedere le autorizzazioni del dispositivo Verificare di consentire le autorizzazioni nelle impostazioni del browser e nelle impostazioni del sistema operativo e riprovare. Se il problema persiste, raccogliere i log della console del browser e contattare il supporto di Servizi di comunicazione di Azure. | UnexpectedClientError | Altre informazioni su come gestire al meglio le autorizzazioni dei dispositivi. |
41006 | 400 | Non è stato possibile accettare la chiamata in ingresso, non si trova nello stato di squillo. Sottoscrivere l'evento incomingCall di CallAgent per accettare la chiamata in arrivo. |
ExpectedError | Consultare gli articoli seguenti per identificare la causa radice del problema - Ricevere una chiamata in ingresso - Sottoscrivere eventi dell'SDK |
41007 | 400 | Non è stato possibile rifiutare la chiamata in ingresso, non si trova nello stato di squillo. Sottoscrivere l'evento incomingCall di CallAgent per rifiutare la chiamata in arrivo. |
ExpectedError | Consultare gli articoli seguenti per identificare la causa radice del problema - Ricevere una chiamata in ingresso - Sottoscrivere eventi dell'SDK |
41015 | 500 | Impossibile disattivare il microfono. Riprovare; se il problema persiste, raccogliere i log della console del browser e contattare il supporto di Servizi di comunicazione di Azure. | UnexpectedClientError | |
41016 | 400 | Impossibile annullare l'audio del microfono. Riprovare; se il problema persiste, raccogliere i log della console del browser e contattare il supporto di Servizi di comunicazione di Azure. | UnexpectedClientError | |
41025 | 400 | Impossibile avviare il video. L'istanza LocalVideoStream non è valida o vuota. Passare un'istanza LocalVideoStream. | ExpectedError | Assicurarsi che l'oggetto passato per avviare il video sia un'istanza di LocalVideoStream. Costruire un oggetto LocalVideoStream utilizzando un oggetto VideoDeviceInfo o un oggetto MediaStream . Consultare gli articoli seguenti per identificare la causa radice del problema: - Effettuare una chiamata con videocamera - Avviare e interrompere l'invio di un video locale durante una chiamata - Accedere al video non elaborato |
41027 | 400 | Impossibile avviare il video. Il video è già stato avviato. | ExpectedError | Collegamenti utili: - Effettuare una chiamata con videocamera - Avviare e interrompere l'invio di un video locale durante una chiamata |
41030 | 400 | Impossibile arrestare il video. Il video è già stato arrestato. | ExpectedError | Collegamenti utili: - Effettuare una chiamata con videocamera - Avviare e interrompere l'invio di un video locale durante una chiamata |
41032 | 400 | Impossibile arrestare il video, argomento non valido. LocalVideoStream usato come input non viene attualmente inviato. | ExpectedError | LocalVideoStream viene inviato nella chiamata, archiviato nella matrice Call.localVideoStreams[] ed è di tipo Video o RawMedia . Consultare gli articoli seguenti per identificare la causa radice del problema: - Effettuare una chiamata con videocamera - Avviare e interrompere l'invio di un video locale durante una chiamata - Accedere al video non elaborato |
41033 | 500 | Impossibile mettere in attesa la chiamata. Riprovare; se il problema persiste, raccogliere i log della console del browser e contattare il supporto di Servizi di comunicazione di Azure. | UnexpectedClientError | |
41034 | 500 | Impossibile riprendere la chiamata. Riprovare; se il problema persiste, raccogliere i log della console del browser e contattare il supporto di Servizi di comunicazione di Azure. | UnexpectedClientError | |
41035 | 400 | Impossibile avviare la condivisione dello schermo. La condivisione dello schermo è già stata avviata. | ExpectedError | Altre informazioni su come avviare e arrestare la condivisione dello schermo durante una chiamata |
41041 | 400 | Impossibile arrestare la condivisione dello schermo. La condivisione dello schermo è già stata arrestata. | ExpectedError | Altre informazioni su come avviare e arrestare la condivisione dello schermo durante una chiamata |
41048 | 410 | Impossibile avviare video durante il processo di configurazione della chiamata. Assicurarsi di consentire le autorizzazioni video nelle impostazioni del browser e nelle impostazioni del sistema operativo e assicurarsi che il dispositivo fotocamera non venga usato da un altro processo. | UnexpectedClientError | - Il dispositivo fotocamera può essere disabilitato nel sistema. - La fotocamera è in uso in un altro processo. |
41056 | 412 | Impossibile avviare o partecipare alla chiamata. I criteri vocali di Teams Enterprise non sono abilitati per questa risorsa di Servizi di comunicazione di Azure. Seguire l'esercitazione online per abilitarla. | ExpectedError | Vedere come abilitare gli utenti per voip aziendale online e segreteria telefonica del sistema telefonico per abilitare i criteri vocali di Teams Enterprise |
41071 | 412 | Impossibile avviare la condivisione della schermata. La chiamata non è in stato Connesso. Sottoscrivere l'evento stateChanged della chiamata per sapere quando la chiamata è connessa. |
ExpectedError | Collegamenti utili: - Controllare le proprietà di chiamata - Sottoscrivere eventi dell'SDK |
41073 | 412 | Impossibile ottenere o impostare MediaStream personalizzato. Questa funzionalità è attualmente disabilitata da Servizi di comunicazione di Azure. | ExpectedError | |
43000 | 412 | Impossibile avviare il video. Il dispositivo video viene usato da un altro processo/applicazione. Arrestare l'uso della fotocamera nell'altro processo/applicazione e riprovare. | ExpectedError | Altre informazioni su come gestire al meglio una fotocamera usata da un altro processo |
43001 | 403 | Non è stato possibile avviare il video. L'autorizzazione non è stata concessa per l'uso del dispositivo video selezionato. Verificare che le autorizzazioni del dispositivo video siano consentite nelle impostazioni del browser e nelle impostazioni del sistema. | ExpectedError | Verificare che le autorizzazioni della fotocamera siano consentite nelle impostazioni del browser e nelle impostazioni del sistema del dispositivo. Assicurarsi che le fotocamere non siano disabilitate nelle impostazioni del sistema del dispositivo. In macOS, verificare che la registrazione dello schermo sia consentita dalle impostazioni di sistema. Collegamenti utili: - Richiedere le autorizzazioni del dispositivo- Autorizzazioni di condivisione dello schermo in macOS - Enumerazione o accesso ai dispositivi per Safari in macOS e iOS |
43002 | 500 | Impossibile avviare il video, errore sconosciuto. Riprovare. Se il problema persiste, contattare il supporto di Servizi di comunicazione di Azure. | UnexpectedClientError | |
43004 | 400 | Impossibile cambiare il dispositivo video, input non valido. L'input deve essere di tipo VideoDeviceInfo. | ExpectedError | Usare gestione dispositivi per ottenere un elenco di oggetti VideoDeviceInfo e successivamente usare l'oggetto VideoDeviceInfo per cambiare l'origine. Altre informazioni su come avviare e interrompere l'invio di video locali durante una chiamata |
43005 | 400 | Non è stato possibile cambiare dispositivo video, non è possibile andare allo stesso dispositivo video: è già selezionato. | ExpectedError | |
43013 | 412 | Impossibile avviare il video, nessun dispositivo video trovato. Verificare che i dispositivi video siano collegati e abilitati nelle impostazioni di sistema. | ExpectedError | Assicurarsi di avere una fotocamera connessa e installata nel dispositivo. |
43014 | 412 | Impossibile avviare il video. Errore durante la richiesta del flusso multimediale. Riprovare; se il problema persiste, contattare il supporto di Servizi di comunicazione di Azure. | UnexpectedClientError | |
43015 | 412 | Non è stato possibile avviare video, timeout della richiesta di flusso multimediale. Consenti l'autorizzazione al prompt del browser per accedere alla fotocamera e riprovare. | ExpectedError | Questo errore può verificarsi se l'utente non esegue alcuna azione al prompt delle autorizzazioni del browser per consentire l'accesso alla fotocamera. |
43016 | 412 | Impossibile avviare il video, autorizzazioni negate dal sistema. Verificare che le autorizzazioni del dispositivo video siano consentite nelle impostazioni del browser e nelle impostazioni del sistema. | ExpectedError | - Verificare che le autorizzazioni della fotocamera siano consentite nelle impostazioni del browser e nelle impostazioni del sistema del dispositivo. - Assicurarsi che le fotocamere non siano disabilitate nelle impostazioni del sistema del dispositivo. - In macOS, verificare che la registrazione dello schermo sia consentita dalle impostazioni di sistema. Collegamenti utili: - Richiedere le autorizzazioni del dispositivo -Autorizzazioni di condivisione dello schermo in macOS - Enumerazione o accesso ai dispositivi per Safari in macOS e iOS |
43017 | 412 | Impossibile avviare il video, flusso non supportato. Riprovare; se il problema persiste, contattare il supporto di Servizi di comunicazione di Azure. | UnexpectedClientError | |
43018 | 412 | Impossibile avviare il video. Impossibile impostare vincoli. Riprovare; se il problema persiste, contattare il supporto di Servizi di comunicazione di Azure. | UnexpectedClientError | Altre informazioni su come impostare vincoli video |
43019 | 412 | Impossibile avviare il video, nessun dispositivo selezionato. Assicurarsi di passare LocalVideoStream compilato con un VideoDeviceInfo e riprovare. Se il problema persiste, contattare il supporto di Servizi di comunicazione di Azure. | UnexpectedClientError | Collegamenti utili: - Effettuare una chiamata con videocamera - Avviare e interrompere l'invio di un video locale durante una chiamata |
43200 | 412 | Impossibile eseguire il rendering del flusso video. Questo flusso non è disponibile. Sottoscrivere la proprietà isAvailable del flusso per ricevere una notifica quando il partecipante remoto ha il proprio video attivo e il flusso è disponibile per il rendering. | ExpectedError | Collegamenti utili: - Eseguire il rendering dei flussi video/di condivisione dello schermo dei partecipanti remoti - Aggiungere videochiamate 1:1 all'app - Sottoscrivere eventi dell'SDK |
43202 | 404 | Impossibile eseguire il rendering del flusso video. Questo flusso non è più disponibile. Il partecipante remoto ha disattivato il video. | ExpectedError | Il partecipante remoto ha disattivato il video durante il tentativo di creare una visualizzazione. |
43203 | 408 | Impossibile eseguire il rendering del flusso video. Timeout del rendering durante l'attesa dei fotogrammi video. Riprovare; se il problema persiste, contattare il supporto di Servizi di comunicazione di Azure. | UnexpectedClientError | |
43204 | 500 | Impossibile eseguire il rendering del flusso video. Non è stato possibile sottoscrivere video nell'infrastruttura di Servizi di comunicazione di Azure. Riprovare; se il problema persiste, contattare il supporto di Servizi di comunicazione di Azure. | UnexpectedClientError | |
43209 | 405 | Impossibile eseguire il rendering del flusso video. VideoStreamRenderer è stato eliminato durante il processo di inizializzazione. | ExpectedError | |
43210 | 400 | Impossibile eliminare VideoStreamRenderer perché è già stato eliminato. | ExpectedError | |
43220 | 400 | Impossibile creare la visualizzazione, numero massimo di visualizzazioni attive RemoteVideoStream già raggiunte. È possibile eliminarne una precedente per crearne una nuova. |
ExpectedError | Altre informazioni su come supportare correttamente il miglior numero di flussi video in ingresso |
480 | Endpoint client remoto non registrato. | Assicurarsi che l'endpoint remoto sia disponibile. | ||
481 | Non è stato possibile gestire la chiamata in ingresso. | Inviare una richiesta di supporto tramite il portale di Azure. | ||
487 | Chiamata annullata, rifiutata a livello locale, terminata a causa di un problema di corrispondenza dell'endpoint oppure generazione dell'offerta multimediale non riuscita. | Comportamento previsto. | ||
490, 491, 496, 497, 498 | Problemi di rete dell'endpoint locale. | Controllare la rete. | ||
503, 504 | Errore dell'infrastruttura di Servizi di comunicazione. | Inviare una richiesta di supporto tramite il portale di Azure. | ||
600 | Occupato ovunque. Il partecipante è stato contattato correttamente, ma ha restituito un segnale di occupato. | Comportamento previsto. | ||
603 | Chiamata rifiutata a livello globale dal partecipante di Servizi di comunicazione remota. | Comportamento previsto. | ||
604 | Non esiste da nessuna parte. L'URI richiesto non esiste. | Comportamento previsto. | ||
606 | Non accettabile. Il partecipante è stato contattato correttamente, ma non può supportare la sessione descritta. | Comportamento previsto. |
Informazioni sui codici di chiamata e sugli errori dei codici secondari
Codici di errore, codici secondari e categorie di risultati corrispondenti consentono agli sviluppatori di identificare e diagnosticare gli errori. Questi codici di errore vengono esposti tramite la proprietà call.callEndReason
al termine di una chiamata.
I dettagli del codice di errore includono:
Codice : sono numeri interi a 3 cifre che rappresentano lo stato di risposta del client o del server. Categorie di codice:
- Risposte riuscite (200-299)
- Errore del client (400-499)
- Errore del server (500-599)
- Errore globale (600-699)
Codice secondario: sono definiti come numero intero, dove ogni numero indica un motivo univoco, specifico per un gruppo di scenari o un risultato specifico dello scenario.
Messaggio: descrive il risultato e fornisce suggerimenti su come attenuare il problema se un risultato è un errore.
ResultCategory: indica il tipo di errore. A seconda del contesto, il valore può essere Success
, ExpectedError
, UnexpectedClientError
o UnexpectedServerError
.
Chiamata di codici di Termina chiamata e codici secondari
Esistono diverse spiegazioni per il motivo per cui una chiamata è terminata. Ecco i significati della fine dei codici di chiamata e dei codici secondari che mostrano come una chiamata può terminare.
Codice secondario | Codice | Messaggio | Categorie di risultati | Comunicazione |
---|---|---|---|---|
0 | 0 | Chiamata terminata correttamente dal partecipante locale. | Success | |
0 | 487 | La chiamata è stata completata correttamente perché il chiamante ha annullato la chiamata. | Success | |
0 | 603 | La chiamata è stata terminata correttamente perché è stata rifiutata dal chiamato. | Success | Chiamata terminata perché è stata rifiutata dall'utente di destinazione tramite la funzione di rifiuto client SDK, Call Automation, Graph, PSTN o Teams. |
7 | 496 | La chiamata è terminata quando il client ha perso la connessione di rete improvvisamente, e nonostante il tentativo di ripetizione più volte non è stato in grado di connettersi | ExpectedError | Il browser è offline o presenta problemi di rete. Controllare la connessione di rete del browser e riprovare. |
3100 | 410 | L'installazione della chiamata non è riuscita a causa di un problema di rete imprevisto nel client, controllare la rete del client e riprovare. | UnxpectedClientError | Controllare la configurazione di rete, assicurarsi che segua i requisiti di rete per chiamate di comunicazione di Azure. |
3101 | 410 | Chiamata eliminata a causa di un problema di rete imprevisto nel client, controllare la rete del client e riprovare. | UnxpectedClientError | Controllare la configurazione di rete, assicurarsi che segua i requisiti di rete per chiamate di comunicazione di Azure. |
3111 | 410 | Impossibile elaborare l'offerta multimediale durante la connessione della chiamata. | UnxpectedClientError | Riprovare. Se il problema persiste, raccogliere informazioni sulle chiamate, log client, log della console del browser e contattare Servizi di comunicazione di Azure supporto. |
3112 | 410 | L'installazione della chiamata non è riuscita a causa di un problema di configurazione di rete sul lato client, controllare la configurazione di rete del client e riprovare. | ExpectedError | Altre informazioni su una chiamata che terminano con un codice secondario 3112 sono disponibili qui. |
4097 | 0 | Chiamata terminata per tutti gli utenti dall'organizzatore della riunione. | Success | |
4502 | 490 | Chiamata non riuscita a causa di problemi di connettività di rete, il browser non è riuscito a completare la richiesta HTTP di rete. | UnexpectedClientError | Il client non è riuscito a completare la richiesta e la risposta HTTP. Riprovare. Se il problema persiste, raccogliere informazioni sulle chiamate, log client, log della console del browser e contattare Servizi di comunicazione di Azure supporto. |
4506 | 408 | Timeout della chiamata. Controllare se il chiamato ha ricevuto e accettato la chiamata. | UnexpectedClientError | Riprovare. Se il problema persiste, raccogliere informazioni sulle chiamate, log client, log della console del browser e contattare Servizi di comunicazione di Azure supporto. |
4507 | 495 | La chiamata è terminata perché l'applicazione non ha fornito un token valido di Servizi di comunicazione di Azure. | UnexpectedClientError | Assicurarsi che l'applicazione implementi correttamente il meccanismo di aggiornamento dei token. |
4521 | 0 | Chiamata terminata perché l'utente si è disconnesso improvvisamente dalla chiamata. Questo potrebbe essere causato da un utente che chiude l'applicazione che ha ospitato la chiamata, ad esempio un utente ha terminato l'applicazione chiudendo la scheda del browser senza riagganciare in modo appropriato. | ExpectedError | |
5000 | 0 | Chiamata terminata per questo partecipante. Partecipante rimosso dalla conversazione da un altro partecipante. | Success | |
5003 | 0 | La chiamata è stata terminata correttamente, perché tutti gli endpoint chiamati hanno rifiutato la chiamata. | Success | |
5300 | 0 | Chiamata terminata per questo partecipante perché è stata rimossa dalla conversazione da un altro partecipante. | Success | La chiamata è terminata per questo partecipante perché un altro partecipante lo ha rimosso, potrebbe essere un altro client, l'API Di automazione delle chiamate, l'API Graph. |
5317 | 0 | Il partecipante di destinazione è stato rimosso a causa dell'aggiornamento del ruolo del partecipante. | ExpectedError | |
5828 | 403 | L'aggiunta non è autorizzata per la riunione Rooms perché l'utente non fa parte dell'elenco degli invitati. | UnexpectedClientError | |
5829 | 403 | Il join non è consentito per la riunione Rooms oltre l'ora di fine o prima dell'ora di inizio della riunione. | UnexpectedClientError | |
5830 | 403 | Solo l'utente di Servizi di comunicazione può partecipare alla riunione Rooms. | ExpectedError | |
7000 | 0 | La chiamata è stata terminata dall'API di Automazione chiamata del servizio di comunicazione di Azure o da un bot del server. | Success | La chiamata è stata terminata dall'API di automazione delle chiamate ACS o dal bot Graph. |
10003 | 487 | La chiamata è stata annullata per questo endpoint utente perché è stata accettata altrove da un altro endpoint. | Success | È stata avviata una chiamata all'utente di destinazione (chiamata di avvio, aggiunta di partecipante, trasferimento), l'utente di destinazione aveva più endpoint attivi contemporaneamente, in uno degli endpoint che l'utente ha accettato la chiamata. Si tratta di un comportamento normale, solo un endpoint può accettare e connettersi a una chiamata. Tutti gli altri endpoint ricevono il codice secondario 10003 per indicare che la chiamata è già stata accettata. |
10004 | 487 | La chiamata è stata annullata al timeout, perché l'utente di destinazione non l'ha accettata o rifiutata in tempo. Assicurarsi che l'utente abbia visualizzato la notifica e/o che l'applicazione possa gestirla automaticamente e provare a avviare di nuovo la chiamata. | ExpectedError | La chiamata è stata annullata dopo un periodo di tempo predefinito (in genere 2 minuti) perché l'utente di destinazione non ha accettato o rifiutato. |
10009 | 401 | Identità non autenticata. Assicurarsi che il token di Servizi di comunicazione di Azure sia valido e non sia scaduto. | UnexpectedClientError | |
10024 | 487 | Chiamata terminata correttamente. Chiamata rifiutata da tutti gli endpoint chiamati. | Success | Provare a effettuare di nuovo la chiamata. |
10037 | 480 | L'utente di destinazione non ha registrato endpoint con ACS. Assicurarsi che l'utente di destinazione abbia almeno un endpoint attivo e sia online. | ExpectedError | Se l'utente di destinazione usa Servizi di comunicazione di Azure Calling SDK, assicurarsi che l'SDK sia inizializzato correttamente nell'applicazione client. Se l'utente di destinazione è un utente di Teams, assicurarsi che il client sia online. Assicurarsi che l'identificatore dell'utente di destinazione (CommunicationUserIdentifier, MicrosoftTeamsUserIdentifier o MicrosoftTeamsBotIdentifier) sia corretto. Se la proprietà department dell'API user Graph è impostata su Microsoft Communication Application Instance MicrosoftTeamsBotIdentifier deve essere specificata. |
10057 | 408 | Chiamata non riuscita, chiamato non è riuscito a finalizzare l'installazione delle chiamate, probabilmente chiamato perso rete o terminato improvvisamente l'applicazione. Verificare che i client siano connessi e disponibili. | ExpectedError | |
10076 | 480 | L'utente di destinazione è stato registrato ma non era online al momento della chiamata. Assicurarsi che l'utente di destinazione abbia almeno un endpoint attivo e sia online. | ExpectedError | Se l'utente di destinazione usa l'SDK per chiamate Servizi di comunicazione di Azure, assicurarsi che l'SDK sia inizializzato correttamente nell'applicazione client e che il relativo endpoint sia online. Se l'utente di destinazione è un utente di Teams, assicurarsi che il client sia online. |
10077 | 480 | L'utente di destinazione è stato registrato con ACS e/o per le notifiche push, ma non era online al momento della chiamata. Assicurarsi che l'utente di destinazione abbia almeno un endpoint attivo e sia online. | ExpectedError | Se l'utente di destinazione usa l'SDK per chiamate Servizi di comunicazione di Azure, assicurarsi che l'SDK sia inizializzato correttamente nell'applicazione client e che il relativo endpoint sia online. Se l'applicazione sfrutta le notifiche push, assicurarsi che siano configurate correttamente. Se l'utente di destinazione è un utente di Teams, assicurarsi che il client sia online. |
10078 | 480 | Endpoint client remoto non registrato o non raggiungibile. Assicurarsi che l'endpoint client remoto invii correttamente richieste di rete a Servizi di comunicazione di Azure. | ExpectedError | - Se l'utente di destinazione usa l'SDK per chiamate Servizi di comunicazione di Azure, assicurarsi che l'SDK sia inizializzato correttamente nell'applicazione client e che il relativo endpoint sia online. Se l'applicazione sfrutta le notifiche push, assicurarsi che siano configurate correttamente. - Se l'utente di destinazione è un utente di Teams, assicurarsi che il client sia online. |
301004 | 410 | Il partecipante è stato rimosso dalla chiamata dall'infrastruttura Servizi di comunicazione di Azure a causa dell'impossibilità di stabilire la connettività multimediale con l'infrastruttura Servizi di comunicazione di Azure durante la configurazione delle chiamate. Controllare la configurazione di rete dell'utente, tra cui rete locale, firewall, configurazione VPN e riprovare. | UnexpectedClientError | Assicurarsi che la rete dell'utente sia configurata correttamente, seguire la documentazione pubblica "Raccomandazioni di rete". |
301005 | 410 | Il partecipante è stato rimosso dalla chiamata dall'infrastruttura di Servizi di comunicazione di Azure a causa della perdita di connettività multimediale con la stessa infrastruttura. Ciò si verifica in genere se il partecipante lascia la chiamata improvvisamente o perde la connettività di rete. Se il partecipante vuole continuare la chiamata, può riconnettersi. | UnexpectedClientError | Assicurarsi di usare l'SDK più recente in un ambiente supportato. |
540000 | 0 | Chiamata terminata correttamente dal chiamante PSTN locale. | Success | |
510403 | 403 | Chiamata terminata, contrassegnata in precedenza come posta indesiderata e ora bloccata. | ExpectedError | - Assicurarsi che il token di Servizi di comunicazione sia valido e non scaduto. - Assicurarsi di passare in AlternateId le opzioni di chiamata. |
540487 | 487 | La chiamata è stata completata correttamente perché il chiamante ha annullato la chiamata. | Success | |
560000 | 0 | Chiamata terminata correttamente dal partecipante PSTN remoto. | Success | Possibili cause: - L'utente ha terminato la chiamata. - Chiamata terminata dall'agente multimediale. |
560486 | 486 | Chiamata terminata perché il partecipante PSTN remoto era occupato. Il numero chiamato era già in una chiamata o presentava problemi tecnici. | Success | - Per le chiamate di routing diretto, controllare i log e le impostazioni e le impostazioni del controllo del bordo sessione e la configurazione dei timeout. Possibili cause: il numero chiamato era già in una chiamata o presentava problemi tecnici. |
404 | Chiamata non trovata. | Verificare che il numero che si sta chiamando (o la chiamata a cui ci si sta aggiungendo) esista. | ||
408 | Timeout del controller di chiamata. | Si è verificato il timeout del controller di chiamata durante l'attesa dei messaggi di protocollo dagli endpoint utente. Verificare che i client siano connessi e disponibili. | ||
410 | Errore dello stack multimediale locale o dell'infrastruttura multimediale. | Assicurarsi di usare l'SDK più recente in un ambiente supportato. | ||
430 | Non è possibile recapitare messaggi all'applicazione client. | Verificare che l'applicazione client sia in esecuzione e disponibile. | ||
480 | Endpoint client remoto non registrato. | Assicurarsi che l'endpoint remoto sia disponibile. | ||
481 | Non è stato possibile gestire la chiamata in ingresso. | Inviare una richiesta di supporto tramite il portale di Azure. | ||
490, 491, 496, 497, 498 | Problemi di rete dell'endpoint locale. | Controllare la configurazione di rete, assicurarsi che segua i requisiti di rete per chiamate di comunicazione di Azure. | ||
500, 503, 504 | Errore dell'infrastruttura di Servizi di comunicazione. | Inviare una richiesta di supporto tramite il portale di Azure. |
Informazioni sui codici di chiamata e sui codici secondari
Quando vengono ricevuti codici di errore?
I codici di errore per l'automazione delle chiamate possono essere risposte sincrone alle chiamate API o risposte asincrone tramite l'URI di callback fornito. Nella situazione sincrona, se viene effettuata una chiamata API e non viene accettata, ACS fornirà un codice di errore che descrive il motivo per cui la chiamata API è stata rifiutata. Negli scenari asincroni se viene effettuata una chiamata API e viene accettata ma si verifica un problema, vengono ricevuti sia un evento di callback che un codice di errore. Un esempio di evento di callback comune per gli errori di chiamata è l'evento callDisconnected
che viene visualizzato ogni volta che viene disconnessa una chiamata. Una volta ricevuto l'evento callDisconnected
, non ci saranno altri eventi di callback per la chiamata specificata. Per un elenco degli eventi di callback di segnalazione delle chiamate, vedere (questa pagina) e per un elenco di eventi di callback per le azioni multimediali vedere (questa pagina).
Sintassi del codice di errore
Codici di errore, codici secondari e categorie di risultati corrispondenti consentono agli sviluppatori di identificare e diagnosticare gli errori. I dettagli del codice di errore includono:
Codice : sono numeri interi a 3 cifre che rappresentano lo stato di risposta del client o del server. Categorie di codice:
- Risposte riuscite (200-299)
- Errore del client (400-499)
- Errore del server (500-599)
- Errore globale (600-699)
Codice secondario: sono definiti come numero intero, dove ogni numero indica un motivo univoco, specifico per un gruppo di scenari o un risultato specifico dello scenario.
Messaggio : descrive il risultato e fornisce suggerimenti su come attenuare il problema se un risultato è un errore.
Oltre al codice e al codice secondario, nei log delle chiamate sono disponibili informazioni più dettagliate sulla risoluzione dei problemi. Per altre informazioni su come abilitare e accedere ai log delle chiamate, vedere questa pagina per indicazioni dettagliate.
Codici di errore di SDK di automazione delle chiamate
La tabella seguente contiene i codici e i codici secondari più comuni. Se l'errore non è presente in questa tabella, fare riferimento ai codici generici e ai codici secondari per ottenere altre informazioni sullo scenario specifico.
Codici di errore di automazione delle chiamate più comuni
Codice | Sottocodice | Descrizione | Strategia di riduzione del rischio |
---|---|---|---|
404 | 8522 | Codice di errore generico che indica che la risorsa non viene trovata. Le risorse possono includere chiamate e partecipanti. | Doppio controllo dello stato della chiamata: la chiamata potrebbe essere già terminata oppure il partecipante ha lasciato la chiamata. |
400 | 8523 | Codice di errore generico che indica che un elemento nel corpo della richiesta non è valido. | Verificare che tutti i parametri siano validi. Fare riferimento al messaggio di errore per determinare quale parametro genera l'errore. |
400 | 8501 | Azione non supportata chiamata non stabilita | L'azione associata al messaggio di errore è stata attivata mentre la chiamata non era attiva. Assicurarsi che le nuove azioni di chiamata non vengano avviate dopo la disconnessione della chiamata. Questo errore può anche derivare da azioni richiamate mentre la chiamata è attiva se sono vicine al tempo di disconnessione della chiamata. |
400 | 8500 | Modalità multimediale non valida | Controllare lo stato delle operazioni multimediali per verificare se uno di essi è già attivo o se il partecipante di destinazione è già in un'operazione multimediale. Se è presente un'operazione multimediale attiva, attendere il completamento dell'operazione e quindi riprovare. |
400 | 8559 | Azione non supportata solo un'app dialout singola consentita | Richiesta di registrazione iniziale duplicata, registrazione già avviata o in corso. Controllare lo stato della registrazione per assicurarsi che sia inattivo prima di inviare una nuova chiamata di registrazione di avvio. |
400 | 8528 | Azione non supportata chiamata terminata | L'azione associata al messaggio di errore è stata attivata mentre la chiamata è stata terminata. Assicurarsi che le nuove azioni di chiamata non vengano avviate dopo la chiusura della chiamata. Questo errore può anche derivare da azioni richiamate mentre la chiamata è attiva se sono vicine al tempo di terminazione della chiamata. |
409 | 8519 | Conflitto | Verificare che più azioni non vengano eseguite sulla stessa risorsa in parallelo. Fare riferimento al messaggio di errore per identificare le due azioni in conflitto. |
403 | 7507 | Identità origine chiamata non valida | L'identità dell'applicazione dal token di autorizzazione non corrisponde all'identità dell'applicazione nell'origine chiamata. Verificare di usare il stringa di connessione dalla risorsa ACS in cui è stato configurato il webhook di chiamata in ingresso ( il numero di telefono deve essere di proprietà della stessa risorsa ACS che risponde alla chiamata). |
403 | 7504 | Autorizzazioni dell'applicazione insufficienti | Codice generico per autorizzazioni insufficienti, controllare il messaggio di errore relativo al contesto per la risorsa che manca di autorizzazioni. |
400 | 8585 | Azione non valida nello stato della chiamata corrente | La chiamata non viene stabilita o è disconnessa: attendere che la chiamata venga stabilita prima di ripetere l'azione multimediale. |
405 | 8520 | Funzionalità non supportate in questo momento | Errore previsto: il flusso di lavoro non è attualmente supportato. Controllare il blog sulla versione per verificare se è disponibile un SDK aggiornato che ha abilitato queste funzionalità. Per un elenco di flussi di lavoro non supportati, vedere la pagina Limitazioni note di Automazione delle chiamate. |
412 | 8583 | Precondizione non riuscita | Fare riferimento a questa pagina che elenca azioni multimediali incompatibili per assicurarsi di non eseguire o accodare azioni incompatibili. |
400 | 8567 | Entità servizio risorse ACS non abilitata | La risorsa servizio cognitivo di Azure non è configurata correttamente. Per una guida alla configurazione della risorsa di Servizi cognitivi di Azure, vedere questa pagina . |
405 | 8522 | Configurazione mancante | Controllare il messaggio di errore per altri contesti in cui deve essere stabilita la configurazione. Questa configurazione deve essere eseguita quando si richiama l'API AnswerCall. |
Codici di errore generici
Codici 2xx
Un codice 2xx rappresenta una risposta riuscita. Il codice secondario per le risposte riuscite sarà 0.
Codici 4xx
Un codice 4xx rappresenta un errore client.
Codice di stato | Descrizione |
---|---|
400 | Richiesta non valida |
401 | Non autorizzata |
403 | Non consentito |
404 | Non trovato |
405 | Metodo non consentito |
406 | Non accettabile |
408 | Timeout |
409 | Conflitto |
412 | Precondizione non riuscita |
413 | Entità della richiesta troppo grande |
426 | Aggiornamento obbligatorio |
429 | Numero eccessivo di richieste |
481 | La transazione non esiste |
487 | Annullati |
Codici 5xx
Un codice 5xx rappresenta un errore del server.
Codice di stato | Descrizione |
---|---|
500 | Errore interno del server |
501 | Non implementato |
502 | Gateway non valido |
503 | Servizio non disponibile |
504 | Timeout del gateway |
Codici 6xx
Un codice 6xx rappresenta un errore globale.
Codice di stato | Descrizione |
---|---|
603 | Rifiutato |
Codici secondari generici
Codice secondario | Descrizione |
---|---|
0 | Success |
7000 | Normale |
7500 | Identità AAD non supportata |
7501 | Token non valido |
7502 | Accesso non abilitato |
7504 | Autorizzazioni dell'applicazione insufficienti |
7505 | Mancata corrispondenza del tenant aziendale |
7506 | Certificato non attendibile |
7507 | Identità origine chiamata non valida |
7508 | Identità ACS non supportata |
7509 | Errore di convalida Hmac |
7510 | Errore di convalida dell'identità gestita |
7600 | Accesso alle risorse non abilitato |
7601 | Identità origine ACS non valida |
7602 | Identità di destinazione ACS non valida |
7603 | Identità ACS non valida |
7604 | Scenario di interoperabilità di Teams non autorizzato |
7605 | Scenario di interoperabilità di registrazione di Teams non autorizzato |
7606 | Risorsa ACS non autorizzata per azioni cognitive |
8500 | Modalità multimediale non valida |
8501 | Chiamata non stabilita |
8502 | ID partecipante non disponibile |
8503 | Chiamare l'audio dello stato multimediale inattivo |
8504 | Flussi multimediali non disponibili |
8505 | Più partecipanti con sostituzione |
8506 | Chiamata di registrazione non conformità |
8508 | Operazione annullata |
8509 | Timeout massimo silenzio raggiunto |
8510 | Timeout del silenzio iniziale raggiunto |
8511 | Richiesta di riproduzione non riuscita |
8512 | Riproduzione beep non riuscita |
8513 | Media Receive Timeout |
8514 | Tono di arresto rilevato |
8515 | Durata massima record raggiunta |
8516 | Chiamata limitata |
8517 | Mancata corrispondenza dell'ID tenant di chiamata |
8518 | Chiamare un'eccezione |
8519 | Conflitto |
8520 | Non implementato. |
8521 | Troppi hop |
8522 | Non trovato |
8523 | Argomento non valido |
8524 | Numero di partecipanti non validi per la registrazione della conformità |
8525 | Nessuna entità registrata |
8526 | Token di join non valido |
8527 | URL di join non valido |
8528 | Chiamata terminata |
8529 | È stato raggiunto il limite mensile di chiamata limitato |
8530 | Limite di chiamate attive limitate raggiunto |
8531 | Numero massimo di cifre ricevute |
8532 | Timeout tra cifre raggiunto |
8533 | Opzione Dtmf corrispondente |
8534 | Tono errato immesso |
8535 | Formato file non valido |
8536 | Download file non riuscito |
8537 | Timeout Keep Alive raggiunto |
8538 | Chiamato rifiutato |
8539 | Chiamato occupato |
8540 | Chiamato occupato ovunque |
8541 | Chiamato non disponibile |
8542 | Chiamata annullata |
8543 | Chiamata non esistente |
8544 | Chiamato non raggiungibile |
8545 | Opzione voce corrispondente |
8546 | Richiesta non valida inviata dal chiamato |
8547 | Opzione voce non corrispondente |
8548 | La chiamata non è chiamata di gruppo |
8549 | Retarget Conversation Creation Failed |
8550 | Retarget Media Negoziazione non riuscita |
8551 | Retarget non supportato |
8552 | Impossibile rimuovere l'organizzatore |
8553 | Registrazione duplicata |
8554 | Combinazione audio partecipante fuori riunione |
8555 | Retarget già in corso |
8556 | Azione non supportata per la chiamata CR |
8557 | Tipo di formato errato |
8558 | Partecipante non presente |
8559 | Duplicato dialout singolo |
8560 | Partecipare alla conversazione bloccata a causa di una riunione bloccata |
8561 | ID riunione di partecipazione non valido |
8562 | Modalità di registrazione non supportata |
8563 | Riconoscimento vocale non riconosciuto |
8564 | Errore di connessione al servizio Voce |
8565 | Errore di Servizi cognitivi |
8566 | Operazione di annullamento dell'audio non consentita |
8567 | Entità servizio risorse ACS non abilitata |
8568 | Identità gestita per la richiesta di servizi cognitivi non riuscita |
8571 | Conflitto di operazioni di registrazione |
8569 | Riconoscimento vocale |
8570 | Errore di riconoscimento vocale di Servizi cognitivi |
8572 | Arresto del servizio di riproduzione |
8573 | Metodo Pause Resume non consentito |
8578 | Trascrizione non riuscita |
8579 | Trascrizione annullata |
8580 | Arresto del servizio di trascrizione |
8581 | URL flusso non valido |
8582 | Riproduci testo di origine o Ssml vuoto |
8583 | Precondizione non riuscita |
8585 | Azione non valida nello stato della chiamata corrente |
8586 | Chiamata in arrivo non riconosciuta dal bot |
8587 | Chiamata in arrivo non risposta entro il tempo |
8588 | Timeout di ricezione del record completato e del supporto |
8589 | Record limitato |
8594 | Aggiornamento stato riunione non riuscito |
8603 | Streaming multimediale non riuscito |
8604 | Streaming multimediale annullato |
8605 | Modello di riconoscimento vocale personalizzato di trascrizione non supportato |
8606 | Creazione dell'identificatore di comunicazione non riuscita |
8607 | Conflitto dell'operazione di trasferimento |
8608 | Errore del client partecipante registrazione |
8609 | Risposta di join non valida dal bot |
8610 | Nessuna risposta dal bot nella notifica |
8613 | Limite di didascalie live limitate raggiunto |
9001 | Errore sconosciuto dal servizio sottostante |
9002 | Errore di timeout dal servizio sottostante |
9003 | Errore di annullamento dell'operazione |
9998 | Errore irreversibile |
9999 | Sconosciuto |
Codici di risposta delle chiamate PSTN con ParticipantEndReason
In questa sezione vengono fornite informazioni sulla risoluzione dei problemi per varie combinazioni di codici di risposta ParticipantEndReason
e ParticipantEndSubCode
. Per le tabelle in questa sezione, ParticipantEndReason
= Codice e ParticipantEndSubCode
= Codice secondario.
ParticipantEndReason 0
La risposta ParticipantEndReason
con valore 0 indica in genere la normale cancellazione delle chiamate e contrassegna le chiamate completate senza errori.
Sottocodice | Codice | Messaggio | Categorie di risultati | Comunicazione |
---|---|---|---|---|
0 | 0 | Chiamata terminata correttamente dal partecipante locale. | Success | |
560000 | 0 | Fine chiamata PSTN normale: - L'utente ha terminato la chiamata. - Chiamata terminata dall'agente multimediale. |
Success | |
540000 | 0 | Fine chiamata PSTN normale: - L'utente ha terminato la chiamata. - Chiamata terminata dall'agente multimediale. |
Success |
ParticipantEndReason 4xx
La risposta ParticipantEndReason
con valore 4xx indica che la chiamata non si è connessa.
Sottocodice | Codice | Messaggio | Categorie di risultati | Comunicazione |
---|---|---|---|---|
510403 | 403 | Chiamata bloccata: - ID alternativo non specificato per la chiamata. - Numero di telefono non consentito dagli utenti Session Border Controller (SBC). |
- Per altre informazioni sull'ID alternativo, vedere Gestire le chiamate. - Assicurarsi di aver specificato un ID alternativo valido. Deve essere un numero di telefono appartenente alla risorsa in uso. - Assicurarsi di essere proprietari della risorsa usata per effettuare una chiamata. - Per le chiamate di instradamento diretto, verificare il motivo per cui Session Border Controller non ha consentito la chiamata. |
|
560403 | 403 | - Chiamata vietata. - Chiamata annullata. - Chiamata rifiutata. |
Assicurarsi di aver chiamato un numero di telefono valido nel formato corretto. Per altre informazioni sui formati di numero supportati, vedere https://en.wikipedia.org/wiki/E.164. | |
511532 | 403 | Configurazione trunk SIP della risorsa non trovata. | Controllare la configurazione dell'instradamento diretto nel portale di Azure. Per altre informazioni, vedere Provisioning dell'instradamento diretto. | |
560404 | 404 | - Numero di telefono non trovato. - Numero di telefono non assegnato ad alcuna destinazione. - Numero di telefono non consentito da Session Border Controller. |
- Assicurarsi che il numero di telefono appartenga alla risorsa in uso e che si sia proprietari della risorsa. - Assicurarsi che il numero che si sta chiamando esista e che sia assegnato a una destinazione valida. |
|
511404 | 404 | - Numero di telefono non trovato. - Risorsa usata nella chiamata non trovata. |
- Assicurarsi di aver usato un numero di telefono appartenente alla risorsa in uso e di essere il proprietario della risorsa. - Assicurarsi che il numero che si sta chiamando esista e che sia assegnato a una destinazione valida. - Assicurarsi che la risorsa usata per la chiamata non venga eliminata o disabilitata. - Assicurarsi che le sottoscrizioni di Azure non vengano eliminate o disabilitate. |
|
560408 | 408 | La parte chiamata non ha risposto a un messaggio di istituzione di chiamata entro il periodo di tempo previsto. | - Controllare il motivo per cui la parte chiamata non ha risposto. - Per le chiamate di instradamento diretto, controllare i log e le impostazioni di Session Border Control (SBC) e la configurazione dei timeout. |
|
500001 | 408 | Timeout del gateway utente Servizi di comunicazione di Azure non ha ricevuto una risposta dal client entro un limite di tempo specificato e ha terminato la richiesta. |
- Controllare il motivo per cui la parte chiamata non ha risposto. - Per le chiamate di instradamento diretto, controllare i log e le impostazioni SBC e la configurazione dei timeout. |
|
531004 | 410 | Controlli ICE (Interactive Connectivity Establishment) non riusciti. | - Impossibile stabilire il percorso multimediale. il problema può essere causato da una configurazione di rete non corretta. Verificare la configurazione di rete per assicurarsi che gli indirizzi IP e le porte richiesti non siano bloccati. Leggere le linee guida in https://www.rfc-editor.org/rfc/rfc5245#section-7. - Per le chiamate di instradamento diretto, controllare i log e le impostazioni SBC per la configurazione e il profilo ICE. Per assistenza sulla configurazione, contattare il fornitore SBC. Per altre informazioni, vedere Elenco di Session Border Contro certificati per l'instradamento diretto di Servizi di comunicazione di Azure. |
|
560480 | 480 | - Nessuna risposta da parte dell'utente chiamato. - Utente chiamato temporaneamente non disponibile. |
- Controllare il motivo per cui la parte chiamata non ha risposto. - Ripetere la chiamata in un secondo momento nel caso in cui la parte chiamata non fosse disponibile temporaneamente. - Per le chiamate di instradamento diretto, controllare i log e le impostazioni SBC e la configurazione dei timeout. |
|
560484 | 484 | - Indirizzo chiamato incompleto o non valido. - Formato numero chiamato incompleto o non valido. |
- In alcuni casi, è possibile ignorare questi errori perché l'utente sta componendo un numero non valido. - Assicurarsi che i numeri di telefono siano formattati correttamente. Per ulteriori informazioni, vedere https://en.wikipedia.org/wiki/E.164. - Per l'instradamento diretto, SBC potrebbe causare questi errori a causa di una configurazione mancante in uno scenario di trasferimento delle chiamate. |
|
60486 | 486 | Numero chiamato occupato | - Il numero chiamato può essere connesso a una chiamata esistente o avere un problema tecnico. - Per le chiamate di instradamento diretto, controllare i log e le impostazioni SBC e la configurazione dei timeout. |
|
540487 | 487 | Il chiamante ha terminato la richiesta di chiamata. | Ripetere la chiamata. | |
560487 | 497 | - Il chiamante ha terminato la richiesta di chiamata. - Richiesta terminata con la normale cancellazione delle chiamate. |
Ripetere la chiamata. |
ParticipantEndReason 5xx
La risposta ParticipantEndReason
con valore 5xx indica che la chiamata non è riuscita a causa di un problema con un componente software o hardware necessario per completare la connessione.
Sottocodice | Codice | Messaggio | Categorie di risultati | Comunicazione |
---|---|---|---|---|
560500 | 500 | Si è verificato un errore interno del server in uno dei servizi coinvolti nella chiamata. | - Ripetere la chiamata. Se il problema persiste, contattare il provider di telecomunicazioni o il supporto tecnico Microsoft. - Per le chiamate di instradamento diretto, controllare i log e le impostazioni SBC e la configurazione dei timeout, per verificare se SBC ha causato l’errore. |
|
560503 | 503 | - Chiamata non riuscita a causa di un errore interno del server in uno dei servizi coinvolti nella chiamata. - La rete usata per stabilire la chiamata è fuori servizio. - Errore temporaneo in uno dei servizi coinvolti nella chiamata. |
- Controllare la configurazione della rete e del routing per individuare eventuali problemi. Assicurarsi che le regole del firewall di rete siano corrette. - Ripetere la chiamata. Se il problema persiste, contattare il provider di telecomunicazioni o il supporto tecnico Microsoft. - Per le chiamate di instradamento diretto, controllare i log e le impostazioni SBC e la configurazione dei timeout, per verificare se SBC ha causato l’errore. |
ParticipantEndReason 603
La risposta ParticipantEndReason
con valore 603 indica che la chiamata è stata rifiutata senza connettersi.
Sottocodice | Codice | Messaggio | Categorie di risultati | Comunicazione |
---|---|---|---|---|
560603 | 603 | - Chiamata rifiutata dal destinatario. - Chiamata rifiutata a causa del rilevamento di frode. |
- Se la chiamata è stata rifiutata dal destinatario, ripetere la chiamata. - Assicurarsi di non superare il numero massimo di chiamate simultanee consentite per il numero di telefono di Servizi di comunicazione di Azure. Per altre informazioni, vedere Limitazioni delle chiamate PSTN. |
Codici di errore di SDK di chat
SDK di chat usa i codici di errore seguenti per risolvere i problemi di chat. I codici di errore vengono esposti tramite la proprietà error.code
nella risposta di errore.
Codice | Messaggio | Comunicazione |
---|---|---|
401 | Non autorizzata | Verificare che il token di Servizi di comunicazione sia valido e non scaduto. |
403 | Non consentito | Assicurarsi che l'iniziatore della richiesta abbia accesso alla risorsa. |
429 | Numero eccessivo di richieste | Assicurarsi che l'applicazione lato client gestisca questo scenario in modo intuitivo. Se l'errore persiste, aprire una richiesta di supporto. |
503 | Servizio non disponibile | Inviare una richiesta di supporto tramite il portale di Azure. |
Codici di errore SMS
SMS SDK usa i codici di errore seguenti per risolvere i problemi relativi agli SMS. I codici di errore vengono esposti tramite il campo DeliveryStatusDetails
nel report di recapito SMS.
Codice | Messaggio | Comunicazione |
---|---|---|
2000 | Messaggio recapitato correttamente. | |
4000 | Il messaggio viene rifiutato a causa del rilevamento di frodi. | Assicurarsi di non superare il numero massimo di messaggi consentiti per il proprio numero. |
4001 | Il messaggio viene rifiutato a causa di un formato di origine/numero di origine non valido | Verificare che il numero del destinatario sia in formato E.164 e che il numero di origine sia in formato E.164 o Codice breve. |
4002 | Il messaggio viene rifiutato a causa di un formato di destinazione/numero destinatario non valido. | Verificare che il numero destinatario sia in formato E.164 |
4003 | Messaggio non recapitabile a causa di una destinazione non supportata. | Controllare se la destinazione che si sta tentando di raggiungere è supportata. |
4004 | Impossibile recapitare il messaggio perché il numero di destinazione non esiste. | Verificare che il numero a cui si sta tentando di inviare contenuto sia valido. |
4005 | Messaggio bloccato dal gestore della destinazione. | |
4006 | Il numero di destinazione non è raggiungibile. | Provare a inviare nuovamente il messaggio in un secondo momento. |
4007 | Il numero di destinazione ha rifiutato esplicitamente di ricevere messaggi dall'utente. | Contrassegnare il numero di destinazione come escluso con rifiuto esplicito in modo che non vengano eseguiti ulteriori tentativi di invio di messaggi al numero. |
4008 | È stato superato il numero massimo di messaggi consentiti per il profilo. | Assicurarsi di non superare il numero massimo di messaggi consentiti per il proprio numero o usare le code per inviare in batch i messaggi. |
4009 | Messaggio rifiutato da Microsoft Entitlement System. | Spesso ciò si verifica se viene rilevata un'attività fraudolenta. Per altri dettagli, contattare il supporto tecnico. |
4010 | Il messaggio è stato bloccato a causa di un numero verde non verificato. | Esaminare i limiti di invio non verificato e inviare la verifica di numero verde quanto prima. |
5000 | Impossibile recapitare il messaggio. Per altre informazioni, contattare il team di supporto Microsoft. | Inviare una richiesta di supporto tramite il portale di Azure. |
5001 | Messaggio non recapitabile a causa dell'indisponibilità temporanea dell'applicazione o del sistema. | |
5002 | Il vettore non supporta il report di recapito | Spesso ciò si verifica se un vettore non supporta i report di recapito. Nessuna azione necessaria perché il messaggio potrebbe essere già stato recapitato. |
9999 | Impossibile recapitare il messaggio a causa di un errore o un problema sconosciuto. | Provare a inviare nuovamente il messaggio. |