Freigeben über


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 und Redirect zu Telefonnummern müssen Sie SourceCallerId 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.