Twilio Messaging

Speichere deine Zugangsdaten einmal und wähle diesen Kontozugang beim Einrichten weiterer Twilio-Verbindungen aus. Die Zugangsdaten gehören zur gespeicherten Twilio-Verbindung; Absender und Nachrichteneinstellungen legst du an der jeweiligen Messaging-Verbindung fest. So nutzt du verschiedene Nummern und Kanäle desselben Kontos, ohne mehrere Kopien des Auth Tokens zu pflegen. Wie du einen Agenten für eingehende Anrufe einrichtest, zeigt die Anleitung für Twilio Voice.

Wähle die Region passend zu deiner Twilio-Konfiguration. US1 unterstützt SMS/MMS, WhatsApp und RCS. In IE1 gelten Einschränkungen: Möglich sind SMS-Textnachrichten ohne Medien; Absender und Empfänger mit der Vorwahl +1 werden nicht unterstützt. AU1 unterstützt nur Voice. Stelle Rufnummern und Kanalabsender in Twilio bereit. RCS-Entwürfe bleiben für Tests auswählbar; ein Eintrag in der Auswahlliste bedeutet keine Freigabe für den Produktivbetrieb.

Wähle eine Twilio-Rufnummer oder einen registrierten WhatsApp- oder RCS-Absender und speichere die eingehende Messaging-Verbindung. Connic trägt ihren Webhook in Twilio ein. Beim Absenderwechsel wird er aktualisiert, beim Löschen der Verbindung entfernt, sofern er noch auf diese Verbindung zeigt. Fehler bei der Einrichtung erscheinen beim Speichern.

Entferne einen bestehenden Webhook für eingehende Nachrichten oder eine zugewiesene TwiML-App, bevor du den Absender Connic zuordnest. Gehört der Absender zu einem Messaging Service, wähle dort Defer to sender's webhook. Für die WhatsApp Sandbox kopierst du die Webhook-URL der Verbindung in Twilios Sandbox settings unter When a Message Comes in und speicherst sie mit HTTP POST. Für die Sandbox ist dieser manuelle Schritt erforderlich.

Connic prüft die Signatur der Twilio-Anfrage sowie die Übereinstimmung von Konto, Kanal und Zieladresse mit der eingehenden Messaging-Verbindung. Jede angenommene Nachricht liefert den Text, Absender- und Empfängeradresse, die Twilio-Nachrichten-ID, eine Gesprächs-ID und die ursprünglichen Webhook-Felder. Unterstützte Medien werden heruntergeladen und dem Agenten als Dateieingabe übergeben.

Lege im Prompt fest, wie der Agent vorgehen soll, und ergänze die benötigten Wissensquellen oder Tools. Ein Support-Agent kann eine Produktanleitung abrufen; ein Bestellassistent kann über ein Tool dein Bestellsystem abfragen. Die Messaging-Dokumentation beschreibt die Eingabefelder, die Webhook-Einrichtung und Beispiele für beide Richtungen.

Verknüpfe die eingehende und die ausgehende Messaging-Verbindung mit demselben Agenten. Verwende denselben gespeicherten Twilio-Kontozugang, Kanal und Absender. Lasse den ausgehenden Empfänger leer, damit die Antwort an den verifizierten Absender der eingehenden Nachricht geht. Connic prüft dafür, aus welcher Verbindung die Nachricht stammt.

Für andere Ziele übergibst du den Empfänger mit der ausgehenden Nachricht oder legst einen Standardempfänger an der Verbindung fest. Ein ausdrücklich übergebener Empfänger hat Vorrang vor dem Standardempfänger; dieser hat wiederum Vorrang vor dem eingehenden Absender. Sende einfachen Text oder verwende eine strukturierte Ausgabe für Empfänger, Medien-URLs und Vorlagenvariablen. Der Versand kann automatisch nach dem Agentenlauf, über ein Agent-Tool oder aus Middleware erfolgen.

Aktiviere Sessions am Agenten und setze den Session-Schlüssel auf input.conversation_id, wenn Rückfragen früheren Kontext benötigen. Wähle eine zum Gespräch passende Session-Laufzeit. Ohne Session-Konfiguration starten Nachrichten unabhängige Runs und teilen keinen Gesprächsverlauf.

Die Gesprächs-ID gruppiert Nachrichten eines Kunden an denselben Twilio-Absender innerhalb dieser eingehenden Messaging-Verbindung. Sie trennt Konten, Regionen und Kanäle. Auch wenn du denselben gespeicherten Kontozugang für Voice oder eine weitere Messaging-Verbindung nutzt, bleiben deren Gesprächsverläufe getrennt.

Eingehende Anhänge verwenden das Dateieingabeformat von Connic und dürfen zusammen höchstens 10 MiB pro Nachricht umfassen. Wähle ein Modell, das die übergebenen Dateitypen verarbeiten kann. Ausgehende Nachrichten akzeptieren öffentliche Medien-URLs, die Twilio abrufen kann: bis zu zehn für SMS/MMS und eine für WhatsApp oder RCS, jeweils im Rahmen der Medienregeln des Kanals. Sende bei WhatsApp erklärenden Text getrennt von Anhängen, die keine Bilder sind, da solche Anhänge den begleitenden Nachrichtentext nicht übernehmen.

Verwende für WhatsApp-Nachrichten außerhalb des 24-stündigen Kundenservicefensters eine in Twilio genehmigte Vorlage. Hinterlege deren Content SID und Variablen an der Verbindung oder übergib sie mit der ausgehenden Nachricht. Vorlagen verwenden ihren eigenen Inhalt; sende freien Text und Medien-URLs in separaten Nachrichten. RCS verwendet den festgelegten RCS-Absender und -Empfänger. Die Messaging-Verbindung wechselt nicht automatisch auf SMS.

Prüfe in den Connic-Runs die eingehende Nachricht, die Tool-Aufrufe des Agenten und seine Ausgabe. Das Ergebnis einer ausgehenden Messaging-Verbindung enthält die Nachrichten-SID von Twilio und den von der API gemeldeten Status. Mit der SID findest du die zugehörige Nachricht in den Messaging Logs von Twilio.

Ein erfolgreicher Outbound-Run bedeutet, dass Twilio die API-Anfrage angenommen hat. Den endgültigen Zustellstatus sowie Fehler des Kanals oder Mobilfunkanbieters prüfst du in den Messaging Logs. Die Dokumentation beschreibt häufige Probleme bei Einrichtung, Empfängern, Vorlagen und Anhängen.