Voice-Fehlerbehebung

Beginnen Sie mit dem Anrufprotokoll. Ob ein Eintrag vorhanden ist und welche Felder er enthält, bestimmt die weiteren Prüfschritte.

Prüfen Sie bei Anrufen, die über die API gestartet wurden, zuerst die Create Call-Antwort und den Ausführungsverlauf. Nutzen Sie die Fehlerbehebung für Sequenzen bei Problemen mit Vorschau, Veröffentlichung, Tastenpfaden und eingehenden Sequenzrouten. Die folgenden Verbindungsprüfungen betreffen Anrufe über SIP-Trunks.

Wenn Sie überhaupt keine Anrufeinträge sehen, prüfen Sie zuerst Folgendes:

1. Sie sind im richtigen Workspace. Anrufeinträge gehören zu dem Workspace, der die Nummer oder den Trunk enthält. Wechseln Sie dorthin und öffnen Sie dann Voice > Legs.
2. Der Anruf hat Bird erreicht. Bei einem eingehenden Anruf entscheidet der Netzbetreiber des Anrufers, wohin der Anruf geht, und eine Nummer, die auf einen Trunk ohne gespeichertes Gateway verweist, weist den Anruf ab, bevor ein Eintrag existiert. Bei einem ausgehenden Anruf siehe Ein ausgehender Anruf fehlt im Anrufprotokoll: Eine abgelehnte Zulassung hinterlässt keinen Eintrag.
3. Die Filter blenden ihn nicht aus. Entfernen Sie den Statusfilter und erweitern Sie den Datumsbereich.

Ein ausgehender Anruf fehlt im Anrufprotokoll

Bei einem Anruf über einen SIP-Trunk kann ein Zulassungsfehler auftreten, bevor ein Leg-Eintrag existiert. Prüfen Sie diese häufigen Ursachen:

• Der Trunk überträgt noch keine ausgehenden Anrufe. Ein neuer Trunk überträgt keine Anrufe, bis Sie auf seiner Seite ausgehende Anrufe aktivieren, und er weist jeden Versuch ab, egal welche Zugangsdaten der Anruf mitbringt.
• Der Trunk kann Sie noch nicht identifizieren. Ein neuer Trunk lehnt jeden Anruf ab, bis Sie einen IP-Bereich, einen erlaubten API-Schlüssel oder Sitzungszugangsdaten hinzufügen.
• Der Anruf kam von einer Adresse außerhalb der IP-Freigabeliste des Trunks. Hinter NAT vergleichen Sie die öffentliche Adresse des Routers mit der IP-Freigabeliste des Trunks. Die private Adresse des Telefonsystems erreicht Bird nicht.
• Die Passwort-Challenge ist fehlgeschlagen. Prüfen Sie, ob der Benutzername bird ist. Das Passwort muss ein erlaubtes API-Schlüssel-Secret oder ein nicht abgelaufenes Sitzungszugangsdatum sein. Der Trunk muss außerdem den Digest-Algorithmus anbieten, den Ihr Telefonsystem verwendet hat.
• Der Anruf war an eine SIP-Domain adressiert, die Bird nicht erkennt. Ihre Geräte müssen die SIP-Domain des Trunks als Host in der Request-URI eintragen. Kopieren Sie die Domain vollständig von der Trunk-Seite, anstatt sie zusammenzusetzen. Ein Anruf an einen anderen Bird-Hostnamen oder eine andere Adresse erreicht Ihren Trunk nicht.

Was Ihre Geräte zurückerhalten, zeigt, welche Prüfung fehlgeschlagen ist. 407 Proxy Authentication Required bedeutet, dass der Trunk ein Passwort verlangt; bei aktivierten Sitzungszugangsdaten verlangt er es von jedem Anrufer. 403 Forbidden bedeutet, dass der Trunk den Anruf nicht zugelassen hat: Der Host der Request-URI ist nicht die SIP-Domain Ihres Trunks, ausgehende Anrufe sind deaktiviert, die Adresse liegt außerhalb der Freigabeliste oder das Passwort wurde nicht bestätigt. 503 Auth Unavailable bedeutet, dass Bird den Anruf nicht prüfen konnte. Versuchen Sie ihn also erneut.

Prüfen Sie bei einem Sequenzanruf zuerst, ob die Anrufanfrage akzeptiert wurde und ob eine Ausführung existiert. Eine Simulatorvorschau tätigt keinen Anruf. Ein echter Test erfordert einen gespeicherten Entwurf oder eine aktive Veröffentlichung, Schreibberechtigungen für Voice-Verwaltung und Anrufe, eine geeignete Anrufer-ID und ein aktiviertes Ziel. Der Leitfaden zum Sequenz-Builder erläutert diese Prüfungen.

