Retell AI Einrichtung

Retell AI Einrichtung

Retell AI unterstützt zwei Methoden zur Verbindung mit FlowCaptain: MCP Nodes (empfohlen) und Custom Functions.

Methode 1: MCP Node (Empfohlen)

MCP Nodes ermöglichen Retell, alle FlowCaptain-Tools automatisch zu erkennen. Keine manuelle Endpunkt-Konfiguration nötig.

1. Öffnen Sie Ihren Retell-Agenten
2. Fügen Sie einen MCP Node zu Ihrem Agenten-Flow hinzu
3. Setzen Sie die URL auf:

   https://api.flowcaptain.ai/mcp
   

4. Setzen Sie den Authentication-Header auf:

   Authorization: Bearer sk_live_ihr_api_schluessel
   

5. Speichern — Retell erkennt automatisch diese Tools:
   • check_availability — Verfügbare Zeitfenster prüfen
   • book_appointment — Termin buchen
   • cancel_appointment — Bestehenden Termin stornieren
   • reschedule_appointment — Termin umbuchen

Methode 2: Custom Function

Wenn Sie manuelle Kontrolle bevorzugen, richten Sie eine Custom Function für jede Aktion ein.

Beispiel: Verfügbarkeit prüfen

1. Fügen Sie einen Custom Function-Knoten in Ihrem Retell-Agenten hinzu
2. Konfigurieren Sie:
   • Name: checkAvailability
   • URL: https://api.flowcaptain.ai/api/v1/check-availability
   • Methode: POST
   • Headers: Authorization: Bearer sk_live_ihr_api_schluessel
3. Definieren Sie den Parameter:
   • Name: checkAvail (Typ: string)
   • Beschreibung: "Die Anfrage des Anrufers zur Terminverfügbarkeit"
4. Wiederholen Sie dies für Buchungs-, Stornierungs- und Umbuchungs-Endpunkte

Anfrageformat

Retell sendet Custom-Function-Anfragen als:

{
  "args": {
    "checkAvail": "Haben Sie am Montag noch etwas frei?"
  }
}

FlowCaptain mappt args.checkAvail automatisch auf den query-Parameter.

Tipps

• MCP Nodes sind einfacher — ein Node ersetzt vier Custom Functions
• Verwenden Sie den Parameter callerIdNumber, um die Telefonnummer des Anrufers für die Terminsuche zu übergeben
• Testen Sie Ihr Setup, indem Sie den Voice Bot fragen: "Was ist nächste Woche frei?"