Skip to main content
POST
Automation-Vorlage anwenden
Dieser Endpunkt erstellt eine Automation aus einer Vorlage (siehe Vorlagen auflisten), führt einen echten Test aus und — bei Assistant-Event-Vorlagen — bindet die Automation nach bestandenem Test an den Assistant. Die Response hat dieselbe Envelope wie Automation erstellen.
Vorlagen mit side_effects: true senden im Testlauf wirklich Nachrichten oder starten Anrufe — Anwenden erfordert confirm_side_effects: true, und der Test nutzt die echten Werte, die du geliefert hast. Nie eine Vorlage mit Beispiel- oder geratenen Werten anwenden.

Path Parameters

string
erforderlich
Der Vorlagen-Key (aus Vorlagen auflisten). Ein unbekannter Key liefert 404.

Request Body

object
Die Parameter der Vorlage als Key-Value-Paare — siehe die params-Liste der Vorlage. Fehlende Pflichtparameter liefern 422 (missing_params) mit genauer Auflistung. Max. 64 KB.
integer
Der Assistant, an den die resultierende Automation gebunden wird. Pflicht bei Vorlagen mit requires_assistant: true.
string
Ein eigener Name für die Automation (max. 255 Zeichen); Standard ist der Vorlagenname
boolean
Pflicht (true) für Vorlagen mit side_effects: true

Response

Die Envelope von Automation erstellen: automation_id, webhook_url (bei webhook-getriggerten Vorlagen wie lead-intake-webhook und Mid-Call-Lookup; null bei Assistant-Event-Vorlagen), status (active / active_untested / test_failed), test (run_status + Ergebnisse pro Step), response, binding. Liefert 201, wenn die Automation aktiv ist, 200, wenn der Testlauf fehlschlug. Parkt ein Testlauf an einem Delay-Step (z. B. post-call-callback) mit run_status: "PAUSED" — das ist Erfolg, kein Fehler: alle Steps vor dem Delay sind gelaufen, der Lauf setzt zur Zielzeit fort.

Fehlercodes (422)

Harte Fehler liefern {"message": "...", "error": "<code>", "params": ...} und es wird nichts erstellt. Wichtige Codes: