/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 Webhook –
POST /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) — bevorzugttoolkit=oder/tools+/trigger-typesfü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 +
filterByFormulazurü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öserassistant_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, sonstsmtp_settings.from_email) plus Workspace-Owner/-Admins
notify_on_failure (standardmäßig aktiviert).
Assistent-Webhook-Bindung
Wähle in der Webhook-Karte des Assistenten die Zustellungsart Automatisierung und wähle einecall.completed-Automatisierung aus – oder behalte eine benutzerdefinierte HTTPS-URL bei.