Der Anruf wird mit einem Ablehnungsgrund abgelehnt

Bird hat den Anruf abgelehnt, bevor ein Carrier angewählt wurde, und der Grund nennt die fehlgeschlagene Prüfung. Öffnen Sie den Anruf und nutzen Sie den Link im Ablehnungspanel zur betreffenden Einstellung. Abgelehnte Anrufe listet jeden Grund und seine Lösung auf.

caller_id_not_verified ist der Grund, auf den neue Clients am häufigsten stoßen – meist weil der Client den Digest-Benutzernamen dort einträgt, wo die Anrufer-ID hingehört: Die beiden sind unterschiedliche Felder.

Der Anruf ist fehlgeschlagen statt abgelehnt

Failed ist keine Ablehnung. Der Anruf wurde versucht und hat nicht funktioniert, und SIP response enthält den zurückgegebenen Code. Ein 486 ist eine besetzte Nummer, ein 404 eine nicht vergebene. Das deutet in der Regel auf die gewählte Nummer hin, nicht auf Ihre Konfiguration.

Ein Anruf, den Bird abgelehnt hat, ist Rejected, nicht Failed. Filtern Sie das Protokoll also auf Rejected, wenn Sie einen Anruf suchen, der eine der Prüfungen von Bird nicht bestanden hat.

Der Anruf wird ohne Ablehnungsgrund abgelehnt

Bei einem ausgehenden Anruf hat die Gegenseite ihn direkt abgelehnt, und SIP response enthält deren Code.

Bei einem eingehenden Anruf hat die angerufene Nummer den Anruf abgewiesen, was keine Prüfung verletzt und daher keinen Grund angibt. Öffnen Sie den Anruf und lesen Sie Inbound route: Eine reject-Route ist eine Nummer, die auf Ablehnung gesetzt ist, oder eine ohne eigene Route, deren Workspace-Standardroute auf Ablehnung steht. Anrufe empfangen behandelt jede eingehende Ablehnung nach Route und Grund.

Die angerufene Person hat eine andere Nummer gesehen

Der Anruf hat einen Eintrag und keinen Ablehnungsgrund, hat also jede Prüfung von Bird bestanden. Das Problem liegt hinter Bird: Der terminierende Netzbetreiber hat die Anrufer-ID ersetzt oder einen Anruf abgelehnt, der sie präsentiert. Dieselbe Ursache zeigt sich, wenn eine Nummer in einem Land verbindet und in einem anderen nie.

Verifizierung beweist, dass Sie eine Anrufer-ID kontrollieren. Sie verpflichtet den Netzbetreiber, der den Anruf zustellt, nicht, ihn anzunehmen, und Netzbetreiber wenden ihre eigenen nationalen Regeln auf eine Nummer an, die nicht über Bird beschafft wurde. Siehe den Haftungsausschluss zur CLI-Verifizierung und -Zustellung für die relevanten Verfahren, darunter landesspezifische CLI-Anforderungen, herkunftsbasierte Sperrung und Do-Not-Originate-Listen.

Um festzustellen, welche Art von Nummer Sie präsentiert haben, öffnen Sie sie unter Voice > Numbers und lesen Sie das Panel oben auf der Seite. Eine Nummer, die Sie bei Bird gekauft haben, zeigt ihr Abonnement an, ebenso eine, die Sie gekauft und zusätzlich verifiziert haben. Nur eine Nummer, die Sie anderswo besitzen, zeigt ausschließlich eine Verifizierung. Ein Abonnement bedeutet, dass die Nummer über Bird beschafft wurde, sodass der Haftungsausschluss nicht greift. Eine über Bird beschaffte Nummer zu präsentieren ist das, was die Zustell- und Verbindungsraten bei Zielen erhöht, die eine verifizierte Nummer ablehnen.

Ein eingehender Anruf erreicht Ihr Telefonsystem nicht

Die Nummer hat den Anruf angenommen, und die Zustellung ist fehlgeschlagen. Prüfen Sie in dieser Reihenfolge:

