Skip to main content
Die Seite Automatisierungen (/automations) ist der native Workflow-Builder für deinen Workspace. Baue mehrstufige Workflow-Graphen mit Auslösern, Aktionen, Testläufen und einem vollständigen Ausführungsverlauf. Plan-Voraussetzung: automation_platform. Monatliches kostenloses Lauf-Kontingent: max_automation_runs (-1 = unbegrenzt kostenlos, 0 = keine kostenlosen Läufe). Ist das kostenlose Kontingent aufgebraucht, wird für jeden weiteren Lauf automation_run_credits abgebucht (Plattform-Basispreis in credit_settings, Verkaufspreis pro Tenant über tenants.credit_pricing). KI-Schritte (Benutzerdefinierter Prompt, Felder extrahieren, MCP · Tool aufrufen) belasten zusätzlich Workspace-Credits für den Token-Verbrauch: Listenpreis × 2,5 (Token-Kosten + 150 % Marge). Abgebuchte Credits erscheinen im Lauf (credits_charged) und in der Schritt-Ausgabe bzw. im Test-Panel. Graph-Ende: Ein Blatt-Knoten ohne ausgehende Kante schließt den Lauf erfolgreich ab. Explizite Terminals (stop, variables.return, webhook.respond) setzen halt und beenden den Lauf sofort – eine weitere Verbindung ist nicht nötig (das Canvas blendet den Quell-Handle aus).

Auslöser

  • Bei Anruf abgeschlossen – nach Ende eines Sprachanrufs (inklusive Analyse). Erfordert einen bestimmten Assistenten.
  • Bei eingehendem Anruf – wenn ein eingehender Anruf beginnt.
  • Eingabevariablen setzen (call.variables) – ersetzt beim Anrufstart den Variablen-Webhook des Assistenten. Beende mit Variablen zurückgeben.
  • E-Mail empfangen – eingehende E-Mail über SendGrid.
  • Konversation gestartet / beendet – Messaging-Kanal geöffnet bzw. geschlossen.
  • Eingehender WebhookPOST /api/automations/{id}/webhook.
  • Buchung erstellt / storniert / verschoben, Manuell, Zeitplan (bald).
  • App-Ereignisse (Beta) – jede verbundene App (Gmail, GitHub, …) erscheint als eigene Platform mit schema-basierten Triggern. Erfordert Workspace-Beta-Features. Beim Aktivieren wird die Trigger-Instanz angelegt.

Aktionen (Plugins)

Organisiert als Plattform → Typ → Aktion (Famulor, AI, Time, WhatsApp, Telegram, X, HTTP, Slack, …).
  • AI: Felder extrahieren, Benutzerdefinierter Prompt
  • Time: Verzögerung um / bis, Aktuelles Datum und Uhrzeit abrufen, Zeitzone konvertieren, Formatieren
  • Logik: Bedingung, Filter, Switch, Zufall, Stopp, Notiz, Variable setzen, Code ausführen, Schleife über Elemente
  • Kontakte: Erstellen/Aktualisieren, Per Telefonnummer abrufen, Auflisten, Tags/Attribute hinzufügen
  • Anrufe: Telefonnummer anrufen
  • Messaging: SMS, E-Mail (Workspace-Kanal), E-Mail senden (SMTP) über eine gespeicherte SMTP-Verbindung, Kanalnachricht (WhatsApp / Telegram / X bei offenen Konversationen)
  • Wissen: Quelle hinzufügen / löschen / abrufen
  • HTTP/Webhooks: HTTP-Request, Slack-/Discord-/Teams-Incoming-Webhooks, Webhook-Antwort (synchronisiert HTTP-Status/Body für eingehende Webhooks)
  • CRM-/SMTP-/MCP-Verbindungen: wiederverwendbare Zugangsdaten unter Automatisierungen → Verbindungen (Airtable, HubSpot, Salesforce, Close, SMTP, Supabase / Neon / Brevo / Atlassian / Shopify Storefront MCP, plus Notion/Stripe/GitHub/Linear/Slack MCP). Verbindung testen prüft bei SMTP das Relay und verschickt eine Test-E-Mail an den Admin. Offizielle MCP-Presets, die laut Hersteller-Doku ausschließlich OAuth unterstützen (z. B. ClickUp, Asana, PayPal-Login), sind noch nicht gelistet – unser Verbindungsmodell benötigt für headless laufende Automatisierungen einen Bearer-/API-Key.
  • Verbundene Apps (Beta): Unter Verbindungen → Apps durchsuchen Toolkits per OAuth verbinden (Suche + Infinite Scroll über den gesamten Katalog). Im Builder laden App-Plattformen zuerst paginierte Metadaten; Tools/Trigger pro App beim Auswählen (Runtime: composio.execute / composio.event). Erfordert App-Connector-API-Key und Beta-Features. Native CRM-/SMS-/MCP-Nodes bleiben unverändert. Bulk-Katalog (/api/automations/composio/catalog) wärmt nur die angeforderte Seite (Default 40, max 100) — bevorzugt toolkit= oder /tools + /trigger-types für Lazy Load.
  • Airtable-Aktionen: Auflisten, Datensatz suchen, Datensätze durchsuchen, Suchen oder erstellen, Per ID abrufen, Erstellen / Datensätze erstellen (Batch ≤10), Aktualisieren, Löschen. Find/Search greifen intern auf List Records + filterByFormula zurück.
  • MCP: Tool aufrufen – Verbindung + Tool-Mehrfachauswahl (oder alle) + Agent-Prompt mit Flash-Variablen; der Agent wählt das Tool aus und befüllt die Argumente
  • Variablen: Variablen zurückgeben (für call.variables)

Organisation

Automatisierungen unterstützen frei definierbare Tags (Filter auf der Listenseite) und zeigen den verknüpften Assistenten an, wenn der Auslöser assistant_id verwendet. Erstelle oder aktualisiere sie über die UI, REST (tags auf /api/v1/automations) oder MCP (create_automation / update_automation).

Läufe & Fehlerbenachrichtigungen

Die Listenseite hat die Tabs Automatisierungen und Läufe. Lege über Benachrichtigungseinstellungen einen Workspace-Posteingang für fehlgeschlagene Läufe fest (tenants.automation_alert_email) und schalte Benachrichtigungen ein oder aus (automation_failure_alerts_enabled). Ist keine eigene E-Mail-Adresse hinterlegt, geht die Benachrichtigung bei fehlgeschlagenen Läufen an:
  • Whitelabel-Kunden-Workspaces → Tenant-Admin-support_email (plus Workspace-Owner/-Admins)
  • Plattform-Root-Workspaces → Plattform-Admin-Kontakt-/SMTP-E-Mail aus /admin/settings (welcome_email.contact_email, sonst smtp_settings.from_email) plus Workspace-Owner/-Admins
Pro Automatisierung umschaltbar: notify_on_failure (standardmäßig aktiviert).

Assistent-Webhook-Bindung

Wähle in der Webhook-Karte des Assistenten die Zustellungsart Automatisierung und wähle eine call.completed-Automatisierung aus – oder behalte eine benutzerdefinierte HTTPS-URL bei.