Messenger-Integrationen

Verbinden Sie Telegram, WhatsApp, Instagram und Facebook Messenger

​

Unterstuetzte Messenger

Messenger	Authentifizierung	Eingehend	Ausgehend	Tools
Telegram	Bot-Token	Ja	Ja	6
WhatsApp Business	Meta OAuth	Ja	Ja	6
Instagram DM	Meta OAuth	Ja	Ja	6
Facebook Messenger	Meta OAuth	Ja	Ja	6

​

Telegram

Telegram ist die einfachste Integration — kein OAuth, keine SDK-Abhaengigkeiten. Nur ein Bot-Token von BotFather.

​

Einrichtung

1. Einen Bot erstellen

   Oeffnen Sie @BotFather in Telegram, senden Sie /newbot und folgen Sie den Anweisungen. Sie erhalten ein Bot-Token wie 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11.

2. Integration hinzufuegen

   Gehen Sie zu Integrationen → Integration hinzufuegen → waehlen Sie Telegram aus der Kategorie Messenger.

3. Token eingeben

   Waehlen Sie ein Unternehmen, benennen Sie die Integration und fuegen Sie Ihr Bot-Token ein.

4. Verifizieren und speichern

   Revol ruft die Telegram Bot API auf, um das Token zu verifizieren, und richtet den Webhook automatisch ein. Ihr Bot beginnt sofort, Nachrichten zu empfangen.

​

Agenten-Tools

Tool	Beschreibung
send_message	Eine Textnachricht senden (HTML- oder Markdown-Formatierung) mit optionaler Antwort-auf
send_file	Ein Foto, Dokument, Audio oder Video per oeffentlicher URL senden
get_chat_history	Aktuelle Nachrichten aus einem Chat abrufen
get_chat_info	Chat-/Benutzer-Metadaten abrufen (Name, Bio, Mitgliederzahl)
edit_message	Eine zuvor gesendete Bot-Nachricht bearbeiten
delete_message	Eine Nachricht aus dem Chat loeschen

---

​

WhatsApp Business

Die WhatsApp Business API wird ueber Metas Graph API aufgerufen. Erfordert ein Meta Business-Konto mit WhatsApp Business API-Zugang.

​

Einrichtung

1. Meta Business-Setup

   Erstellen Sie ein Meta Business-Konto und richten Sie den WhatsApp Business API-Zugang ein.

2. Integration hinzufuegen

   Gehen Sie zu Integrationen → Integration hinzufuegen → waehlen Sie WhatsApp Business.

3. OAuth

   Klicken Sie auf “Mit Meta verbinden” — Sie werden zum Meta-Zustimmungsbildschirm weitergeleitet. Autorisieren Sie den Zugriff auf Ihr WhatsApp Business-Konto.

4. Konfigurieren

   Geben Sie Ihre Telefonnummer-ID und Ihr App-Geheimnis ein. Revol tauscht den OAuth-Code gegen ein langlebiges Token (~60 Tage).

WhatsApp hat ein 24-Stunden-Nachrichtenfenster. Sie koennen Freitext-Nachrichten nur innerhalb von 24 Stunden nach der letzten Kundennachricht senden. Ausserhalb dieses Fensters verwenden Sie send_template_message mit vorab genehmigten Vorlagen.

​

Agenten-Tools

Tool	Beschreibung
send_message	Eine Textnachricht innerhalb des 24-Stunden-Fensters senden
send_template_message	Eine vorab genehmigte Vorlage senden (funktioniert ausserhalb des 24h-Fensters)
send_media	Ein Bild, Dokument, Video oder Audio per URL senden
get_message_history	Konversationsnachrichten abrufen
get_contact_info	Kontaktprofilinformationen abrufen
mark_as_read	Lesebestaetigungen fuer eine Nachricht senden

---

​

Instagram DM

Instagram Direct Messages werden ueber Metas Graph API mit demselben OAuth-Flow wie WhatsApp aufgerufen.

​

Einrichtung

1. Facebook-Seite verbinden

   Ihr Instagram Business-Konto muss mit einer Facebook-Seite verknuepft sein.

2. Integration hinzufuegen

   Gehen Sie zu Integrationen → Integration hinzufuegen → waehlen Sie Instagram.

3. OAuth

   Klicken Sie auf “Mit Meta verbinden” und autorisieren Sie den Zugriff auf Ihr Instagram-Konto.

