Problembehandlung bei Antwortcodes am Anrufende für Calling SDK, Call Automation SDK, PSTN, Chat SDK und SMS SDK
In diesem Artikel wird die Problembehandlung bei Antwortcodes am Anrufende für Calling SDK, Call Automation und PSTN Calling beschrieben.
Tipps zur Problembehandlung
Beachten Sie bei der Problembehandlung die folgenden Tipps:
- Ihre Anwendung empfängt kein
IncomingCall Event Grid
-Ereignis: Stellen Sie sicher, dass der Anwendungsendpunkt beim Erstellen eines Ereignisabonnements mit dem Ereignisraster überprüft wird. Der Bereitstellungsstatus für Ihr Ereignisabonnement wird als erfolgreich markiert, wenn die Überprüfung erfolgreich war. - Für Fehler
The field CallbackUri is invalid
: Die Anrufautomatisierung unterstützt keine HTTP-Endpunkte. Vergewissern Sie sich, dass die von Ihnen angegebene Rückruf-URL HTTPS unterstützt. - Die
PlayAudio
-Aktion gibt nichts wieder: Aktuell wird für Audiodateien nur das Wave-Dateiformat (WAV) unterstützt. Der Audioinhalt in der Wavedatei muss mono (einkanalig) mit 16-Bit-Samples und einer Abtastrate von 16.000 Hz (16 KHz) vorliegen. - Aktionen auf PSTN-Endpunkten funktionieren nicht: Für
CreateCall
,Transfer
,AddParticipant
undRedirect
zu Telefonnummern müssen SieSourceCallerId
in der Aktionsanforderung festlegen. Sofern Sie nicht Direct Routing verwenden, muss die Quellanrufer-ID eine Telefonnummer sein, die sich im Besitz Ihrer Communication Services-Ressource befindet, damit die Aktion erfolgreich ist.
Weitere Informationen zu Problemen, die vom Produktteam nachverfolgt werden, finden Sie unter Bekannte Probleme.
Hinweis
Nachrichten- und Ergebniskategorien, die in den folgenden Tabellen aufgeführt sind, befinden sich in der öffentlichen Vorschau. Weitere Informationen finden Sie unter Zusätzliche Nutzungsbestimmungen für Microsoft Azure-Vorschauen.
Grundlegendes beim Aufrufen von Codes und Fehler bei Untercodes
Fehlercodes, Untercodes und entsprechende Ergebniskategorien helfen entwickelnden Fachkräften, Fehler zu identifizieren und zu diagnostizieren. Diese Fehlercodes werden durch die call.callEndReason
-Eigenschaft bereitgestellt, nachdem ein Anruf beendet wurde.
Zu den Fehlercodedetails gehören:
Code – sind dreistellige ganze Zahlen, die den Client- oder Serverantwortstatus darstellen. Die Codekategorien:
- Erfolgreiche Antworten (200–299)
- Clientfehler (400–499)
- Serverfehler (500–599)
- Globaler Fehler (600-699)
Subcode – werden als ganze Zahl definiert, wobei jede Zahl für einen eindeutigen Grund steht, der für eine Gruppe von Szenarien oder ein bestimmtes Szenarioergebnis spezifisch ist.
Nachricht – beschreibt das Ergebnis und bietet Hinweise zur Behebung des Problems, wenn ein Ergebnis ein Fehler ist.
ResultCategory – gibt den Typ des Fehlers an. Je nach Kontext kann der Wert Success
, ExpectedError
, UnexpectedClientError
oder UnexpectedServerError
sein.
Fehlercodes und Untercodes des Azure Communication Services Calling SDK-Clients
Falls die resultCategories-Eigenschaft ExpectedError
lautet, wird der Fehler bei Client-Fehlern aus Sicht des SDK erwartet. Solche Fehler treten häufig bei Vorbedingungsfehlern auf, z. B. bei falschen Argumenten, die von der App übergeben werden, oder wenn der aktuelle Systemstatus den API-Aufruf nicht zulässt. Die Anwendung sollte den Fehlergrund und die Logik für das Aufrufen der API überprüfen.
Subcode | Code | `Message` | Ergebniskategorie | Advice |
---|---|---|---|---|
40101 | 408 | Fehler beim Erstellen von CallAgent. Wiederholen Sie den Vorgang, wenn das Problem weiterhin besteht, führen Sie Browserkonsolenprotokolle und die .HAR -Datei zusammen, und wenden Sie sich an den Azure Communication Services-Support. |
UnexpectedClientError | |
40104 | 408 | Fehler beim Erstellen von CallAgent. Wiederholen Sie den Vorgang, wenn das Problem weiterhin besteht, führen Sie Browserkonsolenprotokolle und die .HAR -Datei zusammen, und wenden Sie sich an den Azure Communication Services-Support. |
UnexpectedClientError | |
40114 | 408 | Fehler beim Herstellen einer Verbindung mit der Azure Communication Services-Infrastruktur. Versuchen Sie es erneut, und überprüfen Sie die Netzwerkanforderungen des Browsers. Wenn die Anforderungen fehlschlagen, sammeln Sie Browserkonsolenprotokolle, .HAR -Datei und Wenden Sie sich an den Azure Communication Services-Support. |
UnexpectedClientError | Weitere Informationen finden Sie unter Netzwerkanforderungen. |
40115 | 412 | Fehler beim Erstellen von CallAgent, die Verbindung mit der Azure Communication Services-Infrastruktur konnte nicht initialisiert werden. Versuchen Sie es erneut, und überprüfen Sie die Netzwerkanforderungen des Browsers. Wenn die Anforderungen fehlschlagen, sammeln Sie Browserkonsolenprotokolle, .HAR -Datei und Wenden Sie sich an den Azure Communication Services-Support. |
UnexpectedClientError | Weitere Informationen finden Sie unter Netzwerkanforderungen. |
40216 | 500 | Fehler beim Erstellen von CallAgent. Versuchen Sie es erneut, wenn das Problem weiterhin besteht, Browserkonsolenprotokolle zu sammeln und sich an den Azure Communication Services-Support zu wenden. | UnexpectedClientError | |
40228 | 409 | Fehler beim Erstellen von CallAgent, eine Instanz von CallAgent, die dieser Identität zugeordnet ist, ist bereits vorhanden. Löschen Sie den vorhandenen CallAgent, oder erstellen Sie eine neue mit einer anderen Identität. | ExpectedError | |
40230 | 409 | Fehler beim Erstellen von TeamsCallAgent, eine Instanz von TeamsCallAgent, die dieser Identität zugeordnet ist, ist bereits vorhanden. Löschen Sie den vorhandenen TeamsCallAgent, bevor Sie eine neue erstellen. | ExpectedError | |
40606 | 405 | Fehler beim Aufzählen von Lautsprechern, es wird nicht unterstützt, Lautsprecher auf Android Chrome, iOS Safari oder macOS Safari auflisten/auswählen. | ExpectedError | Die Enumeration/Auswahl von Sprechern wird unter Android Chrome, iOS Safari und macOS Safari nicht unterstützt. Das Betriebssystem wählt automatisch Lautsprecher (Ausgabegerät) aus. Erfahren Sie mehr über die Geräteverwaltung und wie Sie diese Probleme am besten beheben können. |
40613 | 400 | Fehler beim Abrufen der Berechtigung für die Mikrofon- und/oder Kameraverwendung, sie wurde verweigert oder fehlgeschlagen. Stellen Sie sicher, dass sie die Berechtigungen im Browser und in den Betriebssystemeinstellungen zulassen. | ExpectedError | Erfahren Sie mehr darüber , wie Sie Geräteberechtigungenam besten behandeln. |
40614 | 500 | Fehler beim Anfordern von Geräteberechtigungen Stellen Sie sicher, dass die Berechtigungen in den Einstellungen des Browsers und in den Betriebssystemeinstellungen zulässig sind, und versuchen Sie es erneut. Wenn das Problem weiterhin besteht, sammeln Sie Browserkonsolenprotokolle, und wenden Sie sich an den Azure Communication Services-Support. | UnexpectedClientError | Erfahren Sie mehr darüber , wie Sie Geräteberechtigungenam besten behandeln. |
41006 | 400 | Fehler beim Annehmen des eingehenden Anrufs, er befindet sich nicht im Klingelzustand. Abonnieren Sie das incomingCall -Ereignis von CallAgent, um den eingehenden Anruf anzunehmen. |
ExpectedError | Lesen Sie die folgenden Artikel, um die Ursache des Problems zu identifizieren. - Empfangen eines eingehenden Anrufs - Abonnieren von SDK-Ereignissen |
41007 | 400 | Fehler beim Ablehnen des eingehenden Anrufs, er befindet sich nicht im Klingelzustand. Abonnieren Sie das incomingCall -Ereignis von CallAgent, um den eingehenden Anruf abzulehnen. |
ExpectedError | Lesen Sie die folgenden Artikel, um die Ursache des Problems zu identifizieren. - Empfangen eines eingehenden Anrufs - Abonnieren von SDK-Ereignissen |
41015 | 500 | Mikrofon konnte nicht stummgeschaltet werden. Versuchen Sie es erneut, wenn das Problem weiterhin besteht, Browserkonsolenprotokolle zu sammeln und sich an den Azure Communication Services-Support zu wenden. | UnexpectedClientError | |
41016 | 400 | Die Stummschaltung des Mikrofons konnte nicht aufgehoben werden. Versuchen Sie es erneut, wenn das Problem weiterhin besteht, Browserkonsolenprotokolle zu sammeln und sich an den Azure Communication Services-Support zu wenden. | UnexpectedClientError | |
41025 | 400 | Fehler beim Starten des Videos, die LocalVideoStream-Instanz ist ungültig oder leer. Übergeben Sie eine LocalVideoStream-Instanz. | ExpectedError | Stellen Sie sicher, dass das an das Starten des Videos übergebene Objekt eine Instanz von LocalVideoStream ist. Erstellen sie ein LocalVideoStream mithilfe eines VideoDeviceInfo -Objekts oder eines MediaStream -Objekts. Lesen Sie die folgenden Artikel, um die Ursache des Problems zu identifizieren: - Tätigen eines Anrufs mit Videokamera - Starten und Beenden des Sendens eines lokalen Videosignals während eines Anrufs - Zugreifen auf unformatierte Videodaten |
41027 | 400 | Video konnte nicht gestartet werden, Video wurde bereits gestartet. | ExpectedError | Nützliche Links: - Tätigen eines Anrufs mit Videokamera - Starten und Beenden des Sendens eines lokalen Videosignals während eines Anrufs |
41030 | 400 | Video konnte nicht beendet werden. Das Video wurde bereits beendet. | ExpectedError | Nützliche Links: - Tätigen eines Anrufs mit Videokamera - Starten und Beenden des Sendens eines lokalen Videosignals während eines Anrufs |
41032 | 400 | Fehler beim Beenden des Videos, ungültiges Argument. LocalVideoStream, der als Eingabe verwendet wird, wird derzeit nicht gesendet. | ExpectedError | Der LocalVideoStream, der im Anruf gesendet wird, wird im Call.localVideoStreams[]-Array gespeichert und hat den Typ Video oder RawMedia . Lesen Sie die folgenden Artikel, um die Ursache des Problems zu identifizieren: - Tätigen eines Anrufs mit Videokamera - Starten und Beenden des Sendens eines lokalen Videosignals während eines Anrufs - Zugreifen auf unformatierte Videodaten |
41033 | 500 | Der Anruf konnte nicht gehalten werden. Versuchen Sie es erneut, wenn das Problem weiterhin besteht, Browserkonsolenprotokolle zu sammeln und sich an den Azure Communication Services-Support zu wenden. | UnexpectedClientError | |
41034 | 500 | Fehler beim Fortsetzen des Anrufs. Versuchen Sie es erneut, wenn das Problem weiterhin besteht, Browserkonsolenprotokolle zu sammeln und sich an den Azure Communication Services-Support zu wenden. | UnexpectedClientError | |
41035 | 400 | Fehler beim Starten der Bildschirmfreigabe, die Bildschirmfreigabe wurde bereits gestartet. | ExpectedError | Weitere Informationen zum Starten und Beenden der Bildschirmfreigabe während eines Anrufs |
41041 | 400 | Fehler beim Beenden der Bildschirmfreigabe, die Bildschirmfreigabe wurde bereits beendet. | ExpectedError | Weitere Informationen zum Starten und Beenden der Bildschirmfreigabe während eines Anrufs |
41048 | 410 | Video beim Einrichten eines Anrufs konnte nicht gestartet werden. Stellen Sie sicher, dass Videoberechtigungen in den Einstellungen des Browsers und in den Betriebssystemeinstellungen zulässig sind, und stellen Sie sicher, dass das Kameragerät nicht von einem anderen Prozess verwendet wird. | UnexpectedClientError | - Das Kameragerät ist möglicherweise im System deaktiviert. - Die Kamera wird von einem anderen Prozess verwendet. |
41056 | 412 | Fehler beim Starten oder Beitreten zum Anruf. Die Microsoft Teams Enterprise-VoIP-Richtlinie ist für diese Azure Communication Services-Ressource nicht aktiviert. Folgen Sie dem Lernprogramm online, um es zu aktivieren. | ExpectedError | Erfahren Sie, wie Sie Benutzern für Enterprise-VoIP Online- und Telefonsystem-Voicemail aktivieren können, um die Microsoft Teams Enterprise-VoIP-Richtlinie zu aktivieren |
41071 | 412 | Fehler beim Starten der Bildschirmfreigabe, der Anruf befindet sich nicht im Zustand "Verbunden". Abonnieren Sie das Ereignis statteChanged des Anrufs, um zu wissen, wann der Anruf verbunden ist. |
ExpectedError | Nützliche Links: - Überprüfen von Anrufeigenschaften - Abonnieren von SDK-Ereignissen |
41073 | 412 | Fehler beim Abrufen oder Festlegen von benutzerdefiniertem MediaStream, diese Funktionalität ist derzeit von Azure Communication Services deaktiviert. | ExpectedError | |
43000 | 412 | Videogerät konnte nicht gestartet werden, wird von einem anderen Prozess/einer anderen Anwendung verwendet. Beenden Sie die Verwendung Ihrer Kamera im anderen Prozess/der anderen Anwendung, und versuchen Sie es erneut. | ExpectedError | Erfahren Sie mehr darüber , wie Sie am besten mit einer Kamera umgehen können, die von einem anderen Prozess verwendet wird |
43001 | 403 | Fehler beim Starten des Videos. Die Berechtigung für die Verwendung des ausgewählten Videogeräts wurde nicht erteilt. Stellen Sie sicher, dass Videogeräteberechtigungen in den Einstellungen des Browsers und in den Einstellungen des Systems zulässig sind. | ExpectedError | Stellen Sie sicher, dass Kameraberechtigungen in den Browsereinstellungen und Gerätesystemeinstellungen zulässig sind. Stellen Sie sicher, dass die Kameras in den Gerätesystemeinstellungen nicht deaktiviert sind. Stellen Sie unter macOS sicher, dass die Bildschirmaufzeichnung über die Systemeinstellungen zulässig ist. Nützliche Links: - Anfordern von Geräteberechtigungen- Bildschirmfreigabeberechtigungen unter macOS - Aufzählen von Geräten für Safari unter macOS und iOS bzw. Zugreifen auf solche Geräte |
43002 | 500 | Fehler beim Starten des Videos, unbekannter Fehler. Versuchen Sie es erneut. Wenn das Problem weiterhin besteht, wenden Sie sich an den Azure Communication Services-Support. | UnexpectedClientError | |
43004 | 400 | Fehler beim Wechseln des Videogeräts, ungültiger Eingabe. Die Eingabe muss einen VideoDeviceInfo-Typ aufweisen. | ExpectedError | Verwenden Sie den Geräte-Manager, um eine Liste der VideoDeviceInfo-Objekte abzurufen, und verwenden Sie dann das VideoDeviceInfo-Objekt, um die Quelle zu wechseln. Weitere Informationen zum Starten und Beenden des Sendens von lokalen Videos während eines Anrufs |
43005 | 400 | Fehler beim Wechseln des Videogeräts, das nicht zum gleichen Videogerät wechseln kann. Es ist bereits ausgewählt. | ExpectedError | |
43013 | 412 | Video konnte nicht gestartet werden, es wurden keine Videogeräte gefunden. Stellen Sie sicher, dass Videogeräte angeschlossen und in den Systemeinstellungen aktiviert sind. | ExpectedError | Stellen Sie sicher, dass eine Kamera angeschlossen und auf Ihrem Gerät installiert ist. |
43014 | 412 | Fehler beim Starten des Videos. Fehler beim Anfordern des Mediendatenstroms. Versuchen Sie es erneut, wenn das Problem weiterhin besteht, wenden Sie sich an den Azure Communication Services-Support. | UnexpectedClientError | |
43015 | 412 | Fehler beim Starten des Videos, Timeout der Mediendatenstromanforderung. Erlauben Sie der Aufforderung des Browsers die Berechtigung, auf die Kamera zuzugreifen, und versuchen Sie es erneut. | ExpectedError | Dieser Fehler kann auftreten, wenn der Benutzer keine Maßnahmen an der Berechtigungsaufforderung des Browsers ergreift, um den Zugriff auf die Kamera zuzulassen. |
43016 | 412 | Video konnte nicht gestartet werden, Berechtigungen, die vom System verweigert wurden. Stellen Sie sicher, dass Videogeräteberechtigungen in den Einstellungen des Browsers und in den Einstellungen des Systems zulässig sind. | ExpectedError | - Stellen Sie sicher, dass Kameraberechtigungen in den Browsereinstellungen und Gerätesystemeinstellungen zulässig sind. - Stellen Sie sicher, dass die Kameras in den Gerätesystemeinstellungen nicht deaktiviert sind. - Stellen Sie unter macOS sicher, dass die Bildschirmaufzeichnung über die Systemeinstellungen zulässig ist. Nützliche Links: - Anfordern von Geräteberechtigungen -Bildschirmfreigabeberechtigungen unter macOS - Aufzählen von Geräten für Safari unter macOS und iOS bzw. Zugreifen auf solche Geräte |
43017 | 412 | Fehler beim Starten des Videos, nicht unterstützter Datenstrom. Versuchen Sie es erneut, wenn das Problem weiterhin besteht, wenden Sie sich an den Azure Communication Services-Support. | UnexpectedClientError | |
43018 | 412 | Fehler beim Starten des Videos. Fehler beim Festlegen von Einschränkungen. Versuchen Sie es erneut, wenn das Problem weiterhin besteht, wenden Sie sich an den Azure Communication Services-Support. | UnexpectedClientError | Weitere Informationen zum Festlegen von Videoeinschränkungen |
43019 | 412 | Video konnte nicht gestartet werden, kein Gerät ausgewählt. Stellen Sie sicher, dass Sie einen LocalVideoStream übergeben, der mit einer VideoDeviceInfo erstellt wurde, und versuchen Sie es erneut. Wenn das Problem weiterhin besteht, wenden Sie sich an den Azure Communication Services-Support. | UnexpectedClientError | Nützliche Links: - Tätigen eines Anrufs mit Videokamera - Starten und Beenden des Sendens eines lokalen Videosignals während eines Anrufs |
43200 | 412 | Fehler beim Rendern des Videostreams. Dieser Datenstrom ist nicht verfügbar. Abonnieren Sie die isAvailable-Eigenschaft des Datenstroms, um benachrichtigt zu werden, wenn der Remoteteilnehmer sein Video aktiviert hat und der Stream zum Rendern verfügbar ist. | ExpectedError | Nützliche Links: - Rendern von Video-/Bildschirmfreigabedatenströmen für Remoteteilnehmer - Hinzufügen von 1:1 Videoanrufen zu Ihrer App - Abonnieren von SDK-Ereignissen |
43202 | 404 | Fehler beim Rendern des Videostreams. Dieser Datenstrom ist nicht mehr verfügbar. Remoteteilnehmer haben ihr Video deaktiviert. | ExpectedError | Der Remoteteilnehmer hat sein Video deaktiviert, während er versucht, eine Ansicht dafür zu erstellen. |
43203 | 408 | Fehler beim Rendern des Videodatenstroms, Beim Rendern auf Videoframes ist ein Timeout aufgetreten. Versuchen Sie es erneut, wenn das Problem weiterhin besteht, wenden Sie sich an den Azure Communication Services-Support. | UnexpectedClientError | |
43204 | 500 | Fehler beim Rendern des Videodatenstroms, Fehler beim Abonnieren von Videos in der Azure Communication Services-Infrastruktur. Versuchen Sie es erneut, wenn das Problem weiterhin besteht, wenden Sie sich an den Azure Communication Services-Support. | UnexpectedClientError | |
43209 | 405 | Fehler beim Rendern des Videostreams, VideoStreamRenderer wurde während des Initialisierungsprozesses verworfen. | ExpectedError | |
43210 | 400 | Fehler beim Löschen von VideoStreamRenderer, da er bereits gelöscht wurde. | ExpectedError | |
43220 | 400 | Fehler beim Erstellen der Ansicht. Die maximale Anzahl der aktiven RemoteVideoStream -Ansichten wurde bereits erreicht. Sie können ein vorheriges löschen, um eine neue zu erstellen. |
ExpectedError | Erfahren Sie mehr darüber , wie Sie die beste Anzahl eingehender Videostreams ordnungsgemäß unterstützen. |
480 | Remoteclientendpunkt ist nicht registriert. | Stellen Sie sicher, dass der Remoteendpunkt verfügbar ist. | ||
481 | Fehler beim Verarbeiten des eingehenden Anrufs. | Reichen Sie eine Supportanfrage über das Azure-Portal ein. | ||
487 | Der Anruf wurde abgebrochen, lokal abgelehnt, aufgrund eines Endpunktkonfliktfehlers beendet, oder das Medienangebot konnte nicht generiert werden. | Erwartetes Verhalten. | ||
490, 491, 496, 497, 498 | Netzwerkprobleme des lokalen Endpunkts. | Überprüfen Sie Ihr Netzwerk. | ||
503, 504 | Communication Services-Infrastrukturfehler. | Reichen Sie eine Supportanfrage über das Azure-Portal ein. | ||
600 | Überall beschäftigt. Teilnehmende Person erfolgreich kontaktiert, aber Besetztzeichen zurückgegeben. | Erwartetes Verhalten. | ||
603 | Anruf global durch remoteteilnehmende Person von Communication Services abgelehnt. | Erwartetes Verhalten. | ||
604 | Ist nicht überall vorhanden. Der angeforderte URI ist nicht vorhanden. | Erwartetes Verhalten. | ||
606 | Nicht akzeptabel. Teilnehmende Person erfolgreich kontaktiert, kann aber die beschriebene Sitzung nicht unterstützen. | Erwartetes Verhalten. |
Grundlegendes beim Aufrufen von Codes und Fehler bei Untercodes
Fehlercodes, Untercodes und entsprechende Ergebniskategorien helfen entwickelnden Fachkräften, Fehler zu identifizieren und zu diagnostizieren. Diese Fehlercodes werden durch die call.callEndReason
-Eigenschaft bereitgestellt, nachdem ein Anruf beendet wurde.
Zu den Fehlercodedetails gehören:
Code – sind dreistellige ganze Zahlen, die den Client- oder Serverantwortstatus darstellen. Die Codekategorien:
- Erfolgreiche Antworten (200–299)
- Clientfehler (400–499)
- Serverfehler (500–599)
- Globaler Fehler (600-699)
Subcode – werden als ganze Zahl definiert, wobei jede Zahl für einen eindeutigen Grund steht, der für eine Gruppe von Szenarien oder ein bestimmtes Szenarioergebnis spezifisch ist.
Nachricht – beschreibt das Ergebnis und bietet Hinweise zur Behebung des Problems, wenn ein Ergebnis ein Fehler ist.
ResultCategory – gibt den Typ des Fehlers an. Je nach Kontext kann der Wert Success
, ExpectedError
, UnexpectedClientError
oder UnexpectedServerError
sein.
Calling-Codes und -Untercodes zum Beenden von Anrufen
Es gibt verschiedene Erklärungen dafür, warum ein Anruf beendet wurde. Hier sind die Bedeutungen der Codes und Untercodes zum Beenden von Anrufen, die zeigen, wie ein Anruf enden kann.
Subcode | Code | `Message` | Ergebniskategorien | Advice |
---|---|---|---|---|
0 | 0 | Der Anruf wurde erfolgreich von einem lokalen Teilnehmer beendet. | Erfolg | |
0 | 487 | Der Anruf wurde erfolgreich beendet, da der Anrufer den Anruf abgebrochen hat. | Erfolg | |
0 | 603 | Der Anruf wurde erfolgreich beendet, da er vom Aufgerufenen abgelehnt wurde. | Erfolgreich | |
3100 | 410 | Bei der Anrufeinrichtung trat aufgrund eines unerwarteten Netzwerkproblems auf dem Client ein Fehler auf. Überprüfen Sie das Netzwerk des Clients, und versuchen Sie es erneut. | UnxpectedClientError | – Stellen Sie sicher, dass Sie das neueste SDK in einer unterstützten Umgebung verwenden. |
3101 | 410 | Der Anruf wurde aufgrund eines unerwarteten Netzwerkproblems auf dem Client beendet. Überprüfen Sie das Netzwerk des Clients, und versuchen Sie es erneut. | UnxpectedClientError | |
3112 | 410 | Bei der Anrufeinrichtung trat aufgrund eines Netzwerkkonfigurationsproblems auf der Clientseite ein Fehler auf. Überprüfen Sie die Netzwerkkonfiguration des Clients, und versuchen Sie es erneut. | ExpectedError | |
4097 | 0 | Der Anruf wurde für alle Benutzer vom Besprechungsorganisator beendet. | Erfolgreich | |
4507 | 495 | Der Anruf wurde beendet, da die Anwendung kein gültiges Azure Communication Services-Token bereitgestellt hat. | UnexpectedClientError | Stellen Sie sicher, dass Ihre Anwendung den Tokenaktualisierungsmechanismus ordnungsgemäß implementiert. |
4521 | 0 | Der Anruf wurde beendet, da der Benutzer die Verbindung mit dem Anruf abrupt getrennt hat. Dies kann dazu führen, dass ein Benutzer die Anwendung schließt, die den Aufruf gehostet hat, z. B. weil er die Anwendung beendet hat, indem er die Browserregisterkarte ohne ordnungsgemäßes Auflegen schließt. | ExpectedError | |
5000 | 0 | Der Anruf wurde für diese teilnehmende Person beendet. Die teilnehmende Person wurde von einer anderen teilnehmenden Person aus der Unterhaltung entfernt. | Erfolgreich | |
5003 | 0 | Der Anruf wurde erfolgreich beendet, da alle Endpunkte des Aufgerufenen den Anruf abgelehnt haben. | Erfolgreich | |
5300 | 0 | Der Anruf wurde für diese teilnehmende Person beendet. Die teilnehmende Person wurde von einer anderen teilnehmenden Person aus der Unterhaltung entfernt. | Erfolgreich | |
5,317 | 0 | Der Zielteilnehmer wird aufgrund der Aktualisierung der Teilnehmerrolle entfernt. | ExpectedError | |
5828 | 403 | Die Teilnahme ist für die Räume-Besprechung nicht autorisiert, da der Benutzer nicht Teil der Liste der eingeladenen Personen ist. | UnexpectedClientError | |
5829 | 403 | Die Teilnahme ist für die Räume-Besprechungen außerhalb der Endzeit oder vor Beginn der Besprechung nicht zulässig. | UnexpectedClientError | |
5830 | 403 | Nur Communication Services-Benutzer dürfen an der Räume-Besprechung teilnehmen. | ExpectedError | |
7000 | 0 | Der Anruf wurde von der Azure Communication Services-Plattform beendet. | Erfolgreich | |
10003 | 487 | Der Anruf wurde an anderer Stelle von einem anderen Endpunkt dieses Benutzers angenommen. | Erfolgreich | |
10004 | 487 | Der Anruf wurde beim Timeout abgebrochen, da kein Endpunkt des Aufgerufenen ihn rechtzeitig angenommen hat. Stellen Sie sicher, dass der Benutzer die Benachrichtigung gesehen hat, und versuchen Sie erneut, diesen Anruf zu initiieren. | ExpectedError | |
10024 | 487 | Der Anruf wurde erfolgreich beendet. Der Anruf wurde von allen Angerufenendpunkten abgelehnt. | Erfolgreich | - Versuchen Sie erneut, den Anruf zu tätigen. |
10057 | 408 | Beim Anruf trat ein Fehler auf. Die angerufene Person konnte die Anrufeinrichtung nicht abschließen. Wahrscheinlich wurde das Netzwerk der angerufenen Person unterbrochen oder die Anwendung abrupt beendet. Stellen Sie sicher, dass die Clients verbunden und verfügbar sind. | ExpectedError | |
301005 | 410 | Die teilnehmende Person wurde aufgrund eines Verlusts der Medienkonnektivität mit derselben Infrastruktur aus dem Anruf der Azure Communication Services-Infrastruktur entfernt. Dies geschieht in der Regel, wenn die teilnehmende Person den Anruf abrupt verlässt oder Netzwerkkonnektivität verliert. Wenn die teilnehmende Person den Anruf fortsetzen möchte, kann sie die Verbindung erneut herstellen. | UnexpectedClientError | Stellen Sie sicher, dass Sie das neueste SDK in einer unterstützten Umgebung verwenden. |
510403 | 403 | Der Anruf wurde beendet, zuvor als Spam gekennzeichnet und jetzt blockiert. | ExpectedError | – Stellen Sie sicher, dass Ihr Communication Services-Token gültig und nicht abgelaufen ist. - Achten Sie darauf, dass Sie in den Aufrufoptionen AlternateId angeben. |
540487 | 487 | Der Anruf wurde erfolgreich beendet, da der Anrufer den Anruf abgebrochen hat. | Erfolgreich | |
560000 | 0 | Der Anruf wurde von einem Remote-PSTN-Teilnehmer erfolgreich beendet. | Erfolgreich | Mögliche Ursachen: – Der Benutzer hat den Anruf beendet. – Anruf wurde vom Medienagenten beendet. |
560486 | 486 | Der Anruf wurde beendet, weil der Remote-PSTN-Teilnehmer beschäftigt war. Die angerufene Nummer befand sich bereits in einem Anruf oder hatte technische Probleme. | ||
404 | Anruf nicht gefunden. | Stellen Sie sicher, dass die Telefonnummer, die Sie anrufen (oder die Telefonkonferenz, der Sie beitreten möchten), vorhanden ist. | ||
408 | Timeout des Anrufcontrollers. | Timeout des Anrufcontrollers beim Warten auf Protokollmeldungen von Benutzerendpunkten. Stellen Sie sicher, dass die Clients verbunden und verfügbar sind. | ||
410 | Fehler des lokalen Medienstapels oder der Medieninfrastruktur. | Stellen Sie sicher, dass Sie das neueste SDK in einer unterstützten Umgebung verwenden. | ||
430 | Nachricht kann nicht an die Clientanwendung übermittelt werden. | Stellen Sie sicher, dass die Clientanwendung ausgeführt wird und verfügbar ist. | ||
480 | Remoteclientendpunkt ist nicht registriert. | Stellen Sie sicher, dass der Remoteendpunkt verfügbar ist. | ||
481 | Fehler beim Verarbeiten des eingehenden Anrufs. | Reichen Sie eine Supportanfrage über das Azure-Portal ein. | ||
490, 491, 496, 497, 498 | Netzwerkprobleme des lokalen Endpunkts. | Überprüfen Sie Ihr Netzwerk. | ||
500, 503, 504 | Communication Services-Infrastrukturfehler. | Reichen Sie eine Supportanfrage über das Azure-Portal ein. |
Fehlercodes für das Anrufautomatisierungs-SDK
Die folgenden Fehlercodes werden vom Anrufautomatisierungs-SDK verfügbar gemacht.
SubCode | Code | `Message` | Ergebniskategorien | Advice |
---|---|---|---|---|
400 | Bad request (Ungültige Anforderung) | Die Eingabeanforderung ist ungültig. Sehen Sie sich die Fehlermeldung an, um zu bestimmen, welche Eingabe falsch ist. | ||
400 | Fehler beim Wiedergeben | Vergewissern Sie sich, dass Ihre Audiodatei im Format WAV, mit 16 KHz oder in Mono vorliegt und dass die Datei-URL öffentlich zugänglich ist. | ||
400 | Fehler erkannt | Überprüfen Sie die Fehlermeldung. In der Meldung wird hervorgehoben, ob dieser Fehler darauf zurückzuführen ist, dass das Timeout erreicht wurde oder ob der Vorgang abgebrochen wurde. Weitere Informationen zu den Fehlercodes und Meldungen finden Sie unter Sammeln von Benutzereingaben. | ||
401 | Nicht autorisiert | Fehler bei der HMAC-Authentifizierung. Überprüfen Sie, ob die zum Erstellen von CallAutomationClient verwendete Verbindungszeichenfolge korrekt ist. | ||
403 | Verboten | Die Anforderung ist unzulässig. Vergewissern Sie sich, dass Sie Zugriff auf die Ressource haben, auf die Sie zugreifen möchten. | ||
404 | Ressource nicht gefunden | Der Anruf, auf den Sie reagieren möchten, ist nicht vorhanden. Beispielsweise durch das Übertragen eines Anrufs, der zuvor getrennt wurde. | ||
429 | Zu viele Anforderungen | Wiederholen Sie den Vorgang nach einer Wartezeit, die im Retry-After-Header vorgeschlagen wurde, und nehmen Sie dann ein exponentielles Backoff vor. | ||
500 | Interner Server-Fehler | Wiederholen Sie den Vorgang nach einer Wartezeit. Wenn der Fehler weiterhin besteht, legen Sie ein Supportticket an. | ||
500 | Fehler beim Wiedergeben | Reichen Sie eine Supportanfrage über das Azure-Portal ein. | ||
500 | Fehler erkannt | Überprüfen Sie die Fehlermeldung, und bestätigen Sie, dass das Audiodateiformat gültig ist (WAV, 16 KHz, Mono). Wenn das Dateiformat gültig ist, reichen Sie eine Supportanfrage über das Azure-Portal ein. | ||
502 | Ungültiger Gateway | Wiederholen Sie den Vorgang nach einer Wartezeit mit einem neuen HTTP-Client. | ||
503,504 | Communication Services-Infrastrukturfehler. | Reichen Sie eine Supportanfrage über das Azure-Portal ein. |
PSTN-Anrufantwortcodes mit ParticipantEndReason
Dieser Abschnitt enthält Informationen zur Problembehandlung für verschiedene Kombinationen der Antwortcodes ParticipantEndReason
und ParticipantEndSubCode
. Für die Tabellen in diesem Abschnitt, ParticipantEndReason
= Code und ParticipantEndSubCode
= SubCode.
ParticipantEndReason 0
Die Antwort ParticipantEndReason
mit dem Wert 0 bedeutet in der Regel eine normale Anrufabwicklung und kennzeichnet Anrufe, die ohne Fehler abgeschlossen wurden.
SubCode | Code | `Message` | Ergebniskategorien | Advice |
---|---|---|---|---|
0 | 0 | Der Anruf wurde erfolgreich von einem lokalen Teilnehmer beendet. | Erfolgreich | |
560000 | 0 | Normales Ende des PSTN-Anrufs: – Der Benutzer hat den Anruf beendet. - Anruf wurde vom Medienagenten beendet. |
Erfolgreich | |
540000 | 0 | Normales Ende des PSTN-Anrufs: – Der Benutzer hat den Anruf beendet. - Anruf wurde vom Medienagenten beendet. |
Erfolgreich |
ParticipantEndReason 4xx
Die Antwort ParticipantEndReason
mit dem Wert 4xx bedeutet, dass der Anruf nicht zustande gekommen ist.
SubCode | Code | `Message` | Ergebniskategorien | Advice |
---|---|---|---|---|
510403 | 403 | Anruf blockiert: - Alternative ID für den Anruf nicht angegeben. - Telefonnummern, die vom Session Border Controller (SBC) der benutzenden Person nicht zulässig sind. |
- Weitere Informationen zur alternativen ID finden Sie unter Verwalten von Anrufen. - Stellen Sie sicher, dass Sie eine gültige alternative ID angegeben haben. Es muss sich um eine Telefonnummer handeln, die zur Ressource gehört, die Sie verwenden. - Stellen Sie sicher, dass Sie die besitzende Person der Ressource sind, die Sie zum Tätigen eines Anrufs verwenden. - Überprüfen Sie bei Direct Routing-Anrufen, warum Ihr Session Border Controller den Anruf nicht zugelassen hat. |
|
560403 | 403 | - Anruf verboten. - Anruf abgebrochen. - Anruf abgelehnt. |
Stellen Sie sicher, dass Sie eine gültige Telefonnummer im richtigen Format aufgerufen haben. Weitere Informationen zu unterstützten Zahlenformaten finden Sie unter https://en.wikipedia.org/wiki/E.164. | |
511532 | 403 | Die Ressourcen-SIP-Trunkkonfiguration wurde nicht gefunden. | Überprüfen Sie die Einrichtung Ihres direkten Routings im Azure-Portal. Weitere Informationen finden Sie unter Direct Routing-Bereitstellung. | |
560404 | 404 | - Telefonnummer nicht gefunden. - Telefonnummer, die keinem Ziel zugewiesen ist. - Telefonnummer, die vom Session Border Controller nicht zulässig ist. |
- Stellen Sie sicher, dass die Telefonnummer zu der Ressource gehört, die Sie verwenden, und dass Sie die besitzende Person der Ressource sind. - Überprüfen Sie, ob die Nummer, die Sie aufrufen, vorhanden ist und dem gültigen Ziel zugewiesen ist. |
|
511404 | 404 | - Telefonnummer nicht gefunden. - Die Ressource, die im Aufruf verwendet wird, wurde nicht gefunden. |
- Stellen Sie sicher, dass sie eine Telefonnummer verwendet haben, die zu der Ressource gehört, die Sie verwenden, und dass Sie die besitzende Person der Ressource sind. - Überprüfen Sie, ob die Nummer, die Sie aufrufen, vorhanden ist und dem gültigen Ziel zugewiesen ist. - Stellen Sie sicher, dass die Ressource, die Sie für den Anruf verwenden, nicht gelöscht oder deaktiviert ist. - Stellen Sie sicher, dass Ihre Azure-Abonnements nicht gelöscht oder deaktiviert sind. |
|
560408 | 408 | Die angerufene Partei reagierte nicht innerhalb des vorgeschriebenen Zeitraums auf eine Anrufeinrichtungsnachricht. | - Überprüfen Sie, warum die angerufene Partei nicht reagiert hat. – Überprüfen Sie für Direct Routing-Anrufe Ihre SBC-Protokolle (Session Border Controller) und -Einstellungen sowie die Timeoutkonfiguration. |
|
500001 | 408 | Benutzergatewaytimeout Azure Communication Services hat innerhalb eines bestimmten Zeitlimits keine Antwort vom Client erhalten und die Anforderung beendet. |
- Überprüfen Sie, warum die angerufene Partei nicht reagiert hat. – Überprüfen Sie für Direct Routing-Anrufe Ihre SBC-Protokolle und -Einstellungen sowie die Timeoutkonfiguration. |
|
531004 | 410 | Die Überprüfungen der Interactive Connectivity Establishment (ICE) sind fehlgeschlagen. | - Der Medienpfad konnte nicht erstellt werden. Kann durch falsche Netzwerkkonfiguration verursacht werden. Überprüfen Sie Ihre Netzwerkkonfiguration, um sicherzustellen, dass die erforderlichen IP-Adressen und Ports nicht blockiert sind. Lesen Sie die Richtlinien in https://www.rfc-editor.org/rfc/rfc5245#section-7. – Überprüfen Sie bei Direct Routing-Anrufen die SBC-Protokolle und -Einstellungen für ICE-Konfiguration und -Profil. Wenden Sie sich an Ihren SBC-Anbieter, um Hilfe zur Konfiguration zu haben. Weitere Informationen finden Sie in der Liste der für das Direct Routing von Azure Communication Services zertifizierten Session Border Controller. |
|
560480 | 480 | - Keine Antwort von der angerufenen benutzenden Person. - Die angerufene benutzende Benutzer ist nicht verfügbar. |
- Überprüfen Sie, warum die angerufene Partei nicht reagiert hat. - Versuchen Sie den Anruf später erneut, falls die angerufene Partei vorübergehend nicht verfügbar war. – Überprüfen Sie für Direct Routing-Anrufe Ihre SBC-Protokolle und -Einstellungen sowie die Timeoutkonfiguration. |
|
560484 | 484 | - Unvollständige oder ungültige Adresse der angerufenen Partei. - Unvollständiges oder ungültiges Zahlenformat der angerufenen Partei. |
- In einigen Fällen können Sie diese Fehler ignorieren, da die benutzende Person eine ungültige Nummer wählt. - Stellen Sie sicher, dass die Telefonnummern richtig formatiert sind. Weitere Informationen finden Sie unter https://en.wikipedia.org/wiki/E.164. - Bei Direct Routing kann der SBC diese Fehler aufgrund einer fehlenden Konfiguration in einem Anrufdurchstellungsszenario verursachen. |
|
60486 | 486 | Die angerufene Nummer war besetzt | - Die angerufene Nummer kann mit einem vorhandenen Anruf verbunden sein oder ein technisches Problem haben. – Überprüfen Sie für Direct Routing-Anrufe Ihre SBC-Protokolle und -Einstellungen sowie die Timeoutkonfiguration. |
|
540487 | 487 | Die anrufende Person hat die Anrufanforderung beendet. | Wiederholen Sie den Anruf. | |
560487 | 497 | - Die anrufende Person hat die Anrufanforderung beendet. - Anforderung, die mit der normalen Anruflöschung beendet wurde. |
Wiederholen Sie den Anruf. |
ParticipantEndReason 5xx
Die Antwort ParticipantEndReason
mit dem Wert 5xx bedeutet, dass der Anruf aufgrund eines Problems mit einer Software- oder Hardwarekomponente, die für den Abschluss der Verbindung erforderlich ist, fehlgeschlagen ist.
SubCode | Code | `Message` | Ergebniskategorien | Advice |
---|---|---|---|---|
560500 | 500 | Ein interner Serverfehler ist in einem der dienste aufgetreten, die am Aufruf beteiligt sind. | - Wiederholen Sie den Anruf. Wenn das Problem weiterhin besteht, wenden Sie sich an Ihren Telco-Anbieter oder an den Microsoft-Support. – Überprüfen Sie bei Direct Routing-Anrufen die SBC-Protokolle und -Einstellungen sowie die Timeoutskonfiguration, um festzustellen, ob Ihr SBC den Fehler verursacht hat. |
|
560503 | 503 | - Der Anruf ist aufgrund eines internen Serverfehlers in einem der Dienste fehlgeschlagen, die am Anruf beteiligt sind. - Das Netzwerk, das zum Einrichten des Anrufs verwendet wird, ist nicht ordnungsgemäß. - Ein vorübergehender Fehler in einem der Dienste, die am Anruf beteiligt sind. |
- Überprüfen Sie Ihre Netzwerk- und Routingkonfiguration auf mögliche Probleme. Stellen Sie sicher, dass Ihre Netzwerkfirewallregeln korrekt sind. - Wiederholen Sie den Anruf. Wenn das Problem weiterhin besteht, wenden Sie sich an Ihren Telekommunikationsanbieter oder an den Microsoft-Support. – Überprüfen Sie bei Direct Routing-Anrufen die SBC-Protokolle und -Einstellungen sowie die Timeoutskonfiguration, um festzustellen, ob Ihr SBC den Fehler verursacht hat. |
ParticipantEndReason 603
Die Antwort ParticipantEndReason
mit dem Wert 603 bedeutet, dass der Anruf ohne Verbindung abgewiesen wurde.
SubCode | Code | `Message` | Ergebniskategorien | Advice |
---|---|---|---|---|
560603 | 603 | - Der Anruf wurde vom Empfänger abgelehnt. - Der Anruf wurde aufgrund der Betrugserkennung abgelehnt. |
- Wenn der Empfänger den Anruf abgelehnt hat, wiederholen Sie den Anruf. - Stellen Sie sicher, dass Sie nicht die maximale Anzahl gleichzeitiger Anrufe überschreiten, die für Ihre Azure Communication Services-Telefonnummer zulässig sind. Weitere Informationen finden Sie unter Einschränkungen für PSTN-Anrufe. |
Fehlercodes des Chat SDK
Die Chat SDK verwendet die folgenden Fehlercodes, um Sie beim Beheben von Chatproblemen zu unterstützen. Die Fehlercodes werden über die error.code
-Eigenschaft in der Fehlerantwort verfügbar gemacht.
Code | `Message` | Advice |
---|---|---|
401 | Nicht autorisiert | Stellen Sie sicher, dass Ihr Communication Services-Token gültig und nicht abgelaufen ist. |
403 | Verboten | Stellen Sie sicher, dass der Initiator der Anforderung Zugriff auf die Ressource hat. |
429 | Zu viele Anforderungen | Stellen Sie sicher, dass Ihre clientseitige Anwendung dieses Szenario benutzerfreundlich behandelt. Wenn der Fehler weiterhin auftritt, reichen Sie eine Supportanfrage ein. |
503 | Dienst nicht verfügbar | Reichen Sie eine Supportanfrage über das Azure-Portal ein. |
SMS-Fehlercodes
Die SMS SDK verwendet die folgenden Fehlercodes, um Sie beim Beheben von SMS-Problemen zu unterstützen. Die Fehlercodes werden über das Feld DeliveryStatusDetails
im SMS-Übermittlungsbericht verfügbar gemacht.
Code | `Message` | Advice |
---|---|---|
2.000 | Nachricht erfolgreich übermittelt. | |
4000 | Nachricht wird aufgrund von Betrugserkennung abgelehnt. | Stellen Sie sicher, dass Sie die maximal zulässige Anzahl von Nachrichten nicht überschreiten. |
4001 | Die Meldung wird aufgrund eines ungültigen Quell-/Von-Zahlenformats abgelehnt. | Stellen Sie sicher, dass die An-Zahl im E.164-Format und das Von-Zahlenformat im E.164- oder Kurzcodeformat vorliegt. |
4002 | Die Meldung wird aufgrund eines ungültigen Ziel-/An-Zahlenformats abgelehnt. | Stellen Sie sicher, dass die An-Nummer im E.164-Format vorliegt. |
4003 | Nachricht konnte aufgrund eines nicht unterstützten Ziels nicht übermittelt werden. | Überprüfen Sie, ob das Ziel, an das Sie senden möchten, unterstützt wird. |
4004 | Die Nachricht konnte nicht übermittelt werden, da die Ziel-/An-Nummer nicht vorhanden ist. | Stellen Sie sicher, dass die An-Nummer, an die Sie senden möchten, gültig ist. |
4005 | Nachricht wird vom Zielnetzbetreiber blockiert. | |
4006 | Die Ziel-/An-Nummer ist nicht erreichbar. | Versuchen Sie, die Nachricht zu einem späteren Zeitpunkt erneut zu senden. |
4007 | Die Ziel-/An-Nummer hat den Empfang von Nachrichten von Ihnen deaktiviert. | Markieren Sie die Ziel-/An-Nummer als deaktiviert, sodass keine weiteren Nachrichtenversuche an die Nummer vorgenommen werden. |
4008 | Sie haben die maximale Anzahl von Nachrichten überschritten, die für Ihr Profil zulässig ist. | Stellen Sie sicher, dass Sie die maximal zulässige Anzahl von Nachrichten nicht überschreiten, oder verwenden Sie Warteschlangen, um die Nachrichten im Batch zu verarbeiten. |
4009 | Die Nachricht wird vom Microsoft-Berechtigungssystem abgelehnt. | Dies geschieht am häufigsten, wenn betrügerische Aktivitäten erkannt werden. Wenden Sie sich an den Support, um weitere Informationen zu erhalten. |
4010 | Die Nachricht wurde blockiert, weil die gebührenfreie Nummer ungeprüft ist | Überprüfen Sie nicht überprüfte Sendegrenzwerte, und reichen Sie die gebührenfreie Nummer so schnell wie möglich zur Überprüfung ein. |
5000 | Die Nachricht konnte nicht gesendet werden. Wenden Sie sich an das Microsoft-Supportteam, um weitere Informationen zu erhalten. | Reichen Sie eine Supportanfrage über das Azure-Portal ein. |
5001 | Nachricht konnte aufgrund einer vorübergehenden Nichtverfügbarkeit der Anwendung/des Systems nicht übermittelt werden. | |
5002 | Der Versandbericht wird vom Netzbetreiber nicht unterstützt | Dies passiert meistens, wenn ein Netzbetreiber keine Versandbericht unterstützt. Es ist keine Aktion erforderlich, da die Nachricht möglicherweise bereits übermittelt wurde. |
9999 | Nachricht konnte aufgrund eines unbekannten Fehlers nicht übermittelt werden. | Versuchen Sie, die Nachricht erneut zu senden. |