Telnyx Voice

Funktionsweise

Connic erstellt eine eigene Call-Control-Anwendung in Telnyx, ordnet ihr die ausgewählte Nummer zu und überträgt Audio in beide Richtungen. Unterstützt werden eingehende Anrufe.

Rufnummer und Konto bleiben bei Telnyx. Modellzugang, Anweisungen, Tools und Spracheinstellungen gehören zum Connic-Projekt und zum Agenten. Die Voice-Dokumentation beschreibt die unterstützten Echtzeitmodelle und aktuellen Einschränkungen.

Einrichtung

1. 1

   Sprachagenten bereitstellen

   Konfiguriere ein unterstütztes Echtzeitmodell und voice_config an einem LLM-Agenten. Speichere die Zugangsdaten des Modellanbieters im Projekt und stelle den Agenten in der Zielumgebung bereit.

2. 2

   Telnyx-Kontozugang speichern

   Füge Telnyx Voice aus dem Marktplatz hinzu. Hinterlege den API-Schlüssel und den Base64-kodierten öffentlichen Ed25519-Schlüssel des Telnyx-Kontos. Verwende diesen gespeicherten Kontozugang auch für weitere Nummern oder Telnyx Messaging.

3. 3

   Rufnummer auswählen

   Wähle eine vorhandene aktive Nummer aus dem verbundenen Telnyx-Konto. Entferne Rufumleitungen, technische Präfixe und Zielumschreibungen, die den Agenten umgehen oder die Empfängernummer ändern würden. Verwendet bereits eine andere Connic-Voice-Verbindung die Nummer, muss sie diese zuerst freigeben.

4. 4

   Speichern, Agenten verknüpfen und testen

   Speichere die Verbindung und verknüpfe genau einen bereitgestellten Sprachagenten. Connic erstellt die Call-Control-Anwendung und richtet eingehende Anrufe automatisch ein. Rufe die Nummer an und prüfe im entstandenen Run das Transkript, die Tool-Aufrufe, Laufzeiten und Fehler.

Einstellungen und Zugangsdaten

Mit dem API-Schlüssel prüft Connic das Konto, listet Rufnummern auf und richtet die Anwendung ein. Der separate öffentliche Schlüssel dient zur Prüfung eingehender Ereignisse. Beide Schlüssel stehen im Telnyx-Portal. Die Zugangsdaten für das Sprachmodell werden separat im Connic-Projekt hinterlegt.

Im Gespräch

Der Agent empfängt die Sprache des Anrufers und gibt seine gesprochenen Antworten über Telnyx aus. Unterbricht der Anrufer, kann Connic die ausstehende Audiowiedergabe stoppen. Ob der Agent das Gespräch selbst beenden darf, wird in seinen Spracheinstellungen festgelegt. Connic beendet den Anruf anschließend über Telnyx.

Textnachrichten laufen über eine separate Telnyx-Messaging-Verbindung. Die Voice-Einrichtung ändert die Anwendungszuordnung für Anrufe.

Änderungen und Entfernung

Zugangsdaten werden am gespeicherten Telnyx-Kontozugang geändert. Rufnummer und verwendeter Kontozugang lassen sich an der Voice-Verbindung wechseln. Beim Entfernen löscht Connic nur die Anrufweiterleitung, die ihm noch gehört. Frühere Zuordnungen werden nicht wiederhergestellt. Manuelle Änderungen, die nach der Einrichtung in Telnyx vorgenommen wurden, bleiben erhalten.

Nach dem Speichern der Änderung entfernt Connic seine ungenutzte Call-Control-Anwendung, sofern sie noch dieser Verbindung gehört und ihr keine Nummern mehr zugeordnet sind.

Fehlerbehebung

• Prüfe bei Fehlern der Kontoprüfung die Zugriffsrechte des API-Schlüssels. API-Schlüssel und öffentlicher Schlüssel müssen aus demselben Telnyx-Konto stammen.
• Prüfe bei abgewiesenen Anrufen, ob die Verbindung aktiv und mit genau einem bereitgestellten Sprachagenten verknüpft ist.
• Kann Connic beim Entfernen die Anwendungszuordnung nicht lösen, trenne die Connic-Anwendung in Telnyx von der Nummer und versuche das Entfernen erneut. Manuelle Änderungen bleiben erhalten.
• Run-Fehler in Connic und Anrufprotokolle in Telnyx helfen bei der Diagnose. Telnyx beschreibt das zugrunde liegende Media-Streaming-Protokoll.