Risoluzione degli errori di chiamata PSTN di Servizi di comunicazione di Azure

  • Articolo

Quando si risolvono errori di chiamata PSTN di Servizi di comunicazione di Azure, è consigliabile abilitare la registrazione. È quindi possibile usare i valori ResultCategories, ParticipantEndReason e ParticipantEndSubCode per determinare il motivo per cui una singola chiamata è terminata e se il sistema ha rilevato errori.

Uso di ResultCategories per risolvere gli errori delle chiamate PSTN

La matrice ResultCategories è una proprietà dello schema del log di riepilogo della chiamata e contiene un elenco di motivi generali che descrivono come è terminata la chiamata.

Motivi generali per cui una chiamata è terminata:

  • Riuscita
  • Errore
  • UnexpectedClientError
  • UnexpectedServerError

Queste informazioni consentono agli sviluppatori di determinare il motivo per cui una chiamata è terminata senza generare un log degli errori dettagliato.

Se questo livello di dettaglio non è sufficiente, gli sviluppatori possono usare ParticipantEndReason e ParticipantEndSubCode per comprendere i motivi per cui una chiamata è terminata in modo più dettagliato. Per ulteriori informazioni, vedi la sezione successiva.

Uso di ParticipantEndReason e ParticipantEndSubCode per risolvere gli errori delle chiamate PSTN

ParticipantEndReason e ParticipantEndSubCode sono proprietà dello schema del log di riepilogo della chiamata e forniscono altri dettagli sul motivo per cui la chiamata è terminata.

Quando si risolvono le chiamate PSTN, usare queste due proprietà per comprendere il motivo per cui la chiamata è terminata nel modo seguente:

  • ParticipantEndReason: codice a tre cifre che mostra lo stato generale della chiamata. Questo codice spiega perché la chiamata è terminata e raggruppa gli errori per categoria. Ad esempio, ParticipantEndReason 404 indica che il chiamante/chiamato non è stato trovato, ParticipantEndReason 500 significa che si è verificato un errore del servizio e così via. Questo codice si basa sui codici di risposta SIP. Per altre informazioni, vedere l'elenco di codici di risposta SIP di Wikipedia.

  • ParticipantEndSubCode: codice di risposta più specifico, in genere composto da sei cifre, che spiega in modo più dettagliato il motivo per cui si è verificato un problema con la chiamata.

Riconoscimento della relazione ParticipantEndSubCode

Un fattore chiave nella risoluzione dei problemi delle chiamate PSTN di Servizi di comunicazione di Azure è determinare se il codice di risposta finale per la chiamata proviene da un processo Microsoft o dagli utenti/operatori Session Border Controller (SBC). Un modo semplice per determinare dove ha origine il codice consiste nell'esaminare la risposta ParticipantEndSubCode.

Se ParticipantEndSubCode inizia con 560, indica che il codice di risposta viene generato dagli utenti/operatori Session Border Controller (SBC), in modo che gli sviluppatori debbano controllare la configurazione SBC.

  • Ad esempio, se ParticipantEndSubCode è 560403, significa che il codice di risposta finale viene generato dal SBC e le ultime tre cifre indicano il codice di risposta SIP 403. In questo caso, uno sviluppatore deve iniziare a risolvere i problemi delle chiamate usando i log SBC.

Per tutte le altre risposte ParticipantEndSubCode che non iniziano con 560, il codice di risposta finale viene generato da un servizio Microsoft.

Informazioni dettagliate sui singoli codici di errore

Per altre informazioni sui codici di errore comuni e sulle azioni suggerite, vedere Risoluzione dei problemi relativi ai codici di risposta di fine chiamata per SDK di chiamata, SDK di automazione chiamate e chiamate PSTN.

Per altre informazioni, vedere Risoluzione dei problemi in Servizi di comunicazione di Azure.