Messaging (WhatsApp, Messenger, Telegram, Mattermost)

betool integriert die am häufigsten nachgefragten 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. Einstellungen → Services → WhatsApp, Reiter 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. PDF- und Excel-Dokumente können anschließend vom Knoten file_transform verarbeitet werden.

WhatsApp über Green API (Beta)

Für eine WhatsApp-Nummer ohne Meta-Business-Konto verbindet sich betool auch mit Green API (Ihre eigene Instanz, BYO): Der Empfänger greenapi_inbound löst bei jeder empfangenen Nachricht eine Pipeline aus (Medien werden in betool kopiert), der Knoten greenapi_outbound sendet einen Text oder eine Datei mit Bildunterschrift. betool richtet den Webhook bei Green API selbst ein.

• Das ist nicht die offizielle WhatsApp-API: Green API emuliert WhatsApp Web. WhatsApp kann die Nummer sperren, ohne Rechtsmittel. Für Kundenkommunikation mit Volumen bevorzugen Sie die oben beschriebene Cloud API.
• Keine Templates und kein 24-Stunden-Fenster; Gruppen sind zugänglich.
• Ein erfolgreicher Versand belegt, dass die Nachricht in der Warteschlange ist, nicht, dass sie zugestellt wurde.
• Der Versand erfolgt ausschließlich über den Knoten (exactly-once): Kein Tool erlaubt es einem Agent, eigenständig zu senden.

Messenger

Der Empfänger messenger_inbound löst bei jeder auf Ihrer Facebook-Seite empfangenen Nachricht eine Pipeline aus; der Knoten messenger_outbound antwortet. Freie Antworten sind nur innerhalb von 24 Stunden nach der letzten Nachricht des Nutzers möglich (Meta-Regel). Details und Verbindung: Meta.

Telegram

Voraussetzungen

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

Einrichtung

1. Einstellungen → Services → Telegram, Reiter Konten — 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. Einstellungen → Services → Mattermost, Reiter Konten — 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.

Wählen