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

# Midcall KI-Tool

> Erstelle Midcall-Tools für Live-API-Aufrufe im Gespräch, damit deine Assistentin Daten abrufen, schreiben und Entscheidungen treffen kann.

Mit dem **Midcall Tool** kann deine Assistentin **während des Gesprächs** Automationen auslösen - zum Beispiel Kundendaten abfragen, Telefonnummern abgleichen oder Terminverfügbarkeit prüfen.

<div style={{ position: "relative", paddingBottom: "56.25%", height: 0 }}>
  <iframe style={{ position: "absolute", top: 0, left: 0, width: "100%", height: "100%", border: 0 }} src="https://www.tella.tv/video/vid_cmn385rzm00p807mg1ict5c8p/embed?b=0&title=0&a=1&loop=0&t=0&muted=0&wt=0&o=1" allowFullScreen allowTransparency />
</div>

## 1. Wo du Midcall Tools findest

Es gibt einen eigenen Bereich **Werkzeuge während des Anrufs** (unterhalb der Wissensdatenbank). Dort kannst du dein erstes Tool anlegen, z. B. "Terminverfügbarkeit prüfen".

## 2. Beschreibung ist entscheidend

Die **Tool-Beschreibung** ist für die KI wie ein Mini-Prompt: Sie entscheidet, **wann** das Tool aufgerufen wird.

* Beschreibe klar den Auslöser (z. B. "wenn Kunde nach Termin fragt").
* Definiere gewünschtes Verhalten und Ziel.
* Praktischer Tipp: Beschreibungen häufig auf **Englisch** formulieren, da viele Modelle das sehr stabil auswerten.

## 3. HTTP-Methode richtig wählen

* **GET**: Daten abrufen (z. B. freie Termine laden)
* **POST**: neue Daten erstellen (z. B. Neukunde anlegen)
* **PUT**: Datensatz komplett aktualisieren/ersetzen
* **PATCH**: einzelne Felder gezielt ändern
* **DELETE**: Daten löschen

## 4. Header und Parameter

Viele Integrationen arbeiten mit JSON - `Content-Type: application/json` ist oft bereits passend.

Bei **Werkzeugparametern** gilt:

* Parameternamen exakt wie von der Ziel-API erwartet setzen (1:1)
* passenden Typ wählen (`Text`, `Zahl`, `wahr/falsch`)
* präzise Beschreibung je Parameter hinterlegen, damit die KI am Telefon die richtigen Werte einsetzt

## 5. Endpoint mit Webhook und `/sync`

Wenn deine direkte API z. B. vorgelagerte Authentifizierung braucht (etwa Bearer-Token-Logik), nutze statt des direkten API-Links oft besser eine **Automation mit Webhook-Trigger**.

Wichtig: Den Webhook-Endpunkt für Midcall mit **`/sync`** erweitern.

Beispiel:

`https://automation.famulor.de/webhook/abc123/sync`

Ohne `sync` kann die KI oft nur senden, aber keine Antwort sauber zurückbekommen.

## 6. Tool dem Assistenten zuweisen

Im Assistenten unter **Prompt & Werkzeuge** nach unten zu **Werkzeuge während des Anrufs** scrollen und das Tool auswählen.

Optionaler Best Practice: Im System-Prompt zusätzlich festhalten, **wann** genau das Tool genutzt werden soll (z. B. Termin-Check bei Terminwunsch).

<Tip>
  Teste jedes Midcall Tool mit realistischen Gesprächsfällen. Wenn Trigger nicht zuverlässig feuern, liegt es fast immer an einer zu allgemeinen Beschreibung.

  Vertiefung: [Werkzeuge während des Anrufs](/de/ai-assistants/custom-mid-call-tools), [Webhook-API](/de/automation/webhook-api) und [Tool per API erstellen](/de/api-reference/mid-call-tools/create-tool).
</Tip>

<Tip>
  Statt einzelner HTTP-Aktionen ein ganzes Toolset auf einmal? Externen **MCP-Server** verbinden — Tools werden automatisch erkannt. Siehe [MCP-Server](/de/platform/mcp-servers).
</Tip>