Ein Rückruf, ein Telefonmenü und ein Sprachassistent nutzen unterschiedliche Teile einer Telefonieplattform.
Was kann eine Voice-API steuern?
Eine Voice-API kann Konfiguration, Anrufsteuerung und Reporting bereitstellen, wobei der Anbieter die unterstützten Operationen festlegt.
Konfiguration umfasst Trunks, Anruferidentitäten, Ziele und Nummernrouting. Anrufsteuerung umfasst das Verhalten innerhalb eines Gesprächs, etwa Ansagen oder Tastatureingaben. Reporting liefert den Status, die Dauer und andere aufgezeichnete Ergebnisse des Anrufs.
Anbieter drücken Anrufsteuerung unterschiedlich aus. Twilios TwiML beschreibt Aktionen beispielsweise über Anweisungen, die an Twilio zurückgegeben werden. Eine Anwendung zu migrieren bedeutet daher, ihr Verhalten und ihre Callback-Erwartungen abzubilden, nicht nur einen Hostnamen zu ersetzen.
Eine Methode, die einen Anruf liest, ist keine Operation, die einen Anruf startet.
Wie arbeiten eine API und SIP zusammen?
Eine Anwendungs-API kann einen Dienst konfigurieren oder steuern, während SIP die Telefonsitzung darunter aufbaut.
SIP, das Signalisierungsprotokoll für Anrufe, erstellt, ändert und beendet Sitzungen. Es handelt aus, wie Teilnehmer verbunden werden. RTP transportiert Echtzeitmedien wie Audio.
Die Pfade können unabhängig voneinander ausfallen. Ein Anruf kann klingeln, während eine Medieneinstellung oder ein Netzwerkpfad verhindert, dass ein Teilnehmer den anderen hört. Testen Sie Audio in beide Richtungen ebenso wie Klingeln und Auflegen.
Eine PBX, die geschäftliche Telefonanlage, die Anrufe weiterleitet, kann ihre Anrufbehandlung beibehalten und dabei die SIP-Trunks eines Anbieters nutzen. Eine Konversations-Runtime kann eine ähnliche Verbindung nutzen und dabei selbst Sprach- und Business-Tools bereitstellen.
Was kann ich über einen Anruf auslesen?
Ein Anrufdatensatz identifiziert den Versuch und gibt seinen beobachteten Status wieder. Die verfügbaren Felder hängen von der Operation und der Phase des Anrufs ab.
- Verbindung: ob der Anruf zugelassen wurde, geklingelt hat und beantwortet wurde.
- Medien: ob die Teilnehmer sich hören und miteinander interagieren konnten.
- Geschäftsergebnis: ob der beabsichtigte Termin, Rückruf oder Support-Vorgang abgeschlossen wurde.
Ein angenommener Telefonanruf kann eine Person, eine Voicemail oder ein anderes automatisiertes System erreichen. Der Anrufdatensatz allein kann nicht beweisen, dass ein Kunde eine Aufgabe abgeschlossen hat.
Events helfen Ihrer Anwendung, auf Änderungen zu reagieren. Behandeln Sie Duplikate und verspätete Zustellung, und gleichen Sie fehlende oder unsichere Updates mit dem aufgezeichneten Status des Anbieters ab.
Wie baue ich das mit Bird?
Sie konfigurieren ausgehende Anrufe mit einem SIP-Trunk, einer verifizierten Anrufer-ID und einem freigeschalteten Zielland.
Konfigurationsänderungen erfordern voice_management auf Schreibebene.
Am Trunk muss outbound_enabled den Wert true haben. domain ist die Adresse, mit der sich Ihr SIP-Client verbindet. Bei API-Key-Authentifizierung wird Ihr Schlüssel in allowed_api_key_ids eingetragen; der Schlüssel benötigt voice auf Schreibebene. Ein Update dieser Liste ersetzt alle Einträge – behalten Sie daher Schlüssel bei, die andere Clients noch verwenden.
Ihre Anrufer-ID benötigt status: verified, was bestätigt, dass Ihr Workspace den Verifizierungsanruf abgeschlossen hat. phone_number enthält die internationale Nummer einschließlich der führenden +.
Das Zielland benötigt sowohl enabled: true als auch status: available. Ein Land freizuschalten macht ein nicht unterstütztes Ziel nicht anrufbar.
Das Browser-Telefon benötigt außerdem session_credentials_enabled: true am Trunk sowie MD5 in dessen Liste digest_algorithms.
Nach einem Anruf prüfen Sie status, rejection_reason und sip_response_code. Die Operationen Anrufliste und Anruf lesen geben diese Felder zurück. Diese Operationen melden Versuche. Ihre SIP-Anwendung initiiert sie.
Für ein Telefonmenü konfigurieren Sie Ansagen und Tastaturverzweigungen in der verbundenen Anwendung. Eine Voice-AI-Runtime stellt Sprache, Reasoning und Business-Tools für ein Gespräch bereit.
Kurz gesagt
Prüfen Sie, welche Aufgabe die API erfüllt.
Konfiguration, Anrufsteuerung und Anrufdatensätze sind unterschiedliche Schnittstellen. Eine Leseoperation bedeutet nicht, dass Sie damit einen Anruf starten können.
Signalisierung und Audio haben getrennte Pfade.
SIP baut die Sitzung auf und ändert sie. Medien transportieren, was die Teilnehmer hören – erfolgreiche Signalisierung allein beweist nicht, dass Audio funktioniert.
Halten Sie das Geschäftsergebnis neben dem Anrufergebnis fest.
Ein angenommener Anruf kann bei einer Voicemail oder einem anderen System landen. Die Anwendung, der die Aufgabe gehört, bestätigt, ob sie abgeschlossen wurde.