1. Lesen Sie die Inbound-Route des Anrufs. Sie zeigt, auf welchen Trunk oder welche Weiterleitung die Nummer zum Zeitpunkt des Anrufs verwiesen war. Eine reject-Route bedeutet, dass die Nummer eine eigene Route hat, die auf Ablehnen gesetzt ist, oder keine eigene Route besitzt, während die Workspace-Standardroute auf Ablehnen steht. Öffnen Sie die Nummer, um zu sehen, was zutrifft: Eine Nummer, die auf Ablehnen gesetzt ist, ignoriert die Standardroute. Eine Nummer, deren Trunk gelöscht wurde oder bei der eingehende Anrufe deaktiviert sind, fällt auf die Standardroute zurück, und eine Standardroute, die diesen Trunk benennt, fällt wiederum auf Ablehnen zurück.
2. Prüfen Sie, ob der Trunk zustellen kann. Öffnen Sie Inbound routing des Trunks. Ein Gateway muss einer Gruppe angehören, und die Default route (oder eine Regel) muss Anrufe an diese Gruppe senden. Eine auf Reject gesetzte Standardroute lehnt jeden Anruf ohne Ablehnungsgrund ab, und ein Trunk ohne gespeichertes Gateway weist den Anruf ab, bevor ein Eintrag existiert. Beheben Sie die Warnung Calls never reach some gateways, wenn das Dashboard sie beim Speichern anzeigt.
3. Prüfen Sie die Gateway-Adresse. Bird wählt die Gateways der Gruppe in der von der Gruppe festgelegten Reihenfolge an und gibt auf, wenn keines antwortet. Bestätigen Sie den SIP-URI-Host, seinen Port und dass Ihr Telefonsystem dort Anrufe von Bird annimmt.
4. Bei einer Weiterleitung prüfen Sie, ob das Ziel noch verifiziert ist. Das Weiterleitungsziel wird bei jedem Anruf erneut geprüft. Eine Anrufer-ID, die Sie entfernt haben, stoppt die Weiterleitung ab diesem Zeitpunkt.
5. Prüfen Sie die Antwort Ihrer Geräte. Ein Anruf, der Ihr Gateway erreicht hat und dort abgelehnt wurde, ist meist Failed (eine 6xx-Antwort erscheint als Rejected), und SIP response enthält den Code Ihrer Geräte, etwa 403 oder 412. Bird hat den Anruf versucht, die Lösung liegt also bei Ihnen: Prüfen Sie, ob Ihr SBC Anrufe von den Signalisierungsadressen von Bird annimmt und das Nummernformat akzeptiert, das das Gateway sendet.

Wenn die Nummer Run a sequence verwendet, prüfen Sie statt des Trunks die gebundene Sequenz und den Anrufeinstieg. Bestätigen Sie eine aktive Veröffentlichung, einen Einstieg, der leere Daten akzeptiert, und ob der Anrufer ein Entwurfstester ist. Prüfen Sie das Ausführungsergebnis und den Fehlerzweig der Sequenz. Das Ändern eines Entwurfs ändert nicht die Version, die reguläre Anrufer verwenden.

Das Browser-Telefon klingelt nicht oder kann nicht wählen

Prüfen Sie zuerst den Status unten im Telefon:

1. Wählen Sie Online, damit Sie angerufen werden. Eine Ringgruppe überspringt Mitglieder, die Offline oder Busy sind, bereits telefonieren oder nach drei verpassten Anrufen in Folge Not accepting calls sind. Ihr Status erklärt jeden Status.
2. Gehen Sie online, um anzurufen. Ein Telefon im Status Offline kann keine Anrufe tätigen. Im Status Online, Busy und Not accepting calls ist das möglich.
3. Holen Sie die Anrufe in diesen Browser. In jedem Workspace sind Sie immer nur auf einem Gerät und in einem Tab gleichzeitig online. Offline · Active on another device bietet Take over an, und Offline · Calls are handled in another tab bietet Use here an.
4. Prüfen Sie das Limit für Online-Benutzer. Offline · Limit of users online reached bedeutet, dass in Ihrer Organisation bereits so viele Benutzer online sind, wie sie zulässt. Siehe Limit für Online-Benutzer.
5. Schalten Sie den Ton ein. Nach einem Neuladen blockiert Ihr Browser den Klingelton möglicherweise, bis Sie mit der Seite interagieren. Das Statusmenü bietet dann Turn on sound an.

Wenn das Telefon online ist und ein Anruf trotzdem nicht bei Ihnen klingelt, lesen Sie im Anrufprotokoll die Inbound route des Anrufs. Sie nennt die Ringgruppe, bei der der Anruf geklingelt hat. So können Sie prüfen, ob Sie Mitglied sind und ob die Nummer an diese Gruppe weiterleitet.

Ihr Client antwortet mit MD5 und kommt nicht weiter

Manche Geräte verarbeiten eine Challenge, die mit SHA-256 beginnt, fehlerhaft. Setzen Sie den Trunk auf Nur MD5.

Anrufe verbinden sich, aber das Audio ist einseitig

Ihr Client befindet sich hinter NAT, und seine Medien gehen an eine private Adresse. Aktivieren Sie NAT- oder STUN-Handling im Client.

Wenn Ihre Geräte erreichbar sind und das Audio trotzdem in einer Richtung ausfällt, prüfen Sie, ob Ihre Firewall die Medienadressen von Bird auf den UDP-Ports 2500 bis 32499 zulässt.

Nächste Schritte