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.