> ## 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.

# Integrierte Tools

> Gib Assistenten sichere Aktionen für Anrufe, Nachrichten, Terminplanung und Datenerfassung

Mit integrierten Tools kann ein Assistent während eines Gesprächs freigegebene Aktionen ausführen. Konfiguriere sie unter **Assistant → Tools** und beschreibe klar, wann das jeweilige Tool verwendet werden darf.

Ist ein Tool nicht verfügbar oder falsch konfiguriert, erhält der Assistent ein sicheres Fehlerergebnis und kann das Gespräch fortsetzen.

## Verfügbare Tools

| Tool                      | Funktion                                                                                     |
| ------------------------- | -------------------------------------------------------------------------------------------- |
| **End call**              | Beendet den Anruf, nachdem der Assistent die Anfrage erledigt und sich verabschiedet hat     |
| **Call transfer**         | Verbindet den Anrufer zu einer konfigurierten Telefonnummer weiter                           |
| **Warm call transfer**    | Informiert eine Kollegin oder einen Kollegen, bevor der Anrufer ins Gespräch geholt wird     |
| **Transfer to assistant** | Übergibt den laufenden Anruf an einen anderen Assistenten im selben Workspace                |
| **Send SMS**              | Sendet eine Textnachricht an den Anrufer oder eine konfigurierte Nummer                      |
| **Send email**            | Sendet eine feste, vorlagenbasierte oder vom Assistenten formulierte E-Mail                  |
| **Business hours**        | Prüft einen wöchentlichen Öffnungszeitenplan in der Zeitzone des Assistenten                 |
| **Schedule callback**     | Bestätigt einen künftigen Rückruf und trägt ihn unter **Audience → Scheduled Callbacks** ein |
| **Collect payment card**  | Erfasst eine Zahlungsmethode sicher in deinem verbundenen Zahlungskonto                      |
| **Set call variable**     | Speichert einen Wert für spätere Flow-Bedingungen, Tools, E-Mails und Webhooks               |

Kalenderverfügbarkeit und Buchungen konfigurierst du über [Kalender & Buchung](/de/assistants/calendar-booking). Tastatureingaben werden über einen **Collect**-Knoten im [Flow Builder](/de/flow-builder/overview) konfiguriert.

## Weiterleitungen

### Telefonische Weiterleitung

Wähle ein Ziel, den Übergabetyp (kalt oder warm) und die Bedingung, unter der der Assistent weiterleiten soll – beschreibe sie so detailliert wie möglich, denn eine präzise Formulierung macht den Auslöser zuverlässiger. Du kannst die Zielnummer auch dynamisch vom Assistenten bestimmen lassen, statt sie festzulegen.

**Cold transfer** verbindet den Anrufer direkt mit dem Ziel. Lege ein Klingel-Timeout fest (15–80 Sekunden, standardmäßig 30), bevor der Versuch als unbeantwortet gilt.

**Warm transfer** informiert eine Kollegin oder einen Kollegen, bevor der Anrufer verbunden wird – nutze sie, wenn die empfangende Person zuerst Kontext braucht. Sie benötigt einige zusätzliche Einstellungen:

| Einstellung              | Zweck                                                                               |
| ------------------------ | ----------------------------------------------------------------------------------- |
| Outbound number          | Eine Workspace-Nummer mit ausgehendem Trunk, über die die Zielperson angerufen wird |
| Hold music               | Spielt dem Anrufer vor, während die Zielperson informiert wird                      |
| Hold message             | Wird dem Anrufer unmittelbar vor der Warteschleife vorgelesen                       |
| Briefing initial message | Das Erste, was der Assistent sagt, sobald die Zielperson abnimmt                    |
| Summary instructions     | Was der Assistent der Zielperson über den Anruf mitteilen soll                      |
| Connected message        | Wird dem Anrufer vorgelesen, sobald die Zielperson verbunden ist                    |
| Ringing timeout          | 5–120 Sekunden (standardmäßig 30), bevor der Versuch als Timeout gilt               |

**Fallback on failure** legt fest, was passiert, wenn die Zielperson nicht abnimmt: Der Assistent führt das Gespräch selbst weiter und bietet Alternativen an, verabschiedet sich und beendet den Anruf, oder verbindet den Anrufer ohne Briefing direkt mit einer Ausweichnummer.

### Übergabe an einen anderen Assistenten

Übergib einen laufenden Anruf an einen anderen Assistenten im selben Workspace – nützlich für Sprach-Routing (Sprache des Anrufers erkennen, an einen sprachspezialisierten Assistenten weiterleiten), einen abweichenden Compliance- oder Einwilligungspfad (Wechsel zu einem Assistenten mit anderer Aufzeichnungskonfiguration) oder das Verketten spezialisierter Assistenten (Vertrieb → Onboarding, Triage → Experte), ohne für jeden Schritt eine eigene Nummer bereitzustellen.

