> ## Documentation Index
> Fetch the complete documentation index at: https://docs.famulor.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Flow-Knotenreferenz
> Alle Knotentypen im Flow Builder mit ihren Feldern und ihrem Verhalten
Dies ist die Feldreferenz des Flow Builders — jeder Knotentyp, seine Felder und sein Verhalten während eines Anrufs. Was ein Flow ist und wie Kanten und Labels funktionieren, erklärt die [Flow-Builder-Übersicht](/de/flow-builder/overview).
## Start
Einstiegspunkt jedes Flows. Legt die **greeting** und den **greeting mode** fest:
* `agent speaks first` – die Begrüßung wird gesprochen, sobald der Anruf verbunden ist (typisch bei eingehenden Anrufen).
* `user speaks first` – der Assistent wartet auf den Anrufer (typisch bei ausgehenden Anrufen: Die angerufene Person sagt zuerst „Hallo?“).
## Agent
Ein Konversationsagent mit eigenem **name**, eigenen **instructions** und optionaler **voice override**. Das Gespräch bleibt bei diesem Agenten, bis es über eine seiner ausgehenden Kanten übergeben wird.
* Jede ausgehende Kante ist eine mögliche Übergabe; der Assistent nutzt ihre Bezeichnung für die Entscheidung. Siehe [warum Bezeichnungen wichtig sind](/de/flow-builder/overview#warum-edge--und-agent-labels-wichtig-sind).
* Bei leeren Anweisungen dient der System-Prompt des Assistenten (Erweiterter Prompt) als Basis; der Knotentext wird **angehängt**, nicht ersetzt.
* Mit der Stimmen-Überschreibung können unterschiedliche Agenten mit unterschiedlichen Stimmen sprechen.
## Condition
Ein erzwungener Entscheidungspunkt. Du schreibst eine **description** dessen, worüber entschieden wird; der Assistent muss anhand der Kantenbezeichnungen genau eine ausgehende Kante wählen. Nutze diesen Knoten, wenn die Weiterleitung sofort passieren muss.
## Tool
Führt mitten im Gespräch ein wiederverwendbares **API- oder integriertes Tool** aus und gibt das Ergebnis an den Assistenten zurück. Endpunkt, Zugangsdaten, Beschreibung und wiederverwendbares Verhalten werden unter **Tools** bearbeitet.
| Feld | Zweck |
| ----------------------------- | ------------------------------------------------------ |
| **Name and description** | Wie der Assistent versteht, was das Tool tut |
| **URL, method, and headers** | Die HTTP-Anfrage (GET/POST/PUT/PATCH/DELETE) |
| **Parameter schema** | JSON-Schema der Werte, die der Assistent erfassen soll |
| **Timeout** | Wie lange auf die Anfrage gewartet wird |
| **Announcement** | Was beim Start des Tools gesprochen wird |
| **Run asynchronously** | Das Gespräch wird fortgesetzt, während das Tool läuft |
| **Filler phrases and timing** | Wechselnde Floskeln bei längeren Wartezeiten |
Aktiviere bei langlaufenden Webhooks wie CRM-Einträgen oder Verfügbarkeitsprüfungen **Run asynchronously** und hinterlege zwei oder drei Füllphrasen. So bleibt das Gespräch für den Anrufer flüssig, während die Anfrage im Hintergrund läuft.
## Transfer (blind)
Leitet den Anruf sofort an eine **phone number or SIP URI** weiter (SIP REFER), optional nach einer kurzen **announcement**. Der Assistent verlässt den Anruf; die empfangende Person wird nicht eingewiesen.
## Warm Transfer
Die Premium-Übergabe: Der Anrufer bekommt **hold music**, der Assistent ruft die Zielperson (eine Mitarbeiterin oder einen Mitarbeiter) an, **brieft sie mit einer KI-generierten Zusammenfassung** des bisherigen Gesprächs und verbindet die beiden erst danach. Die Zielperson kann annehmen oder ablehnen; Voicemail auf der Zielseite wird erkannt.
| Feld | Zweck |
| ---------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Target** | Ein Famulor-Loop-Nutzer, eine Nebenstelle, Ringgruppe oder Warteschlange – oder eine externe Nummer im E.164-Format oder als `sip:`-URI. Du kannst die Nummer auch vom Assistenten während des Anrufs bestimmen lassen |
| **Outbound phone number** | Die Nummer, mit der die Zielperson angerufen wird (benötigt einen Outbound-Trunk) |
| **Hold message** | Was der Anrufer hört, bevor er in die Warteschleife kommt |
| **Connected message** | Was der Anrufer hört, sobald die Zielperson in der Leitung ist |
| **Briefing initial message** | Das Erste, was der Assistent zur Zielperson sagt |
| **Summary instructions** | Wie der Assistent das Gespräch für die Zielperson zusammenfasst |
| **Ringing timeout** | Wie lange die Zielperson klingeln soll (5–120 Sekunden; Standard 30) |
| **Hold music** | Ob Wartemusik gespielt wird und welcher verfügbare Titel verwendet wird |
| **Fallback** | Gespräch fortsetzen, Anruf beenden oder blind weiterleiten, wenn die Zielperson nicht abnimmt oder ablehnt |
Die Ergebnisse eines Warm Transfers (`started` / `completed` / `failed`) werden als Anrufereignisse erfasst.
## Collect
Strukturierte Datenerfassung mit **integrierter Validierung, Nachfrage und Bestätigung** – deutlich zuverlässiger, als darauf zu hoffen, dass das LLM eine E-Mail-Adresse korrekt transkribiert.
* **Types:** `name`, `email`, `phone`, `address`, `date of birth`, `dtmf` (Ziffern über die Tastatur oder gesprochen), `credit_card` (Zahlungskarte).
* **Variable** (erforderlich): Das Ergebnis wird unter diesem Namen gespeichert und im `call.completed`-Webhook mitgeliefert.
* **Prompt**: optionale zusätzliche Anweisungen zum integrierten Dialog.
* **Max attempts** (Standard 3): Nach dem letzten fehlgeschlagenen Versuch folgt der Flow der mit `failed` bezeichneten Kante, falls vorhanden.
* **DTMF digits**: bei Typ `dtmf`, wie viele Ziffern erfasst werden.
* **Timeout and stop key** (`dtmf`, festgelegt am zugewiesenen Tool **Collect keypad**): wie lange der Anrufer Zeit hat, bevor der Versuch abläuft (1–30 s, Standard 5 s), und welche Taste – `#` oder `*` – die Eingabe vorzeitig beendet, statt das Timeout abzuwarten.
* **Payment card:** benötigt das Tool **Collect payment card** und ein berechtigtes verbundenes Stripe-Konto. Während des Anrufs werden die Zahlungsdaten sicher erfasst. Gespeichert werden nur eine wiederverwendbare Zahlungsmethoden-Referenz und nicht vertrauliche Anzeigedaten; die vollständige Kartennummer und der Sicherheitscode werden niemals gespeichert. Verbinde Stripe zuerst unter **Tools → Agent Connectors**.
## DTMF
Fordert den Anrufer auf, eine feste Anzahl **Ziffern auf der Telefontastatur** einzugeben – gesprochene Ziffern funktionieren auch. Das zugewiesene Tool **DTMF input** legt fest, wie viele Ziffern erfasst werden (1–32); der Anrufer hat etwa vier Sekunden pro Ziffer, und `#` beendet die Eingabe vorzeitig. Nutze `collect` mit Typ `dtmf`, wenn du Validierung und Wiederholungsversuche brauchst; für schnelle Menüauswahlen reicht dieser einfachere Knoten.
Gib dem Anrufer eine klare Ansage in normalen Worten – die Beschreibung des zugewiesenen Tools bestimmt, wonach der Assistent fragt. Schreib sie so, wie der Anrufer sie hören soll: „Bitte gib deine Kontonummer ein und bestätige anschließend mit #“, oder bei einem Menü: „Drücke die 1 für Support, die 2 für Vertrieb.“ Ein Anrufer, der vorher nicht angeleitet wird, fängt oft an zu sprechen, statt Tasten zu drücken.
## End
Beendet den Anruf, optional nach einer gesprochenen **farewell**. Gib deinen Flows immer ein explizites Ende – das sorgt für saubere Anruf-Status und verhindert, dass das Gespräch abdriftet, nachdem seine Aufgabe erledigt ist.
## Zentrale Tool-Bibliothek
**Add node** öffnet eine durchsuchbare Tool-Bibliothek. Wiederverwendbare Einstellungen bleiben auf der Tools-Seite verwaltet:
| Registry-Tool | Platzierung im Flow |
| ------------------------ | ----------------------------------------------------------------------------- |
| API | Allgemeiner **Tool**-Knoten |
| Anrufweiterleitung | Eigener **Transfer**-Knoten |
| Warm Transfer | Eigener **Warm Transfer**-Knoten |
| DTMF-Eingabe | Eigener **DTMF**-Knoten |
| Tasteneingaben erfassen | Eigener **Collect**-Knoten |
| Andere integrierte Tools | Allgemeiner referenzierter **Tool**-Knoten |
| MCP-Server | Nur assistentenweite Zuweisung; kein einzelner deterministischer Flow-Schritt |
Über **Edit in Tools** änderst du die wiederverwendbaren Einstellungen. Die Änderung gilt für jeden Assistenten und Flow, der das Tool verwendet.
Tool-, Transfer-, Warm-Transfer-, DTMF- und Collect-Keypad-Knoten wählen ein wiederverwendbares Tool auf der Tools-Seite. Ist ein ausgewähltes Tool nicht mehr verfügbar, folgt der Knoten seinem konfigurierten Fehlerpfad und die Anrufdetails zeigen das Problem.