Telnyx Messaging

Speichere API-Schlüssel und öffentlichen Signaturschlüssel von Telnyx einmal und wähle diesen Kontozugang für weitere Verbindungen. Kanal und Absender werden jeweils einzeln festgelegt. So lassen sich mehrere Nummern oder Nachrichtenkanäle desselben Kontos nutzen. Auch Telnyx Voice verwendet diesen Kontozugang für eingehende Anrufe.

Rufnummern, Messaging-Profile, WhatsApp-Registrierung, RCS-Agenten und erforderliche Freigaben verwaltest du in Telnyx. Connic zeigt die im Konto verfügbaren Absender an. Ein Eintrag in der Auswahlliste ersetzt keine Registrierung, Tests oder Freigabe für den Produktivbetrieb.

Ein Telnyx-Messaging-Profil enthält die Einstellungen für die Nachrichtenzustellung, darunter den eingehenden Webhook. Für eine eigene Telnyx-Nummer mit SMS oder WhatsApp richtet Connic das bestehende Profil nur ein, wenn es dieser Nummer allein zugeordnet ist. Profile mit weiteren Nummern oder Kurzwahlnummern müssen zuvor in Telnyx getrennt werden. RCS verwendet den Webhook des ausgewählten RCS-Agenten.

SMS und WhatsApp derselben Nummer können eine gemeinsame Connic-Webhook-Adresse verwenden und trotzdem verschiedene Verbindungen und Agenten nutzen. Wähle dafür denselben gespeicherten Kontozugang und dasselbe Profil. Connic ordnet Nachrichten nach Kanal und Empfänger zu. Entferne vor der Einrichtung vorhandene Ausweich-Webhooks oder die Zuordnung zu einem Telnyx-KI-Assistenten. Die Einrichtungsanleitung erklärt auch die manuelle Webhook-Konfiguration für externe WhatsApp-Nummern.

Entfernst du einen Kanal, bleibt die gemeinsame Route für den anderen Kanal bestehen. Beim Entfernen der letzten Verbindung dieser Route löscht Connic den Webhook nur, wenn er weiterhin auf Connic zeigt. Manuell geänderte URLs bleiben erhalten; frühere Weiterleitungen werden nicht wiederhergestellt.

Connic prüft die Telnyx-Signatur sowie Kanal, Absender, Empfänger und Profil, bevor eine Nachricht den Agenten startet. Der Agent erhält vereinheitlichten Text und Adressen, Nachrichten- und Ereigniskennungen, eine Gesprächskennung sowie die ursprünglichen Anbieterdaten. Unterstützte Anhänge werden heruntergeladen und im Dateieingabeformat von Connic übergeben.

Wähle ein Modell, das die übergebenen Bild-, Audio- oder Dokumenttypen verarbeiten kann. Eingehende Anhänge dürfen zusammen höchstens 10 MiB pro Nachricht umfassen. Wiederholte Zustellungen desselben angenommenen Ereignisses werden erkannt. Zustell- und Lesebestätigungen starten keine neuen Gespräche mit dem Agenten.

Für Antworten müssen Kontozugang, Kanal, Absender und Profil der eingehenden und ausgehenden Verbindung übereinstimmen. Lass den ausgehenden Empfänger leer, damit der Agent dem verifizierten Absender der eingegangenen Nachricht antwortet. Connic prüft die Herkunft der Nachricht, bevor es dieses Antwortziel verwendet.

Gib für Benachrichtigungen to im Output an oder speichere einen Standardempfänger. Der Empfänger aus dem Output hat Vorrang vor dem Standardempfänger; dieser hat Vorrang vor dem eingehenden Absender. Für eine einfache Antwort genügt Text. Medien und Vorlagen verwenden strukturierte Ausgaben. Explizite Aufrufe sind als Agent-Tool oder aus Middleware möglich.

Aktiviere Sessions am Agenten und setze den Session-Schlüssel auf input.conversation_id. Wähle eine zum Anwendungsfall passende Laufzeit. Nachrichten desselben Kunden an denselben Absender über diese eingehende Verbindung können dann auf den bisherigen Verlauf zugreifen, solange die Session aktiv ist.

Die Gesprächskennung trennt Verbindungen, Konten, Kanäle und Absender. Ein gemeinsamer Telnyx-Kontozugang führt die Verläufe von SMS, WhatsApp und Voice nicht zusammen. Ohne Session-Konfiguration starten Nachrichten unabhängige Runs.

Übergib öffentliche Medien-URLs, die Telnyx abrufen kann: bis zu zehn Anhänge für MMS oder einen für WhatsApp beziehungsweise RCS, jeweils innerhalb der Medienlimits des Kanals. WhatsApp benötigt media_type, etwa image, video, document, audio oder sticker. Bilder, Videos und Dokumente können eine Textbeschreibung enthalten. Audio und Sticker werden getrennt vom Text gesendet; auch bei RCS benötigen Text und Medien separate Nachrichten.

Verwende außerhalb des 24-stündigen WhatsApp-Kundenservicefensters eine genehmigte Vorlage. Hinterlege whatsapp_template als Standard an der Verbindung oder übergib es für eine einzelne Nachricht. Die Vorlage wird über ihre ID oder über Name und Sprache bezeichnet; Komponentenparameter ergänzen die variablen Inhalte. Eine Standardvorlage ersetzt den freien Antworttext. Die Nachrichtenbeispiele zeigen die unterstützten Felder und Limits. RCS sendet über den konfigurierten RCS-Agenten und wechselt nicht automatisch auf SMS.

Prüfe im Connic-Run die eingehende Nachricht, die Tool-Aufrufe und die erzeugte Antwort. Das ausgehende Ergebnis enthält die Telnyx-Nachrichten-ID, den Nachrichtentyp und die zurückgegebenen Absender- und Empfängerangaben. Mit dieser ID findest du die Nachricht in Telnyx und kannst Fehler des Kanals oder Mobilfunkanbieters untersuchen.

Ein erfolgreicher ausgehender Versandauftrag bedeutet, dass Telnyx die Anfrage angenommen hat. Prüfe die endgültige Zustellung in Telnyx. Bleibt nach einer Zeitüberschreitung oder einem Serverfehler unklar, ob die Nachricht angenommen wurde, sieh vor einem erneuten Versand in den Nachrichtenprotokollen nach, damit der Kunde keine doppelte Nachricht erhält.