FlowCaptainFlowCaptain
Registrieren

Platform Setup

Connect FlowCaptain to your own voice bot platform: Retell AI, VAPI, or other platforms.

Platform Setup

If you want to connect FlowCaptain to your own voice bot platform, here are guides for the most common platforms.

A separate voice bot platform is not required. FlowCaptain includes a built-in voice assistant that works right away. This page is for advanced users who want to integrate FlowCaptain into existing voice bot infrastructure.

Retell AI

Retell AI supports three connection methods:

Autopilot via Custom Function (Recommended)

  1. Add a Custom Function:
    • Name: autopilot
    • URL: https://api.flowcaptain.ai/api/v1/autopilot
    • Method: POST
    • Headers: Authorization: Bearer sk_live_your_api_key
  2. Define the parameters:
    • message (string, required) — "What the caller just said"
    • sessionId (string, optional) — "Session ID from the previous response"
    • callerIdNumber (string, optional) — "The caller's phone number"
  3. System prompt:
Call the "autopilot" function for EVERY caller message.
Forward the "message" field verbatim — do not change anything.
Speak the response in the "speak" field verbatim — do not add or remove anything.
When "done" is true, say goodbye and end the call.
Pass the "sessionId" back with every call.
NEVER try to answer questions yourself.

Important agent settings: Set "Speak During Execution" to Off, "Talk After Action Completed" to On, and "Talk While Waiting" to Off. Incorrect settings can cause messages to not be forwarded.

MCP Node

  1. Add an MCP Node
  2. URL: https://api.flowcaptain.ai/mcp
  3. Header: Authorization: Bearer sk_live_your_api_key
  4. Retell auto-discovers all tools

Custom Functions (individual)

Set up separate Custom Functions for each endpoint (/api/v1/check-availability, /api/v1/book-appointment, etc.). Requires your own system prompt for conversation flow.

VAPI

  1. Add an MCP Tool integration
  2. URL: https://api.flowcaptain.ai/mcp
  3. Authorization header: Bearer sk_live_your_api_key
  4. VAPI auto-discovers all tools

Alternatively, configure individual HTTP tools for the REST endpoints.

Other Platforms

Any platform that supports HTTP calls can use FlowCaptain:

  • Autopilot — POST https://api.flowcaptain.ai/api/v1/autopilot for full conversation management
  • REST API — Individual endpoints for availability, booking, cancellation, rescheduling
  • MCP — POST https://api.flowcaptain.ai/mcp for automatic tool discovery

All endpoints require the Authorization: Bearer sk_live_... header.

Prompt Tips for MCP/REST Users

When using MCP or individual REST endpoints, your voice bot manages the conversation flow. Keep in mind:

  • Natural language only — Callers say "next Monday", not "2026-03-15"
  • Confirm before booking — Always read back the time slot and get confirmation
  • Offer alternatives — FlowCaptain returns alternatives when the requested time is taken
  • Use caller ID — Pass callerIdNumber so FlowCaptain can find appointments without asking for phone numbers
  • Don't ask for phone numbers — Speech recognition has ~70% error rate on phone numbers