TurboFlow Trigger und Actions

Baue Workflows mit Trigger-, Action- und Logic-Nodes

TurboFlow-Workflows beginnen mit einem Trigger, laufen durch eine oder mehrere Actions und verzweigen mit Logic-Nodes. Diese Referenz dokumentiert jeden verfügbaren Node-Typ, die genauen Konfigurationsfelder, die jeder Node akzeptiert, und die Ausgabe, die jeder Node nachgelagerten Nodes bereitstellt.

So fließen Node-Ausgaben durch einen Workflow

Jeder Node fügt sein Ergebnis unter seiner Node-ID zum Workflow-Kontext hinzu. Nachgelagerte Nodes können diese Werte mit Ausdrücken referenzieren. So kannst du Trigger-Payloads in Actions übergeben, Action-Ergebnisse wiederverwenden und anhand von Logic-Ergebnissen verzweigen.

Ausdruckssyntax

Ausdrücke verwenden doppelte geschweifte Klammern um einen Pfad. Der Pfad beginnt in der Regel mit einer Node-ID, gefolgt von dem Ausgabefeld, das du lesen möchtest.

Häufige Ausdrucksbeispiele

Trigger-Nodes

Trigger starten einen Workflow. Jeder Flow verwendet einen Trigger als Einstiegspunkt, und einige Trigger verifizieren außerdem eingehende Ereignisse aus externen Integrationen.

webhook_trigger

webhook_trigger ist der universelle Einstiegspunkt für jeden Flow. Er unterstützt direkte externe Webhooks und optional die Freigabe als Voice-Tool für AI-Assistenten.

Was dieser Trigger macht

• Externer Webhook-Empfänger — jedes externe System kann eine POST-Anfrage an die Trigger-URL des Flows senden.
• Voice-Tool — wenn voice_tool.exposed aktiviert ist, wird derselbe Trigger als aufrufbares Tool für Sprachassistenten registriert.

Konfigurationsfelder

ParameterDef-Felder

Verwende ein ParameterDef-Objekt für jeden Tool-Parameter.

Ausgabefelder

Nachgelagerte Nodes können eingehende Trigger-Daten aus trigger.body lesen.

Beispielkonfiguration für ein Voice-Tool

{
  "voice_tool": {
    "exposed": true,
    "tool_name": "book_calendly_meeting",
    "tool_description": "Books a meeting for the caller and returns the booking result",
    "parameters": [
      {
        "name": "full_name",
        "type": "string",
        "description": "Caller full name",
        "source": "ai",
        "required": true
      },
      {
        "name": "email",
        "type": "string",
        "description": "Best email address for the meeting invite",
        "source": "ai",
        "required": true
      },
      {
        "name": "meeting_type",
        "type": "string",
        "description": "Meeting type to book",
        "source": "static",
        "static_value": "demo_call"
      }
    ]
  }
}

Integration-Trigger

Integration-Trigger starten einen Workflow aus verifizierten Ereignissen, die von externen Systemen gesendet werden.

Unterstützte Integration-Trigger

Meta-Trigger-Konfiguration

Verwende diese Felder, wenn du den Meta-Lead-Trigger konfigurierst.

Action-Nodes

Actions führen Arbeit aus, nachdem ein Trigger ausgelöst wurde. Sie können externe APIs aufrufen, CRM-Daten erstellen oder aktualisieren, ausgehende Anrufe starten oder die finale Antwort des Workflows formen.

http_request

http_request sendet eine HTTP-Anfrage an jede erreichbare URL und stellt die vollständige Response nachgelagerten Nodes zur Verfügung.

Konfigurationsfelder

Ausgabefelder

Beispielkonfiguration

{
  "url": "https://api.acmecrm.com/v1/leads",
  "method": "POST",
  "headers": {
    "Authorization": "Bearer dkai_example_9xmk7q2r",
    "Content-Type": "application/json"
  },
  "body": {
    "email": "{{trigger.body.email}}",
    "name": "{{trigger.body.full_name}}"
  },
  "timeout_seconds": 30
}

talkturo_upsert_contact

talkturo_upsert_contact erstellt oder aktualisiert einen CRM-Kontakt. Der Abgleich erfolgt zuerst über die Telefonnummer, danach über die E-Mail.

Konfigurationsfelder

Ausgabefelder

Beispielkonfiguration

{
  "first_name": "{{trigger.body.first_name}}",
  "last_name": "{{trigger.body.last_name}}",
  "phone": "{{trigger.body.phone}}",
  "email": "{{trigger.body.email}}",
  "source": "web_form",
  "tags": [
    "demo-request",
    "priority-lead"
  ]
}

talkturo_call_contact

talkturo_call_contact startet einen ausgehenden AI-Anruf über eine Kampagne.

Konfigurationsfelder

Ausgabefelder

Beispielkonfiguration

{
  "contact_id": "{{talkturo_upsert_contact.contact_id}}",
  "campaign_id": "cmp_7af42c1d9e",
  "timing_mode": "schedule",
  "scheduled_at": "{{trigger.body.follow_up_time}}"
}

format_output

format_output formt das JSON-Objekt, das der Workflow an den Sprachassistenten zurückgibt.

Konfigurationsfelder

Ausgabefelder

Beispielkonfiguration

{
  "mode": "fields",
  "fields": [
    {
      "key": "contact_id",
      "value": "{{talkturo_upsert_contact.contact_id}}"
    },
    {
      "key": "created",
      "value": "{{talkturo_upsert_contact.created}}"
    },
    {
      "key": "message",
      "value": "Contact saved and ready for follow-up"
    }
  ]
}

{
  "mode": "json",
  "template": {
    "contact": {
      "id": "{{talkturo_upsert_contact.contact_id}}",
      "created": "{{talkturo_upsert_contact.created}}"
    },
    "source": "{{trigger.body.source}}"
  }
}

Logic-Nodes

Logic-Nodes steuern, welchem Pfad der Workflow als Nächstes folgt.

condition

condition wertet zwei Operanden aus und leitet den Workflow über den true- oder false-Handle weiter.

Konfigurationsfelder

Operatoren

Ausgabefelder

Beispielkonfiguration

{
  "left": "{{http_request.status}}",
  "operator": "gte",
  "right": 200
}

Node-Referenz nach Zweck

Verwende diese Tabelle, um schnell den richtigen Node auszuwählen.

Verwandte Seiten