Voice-Fehlerbehebung
Beginnen Sie mit dem Anrufprotokoll. Ob ein Eintrag vorhanden ist und welche Felder er enthält, bestimmt die weiteren Prüfschritte.
Ein ausgehender Anruf fehlt im Anrufprotokoll
Ein Anruf, den Bird nicht zulassen kann, wird auf der SIP-Schicht abgewiesen, bevor ein Eintrag entsteht. Fünf Ursachen kommen infrage:
- 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. Kopieren Sie die Domain vollständig von der Trunk-Seite, anstatt sie zusammenzusetzen.
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 kein Ziel zeigt. 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:
- Lesen Sie die Inbound route des Anrufs. Sie zeigt, auf welchen Trunk oder welche Weiterleitung die Nummer zum Zeitpunkt des Anrufs gerichtet war. Eine reject-Route bedeutet, dass die Nummer auf nichts gerichtet war – dort landet eine Nummer auch, wenn ihr Trunk gelöscht wird oder eingehende Anrufe deaktiviert wurden.
- Prüfen Sie, ob der Trunk ein Gateway hat. Ein Trunk ohne Zustellungs-Gateway lehnt jeden Anruf an die von ihm beantworteten Nummern ab, und der Eintrag lautet no_route_found. Fügen Sie eines unter Inbound calling auf der Trunk-Seite hinzu.
- Prüfen Sie die Gateway-Adresse. Bird wählt die Gateways in Prioritätsreihenfolge an und gibt auf, wenn keines antwortet. Bestätigen Sie den SIP-URI-Host, seinen Port und dass Ihr Telefonsystem Anrufe von Bird darauf annimmt.
- 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.
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.
Nächste Schritte
| Seite | Themen |
|---|---|
| Anrufprotokoll | Jedes Feld eines Anrufeintrags und jeder Ablehnungsgrund |
| SIP-Trunks | IP-Freigabeliste, Schlüssel, Sitzungszugangsdaten und Digest |
| SIP-Client-Einrichtung | Die Einstellungen, die jedes Softphone und jede PBX abfragt |
| Anrufe tätigen | Was Bird auf dem INVITE erwartet und wie der Handshake abläuft |
| Anrufe empfangen | Eine Nummer auf einen Trunk oder eine Weiterleitung richten und was dabei protokolliert wird |
Verwandte Ressourcen
Weiter mit der Dokumentation, Anleitungen und Beispielen zu diesem Thema. Die Ressourcen sind auf Englisch.
Das Konzept verstehenWhat is a voice API?Die Funktion erkundenVoiceImplementierungsleitfadenVoice overview
Implementierungs-Briefing erhalten