4. Konfigurieren

   Geben Sie Ihr App-Geheimnis und Ihr Verifizierungs-Token ein.

​

Agenten-Tools

Tool	Beschreibung
send_message	Eine Direktnachricht an einen Instagram-Benutzer senden
send_media	Einen Medienanhang per DM senden
get_message_history	DM-Thread-Nachrichten abrufen
get_profile	Oeffentliche Instagram-Profilinformationen abrufen
get_comments	Kommentare zu einem bestimmten Beitrag abrufen
reply_to_comment	Eine verschachtelte Antwort auf einen Kommentar posten

---

​

Facebook Messenger

Facebook Messenger verbindet sich ueber Ihre Facebook-Seite. Derselbe Meta OAuth-Flow wie WhatsApp und Instagram.

​

Einrichtung

1. Facebook-Seite

   Sie benoetigen eine Facebook-Seite, die mit Ihrem Meta Business-Konto verknuepft ist.

2. Integration hinzufuegen

   Gehen Sie zu Integrationen → Integration hinzufuegen → waehlen Sie Facebook Messenger.

3. OAuth

   Klicken Sie auf “Mit Meta verbinden” und autorisieren Sie den Zugriff auf Ihre Seite.

4. Konfigurieren

   Geben Sie Ihr App-Geheimnis und Ihr Verifizierungs-Token ein.

​

Agenten-Tools

Tool	Beschreibung
send_message	Eine Textnachricht an einen Facebook-Benutzer senden
send_template_message	Eine strukturierte Vorlage senden (Schaltflaechen, Generisch, Quittung)
send_media	Ein Bild, Video, Audio oder eine Datei senden
get_message_history	Konversationsthread abrufen
get_profile	Benutzerprofil anhand der seitenbezogenen ID abrufen
send_buttons	Schnellantwort-Optionen an den Benutzer senden

---

​

Nachrichtenfluss

Unabhaengig vom Messenger ist der Verarbeitungsfluss identisch:

1. Eingehende Nachricht

   Die Messenger-Plattform sendet einen Webhook an Revol mit dem Nachrichteninhalt und Absenderinformationen.

2. An Agenten weiterleiten

   Revol identifiziert den Kanal, findet den zugewiesenen KI-Agenten und erstellt oder setzt eine Konversationssitzung fort. Derselbe Absender erhaelt immer denselben Konversationsthread.

3. KI-Verarbeitung

   Die Nachricht wird durch den Workflow des Agenten verarbeitet — LLM-Knoten, RAG-Wissensdatenbank-Abfrage, Tool-Aufrufe und Bedingungen.

4. Ausgehende Antwort

   Die Antwort des Agenten wird ueber dieselbe Messenger-API zurueckgesendet. Der Benutzer sieht die Antwort in seinem Chat.

Messenger-Nachrichten werden asynchron ueber einen Hintergrund-Job verarbeitet. Dies stellt sicher, dass der Webhook eine schnelle 200-Antwort zurueckgibt und Timeouts sowie Wiederholungen von der Messenger-Plattform verhindert werden.

​

Tools in Workflow-Knoten verwenden

Messenger-Tools funktionieren wie jedes andere Agenten-Tool:

1. Verbinden Sie die Integration und verifizieren Sie die Zugangsdaten
2. Im Tools-Tab des Agenten sehen Sie die bereitgestellten Tools
3. Fuegen Sie Tools zu benutzerdefinierten Knoten im Workflow-Editor hinzu
4. Das LLM entscheidet basierend auf dem Konversationskontext, wann sie verwendet werden

Beispiel: Ein Kunde fragt “Senden Sie mir die Broschuere auf WhatsApp”. Der Agent verwendet send_media, um ein PDF-Dokument zu senden, und bestaetigt dann die Zustellung im Chat.

​

Webhook-Sicherheit

Messenger	Validierung
Telegram	Geheimes Token in der Webhook-URL (SHA-256-Hash des Bot-Tokens)
WhatsApp	HMAC-SHA256-Signatur (X-Hub-Signature-256-Header mit app_secret)
Instagram	HMAC-SHA256-Signatur (X-Hub-Signature-256-Header mit app_secret)
Facebook	HMAC-SHA256-Signatur (X-Hub-Signature-256-Header mit app_secret)

Alle Messenger-Webhooks sind auf 120 Anfragen pro Minute pro Kanal ratenbegrenzt.