Dokumentation

Messaging (WhatsApp, Telegram, Mattermost)

Eine Pipeline mit WhatsApp Cloud API, Telegram Bot API oder Mattermost verbinden.

Messaging

betool integriert die drei am häufigsten nachgefragten professionellen Messaging-Plattformen. Jede folgt demselben Modell: ein Modul *_inbound für den Empfang und ein Modul *_outbound für den Versand.

WhatsApp Business

Voraussetzungen

  • Meta-Business-Konto.
  • Genehmigte WhatsApp-Business-Nummer.
  • Cloud-API-Anwendung mit einem Webhook konfiguriert.

Einrichtung

  1. Administration → WhatsApp → Konten — verbinden Sie Ihre Meta-App mit ihrem App Secret und ihrer Phone Number ID.
  2. Fügen Sie auf Meta-Seite die von betool bereitgestellte Webhook-URL hinzu (https://platform.betool.ai/entries/whatsapp/<id>) und kopieren Sie das erzeugte Verify Token.
  3. Ordnen Sie die Nummer einer Pipeline zu.

Besonderheiten

  • Genehmigte Templates sind erforderlich, um eine Unterhaltung zu initiieren (außerhalb des 24-Stunden-Fensters). Sie verwalten die Templates auf Meta-Seite; betool referenziert sie über ihren Namen.
  • Unterstützte Medien: Bilder, Audio, Video, Dokumente. Werden von den Standard-Knoten file_transform verarbeitet.

Telegram

Voraussetzungen

Ein über @BotFather erstellter Bot (API-Token).

Einrichtung

  1. Administration → Telegram → Bots — fügen Sie das Token ein; betool konfiguriert den Webhook automatisch.
  2. Ordnen Sie den Bot einer Pipeline zu.

Besonderheiten

  • Der Bot kann zu Gruppen hinzugefügt oder in privaten Unterhaltungen verwendet werden.
  • Keine restriktiven Kontingente wie bei WhatsApp — ideal für interne Assistenten oder betriebliche Benachrichtigungen.

Mattermost

Voraussetzungen

  • Eine Mattermost-Instanz (Cloud oder selbst gehostet).
  • Ein ausgehender Webhook auf Mattermost-Seite.

Einrichtung

  1. Administration → Mattermost → Verbindungen — erstellen Sie die Verbindung und kopieren Sie die von betool bereitgestellte URL.
  2. Erstellen Sie auf Mattermost-Seite einen ausgehenden Webhook, der auf diese URL zeigt.
  3. Optional: Erstellen Sie einen eingehenden Webhook auf Mattermost, damit betool Antworten posten kann.

Besonderheiten

  • Threads erhalten — Agent-Antworten bleiben im Thread der ursprünglichen Frage.
  • Private Kanäle / DMs — wählen Sie den Geltungsbereich bei der Konfiguration.

Zwischen den dreien wählen

AnwendungsfallEmpfehlung
Externer Verbraucher-KundensupportWhatsApp
Interner Team-AssistentTelegram oder Mattermost (je nachdem, was bereits im Einsatz ist)
IT-/DevOps-BetriebsbotMattermost
Multi-Kanal-PräsenzSie können dieselbe Pipeline gleichzeitig mit mehreren Kanälen verbinden