Tools (Voice-Parität)
Alle sieben Messaging-Plattformen teilen sich eine Antwort-Pipeline. Der Assistent kann dieselben textsicheren Tools wie bei Voice nutzen:- API-Tools (HTTP)
- MCP-Tools (Workspace- + Assistenten-Server)
- Wissensdatenbank-Suche
- Kalender-Integrationen (nativ / Cal.com / Calendly)
- Built-ins: aktuelle Uhrzeit, Geschäftszeiten, SMS senden, E-Mail senden, Rückruf planen, Variable setzen
purpose=email).
Voraussetzungen
- Dein Plan umfasst den Kanal, den du verbinden möchtest (Telegram, Slack, Messenger, Teams, Discord, Google Chat, X, WhatsApp Text / WhatsApp Voice).
- Die Webhook-Basis ist deine Basis-App-URL – entweder der Plattform-Host (z. B.
https://app.famulor.io) oder die verifizierte Custom Domain dieses Workspaces. Du brauchst keinen Zugriff auf Server-Umgebungsvariablen; das Produkt baut die Webhook-URLs automatisch, sobald du einen Kanal verbindest. - Die Plattform-KI für Textantworten wird vom Betreiber konfiguriert.
Verbinden (Produkt-UI)
Einstellungen → Kanäle → Telegram / Slack / Messenger:- Wähle einen Assistenten.
- Verbinde per One-Click, wo verfügbar (Zu Slack hinzufügen, Mit Facebook verbinden), oder füge Bot-Zugangsdaten manuell ein.
- Konfiguriere die Konversationseinstellungen (siehe unten).
- Speichern – Telegram-Webhooks werden automatisch registriert; Slack/Messenger BYO brauchen die angezeigte Webhook-URL. One-Click nutzt den gemeinsamen Plattform-Webhook (kein URL-Kopieren).
Slack – Zu Slack hinzufügen
Bevorzugtes Onboarding (nur Plattform-Domain / Root-Workspaces – nicht Whitelabel) nutzt die gemeinsame Famulor-Slack-App:- Einstellungen → Kanäle → Slack → Zu Slack hinzufügen
- Nutzer erteilt Bot-Scopes in Slack → wir speichern Bot-Token, Signing Secret (Plattform) und
team_id - Plattformbetreiber konfigurieren Event Subscriptions einmal an der Basis-App-URL (
/api/webhooks/slack), Socket Mode aus - Events werden anhand der Slack-
team_idan den Workspace-Connector geroutet
GET/POST /api/v1/slack/oauth · MCP: get_slack_oauth_config, start_slack_oauth.
Messenger – Mit Facebook verbinden
Das bevorzugte Onboarding (nur Plattform-Domain / Root-Workspaces – nicht für Whitelabel-Hosts) nutzt dieselbe Plattform-Meta-App wie WhatsApp:- Einstellungen → Kanäle → Messenger → Mit Facebook verbinden (HTTPS erforderlich)
- Der Nutzer gewährt Page-Berechtigungen → wählt eine Facebook-Seite aus → wir legen den Connector an und rufen
subscribed_appsauf - Plattformbetreiber konfigurieren den Messenger-Webhook auf Meta-App-Ebene an der Basis-App-URL (
/api/webhooks/meta/messenger-platform) und abonnieren messages - Events werden anhand der Page-ID an den Workspace-Connector geroutet
GET/POST /api/v1/messenger/facebook-login · MCP: complete_messenger_facebook_login.
Konversationseinstellungen
Gilt für jeden Textkanal (Telegram, Slack, Messenger):Webhook „Konversation beendet”
Wenn eine Konversation endet (Inaktivitäts-Timeout), macht die Plattform Folgendes:- Markiert die Konversation als beendet.
- Führt die Post-Call-Analyse-Variablen des Assistenten gegen das Chat-Transkript aus (dieselbe
analysis_configwie bei Voice). - Sendet ein JSON-Payload per POST an deine Webhook-URL (falls gesetzt), inklusive der extrahierten Variablen.
/api/cron/messaging-inactivity (läuft auf der Plattform jede Minute).
Plattform-Apps, die du anlegst
Webhook-URL-Muster:
https://app.famulor.io/api/webhooks/messaging/{platform}/{connector_id}
Host-Auflösung (nur diese zwei – kein Reseller-/Subdomain-Fallback):
- Die eigene verifizierte Custom Domain dieses Workspaces, verwaltet unter Tenant Admin → Settings → Domains
- Sonst die Basis-App-URL der Plattform
setWebhook nutzt automatisch dieselbe aufgelöste URL.
Public API & MCP
- REST:
GET/POST /api/v1/messaging-connectors,PATCH/DELETE /api/v1/messaging-connectors/{id} - WhatsApp-Vorlagen:
GET/POST /api/v1/whatsapp/templates - Ausgehende WhatsApp-Voice-Anrufe:
POST /api/v1/calls/whatsapp-outbound - MCP-Tools:
list_messaging_connectors,create_messaging_connector,update_messaging_connector,delete_messaging_connector, plus WhatsApp-Vorlagen-/Anruf-Tools - OpenAPI-Tag: Messaging / Calls
- Text: Meta Cloud API über
messaging_connectors(platform=whatsapp), Plan-Flagwhatsapp_channel. - Voice: Plattform-WhatsApp-Voice-Connector mit denselben Zugangsdaten – siehe WhatsApp Voice, Plan-Flag
whatsapp_voice. - Vorlagen:
GET/POST /api/v1/whatsapp/templates(+ MCP-Tools). - Ausgehende Anrufe:
POST /api/v1/calls/whatsapp-outbound.