Wähle den Zielassistenten und einen **Context Engineering Plan** – wie viel vom Gespräch er erhält. Die Optionen reichen vom vollständigen Nachrichtenverlauf über eine Zusammenfassung plus die letzten Nachrichten (empfohlen) und nur die letzten Nachrichten bis zu einer reinen Zusammenfassung oder gar keinem vorherigen Kontext für eine saubere Übergabe. Optional legst du eine **message before transfer** fest und entscheidest, ob der Zielassistent nach der Übernahme seine eigene erste Nachricht spricht.

Die **Squad**-Ansicht zeigt den entstehenden Routing-Graphen der Assistenten. Übergaben an denselben Assistenten werden abgelehnt, und ein Übergabelimit verhindert Schleifen.

## Den Anruf beenden

Formuliere die Beschreibung von **End call** so klar, wie du es einer neuen Mitarbeiterin oder einem neuen Mitarbeiter erklären würdest – das Tool feuert nur, wenn seine Bedingung tatsächlich zutrifft:

* **Simple** – den Anruf beenden, sobald alle Fragen beantwortet sind und der Anrufer keine Hilfe mehr braucht.
* **More detailed** – zusätzlich beenden nach einer erfolgreichen Buchung, sobald sich der Anrufer verabschiedet oder das Gespräch eindeutig abgeschlossen ist.

Decke die realistischen Verläufe ab, die du erwartest (Erfolg, Verabschiedung, „nichts weiter nötig"), damit der Assistent weder zu früh auflegt noch einen abgeschlossenen Anruf unnötig verlängert.

## SMS und E-Mail

Bei SMS legst du fest, ob der Empfänger der Anrufer oder eine feste E.164-Nummer ist. Der Assistent muss eine Workspace-Nummer mit aktiviertem ausgehendem Messaging verwenden.

Bei E-Mail wählst du einen verifizierten Absender und einen von drei Inhaltsmodi:

* **Assistant-written** – erstellt Betreff und Text aus dem Gespräch.
* **Fixed** – sendet immer genau den konfigurierten Inhalt.
* **Template** – setzt Anrufvariablen ein und bricht ab, wenn ein benötigter Wert fehlt.

Ein erfolgreicher Versand bedeutet, dass die Nachricht zur Zustellung angenommen wurde; er garantiert nicht die Zustellung im endgültigen Postfach oder auf dem Gerät.

## Geschäftszeiten und Rückrufe

Geschäftszeiten können pro Wochentag ein oder mehrere Zeitfenster enthalten. Die Prüfung verwendet immer die konfigurierte Zeitzone des Assistenten.

Für Rückrufe legst du das Ziel und die maximale Anzahl an Tagen fest, die Kunden im Voraus buchen dürfen. Der Assistent muss die vereinbarte Zeit wiederholen und sich bestätigen lassen. Vergangene Termine und Termine außerhalb des erlaubten Fensters werden abgelehnt.

## Zahlungskarten erfassen

Verbinde dein Zahlungskonto unter **Tools → [Agent Connectors](/de/assistants/agent-tools#agent-connectors)**, dann füge **Collect payment card** zum Assistenten oder einem Flow-Collect-Knoten hinzu. Der Anrufer gibt seine Kartendaten sicher ein. Famulor zeigt die vollständige Kartennummer oder den Sicherheitscode nie im Gesprächsverlauf an.

Nutze diese Funktion nur dort, wo deine Rechtsgrundlage, dein Einwilligungsablauf und deine Kontoberechtigungen das erlauben.

<Note>
  Das Erfassen einer Zahlungskarte kostet zusätzliche Credits zum Workspace-Satz **Card collection**; aktuelle Sätze findest du auf der [Nutzungsseite](https://app.famulor.io/usage).
</Note>

## Anrufvariablen und aktuelle Uhrzeit

Mit **[Set call variable](/de/assistants/variables)** speichert der Assistent freigegebene Werte wie einen Firmennamen oder eine Terminpräferenz. Begrenze die erlaubten Schlüssel, wenn der Assistent nur bestimmte Felder aktualisieren soll.

Jeder Assistent verfügt außerdem über ein Tool für die aktuelle Uhrzeit. Es nutzt die Zeitzone des Assistenten, um Angaben wie „morgen um 15 Uhr" oder „nächsten Dienstag" aufzulösen.

## API und MCP

Integrierte Tools lassen sich über `PATCH /api/v1/assistants/{id}` und die Assistenten-Tools in [MCP](/de/api/mcp) verwalten. Mit `GET /api/v1/email-senders` oder dem entsprechenden MCP-Tool listest du verifizierte Absender auf, ohne Zugangsdaten offenzulegen.