Twilio Voice
Mit Twilio Voice nimmt ein Connic-Agent Anrufe unter einer bestehenden Twilio-Rufnummer entgegen.
Auf dieser Seite
Funktionsweise
Jede Twilio-Verbindung wird mit genau einem bereitgestellten Agenten verknüpft, bei dem voice_config aktiviert ist. Connic richtet den Webhook für eingehende Anrufe ein und überträgt das Audio in beide Richtungen. Ausgehende Anrufe werden nicht unterstützt.
Das Twilio-Konto und die Rufnummer gehören dem Kunden. Die Zugangsdaten für den Modellanbieter werden wie gewohnt im Connic-Projekt gespeichert. Prompt, Tools und Spracheinstellungen werden am Agenten konfiguriert. Die Voice-Dokumentation beschreibt die unterstützten Modelle und aktuellen Einschränkungen.
In den Run-Details lässt sich nachlesen, was gesagt wurde und welche Tools der Agent eingesetzt hat. Die Traces helfen, Wartezeiten und Fehler einzugrenzen.
Einrichtung
Agenten für Telefonate einrichten
Wähle für den LLM-Agenten ein unterstütztes Echtzeitmodell und ergänze
voice_configin seiner YAML-Konfiguration. Speichere die Zugangsdaten des Modellanbieters im Projekt und stelle den Agenten in der gewünschten Umgebung bereit.Twilio-Rufnummer vorbereiten
Öffne in Twilio die Einstellungen einer bestehenden Rufnummer, unter der du Anrufe empfangen kannst. Prüfe, welche Region für eingehende Anrufe aktiviert ist. Entferne dort vorhandene Weiterleitungen für eingehende Anrufe, bevor du die Nummer mit Connic verbindest.
Twilio-Verbindung speichern
Füge dem Agenten eine Verbindung hinzu und wähle dafür Twilio Voice aus dem Marketplace. Speichere Account SID, Region und den zugehörigen Auth Token als Twilio-Verbindung. Diese Zugangsdaten kannst du auch für weitere Rufnummern desselben Kontos in derselben Region verwenden.
Rufnummer auswählen und anrufen
Wähle die Rufnummer, erstelle die Verbindung und verknüpfe den Agenten. Connic richtet den Webhook für eingehende Anrufe automatisch mit HTTP POST ein. Rufe die Nummer an und öffne den zugehörigen Run, um den Gesprächsverlauf zu prüfen.
Einstellungen und Zugangsdaten
| Einstellung | Wert |
|---|---|
| Region | US1 (USA), IE1 (Irland) oder AU1 (Australien). US1 ist vorausgewählt. Wähle die Region, die in Twilio für eingehende Anrufe auf dieser Nummer aktiviert ist. |
| Account SID | Die Kennung des Twilio-Kontos, beginnend mit AC. |
| Auth Token | Der Auth Token der ausgewählten Region, keine API-Key-SID und kein API-Key-Secret. |
| Rufnummer | Eine bestehende Nummer im verbundenen Twilio-Konto, unter der Anrufe empfangen werden können. |
Connic nutzt Account SID und Auth Token, um das Konto zu prüfen, Rufnummern aufzulisten und deren Webhooks zu ändern. Mit dem Auth Token prüft Connic außerdem die Signaturen eingehender Twilio-Anfragen. Twilio-Zugangsdaten gelten jeweils für eine Region. Twilios Anleitung Manage Regional API Credentials zeigt, wo der passende Token zu finden ist.
Änderungen und Fehlerbehebung
Die Zugangsdaten und die Region lassen sich in der gespeicherten Twilio-Verbindung ändern. In den Twilio-Einstellungen am Agenten lässt sich eine andere gespeicherte Verbindung oder Rufnummer auswählen. Beim Wechsel der Nummer richtet Connic den neuen Webhook ein und entfernt den eigenen Webhook von der bisherigen Nummer. Beim Löschen der Verbindung entfernt Connic den Webhook nur, wenn er weiterhin auf Connic zeigt.
- Meldet Connic beim Erstellen einen vorhandenen Webhook für eingehende Anrufe, entferne ihn in der ausgewählten Twilio-Region. Änderungen an derselben Nummer in einer anderen Region haben darauf keinen Einfluss.
- Werden die Zugangsdaten abgelehnt, prüfe, ob der Auth Token zur ausgewählten Region gehört und das Konto aktiv ist.
- Kommt ein Anruf nicht zustande, prüfe, ob die Verbindung aktiviert und mit genau einem bereitgestellten Agenten mit Voice-Konfiguration verknüpft ist. Weitere Hinweise stehen in der Fehlermeldung des Runs und den Anrufdetails in Twilio.