> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ouraicalling.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Automatisierungen

> Native Workspace-Workflows – Auslöser, Aktionen, Ausführungsverlauf und Assistent-Webhook-Bindung.

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 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) — 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.