API Calls let your agent fetch and send data during conversations. Look up customer information, check order status, book appointments, create tickets — all in real-time while the conversation is happening.
Location: Config Panel (right sidebar) → API Calls toggle
The API Call modal has two main sections.
These are values the AI determines during conversation and passes to your API. Click + Add Parameter to define what the AI should collect.
For example, if you need an order ID to look up status, add a parameter called order_id — the AI will extract it from the conversation and include it in the request.
This is where the magic happens. Map fields from the API response to variables you can use in your prompts.
Click + Add Variable and specify:
customer.name)customer_name)Then use {{api.customer_name}} in your prompt.
You can use variables anywhere in your API configuration:
In URL:
In Headers:
In Query Parameters:
The description tells the AI when to make this call. Be specific:
APIs can fail. In your prompt, tell the agent what to do:
“If customer data isn’t available, greet generically and ask for their name. Don’t mention that a lookup failed.”
Default is 5000ms (5 seconds). For slow APIs, increase this — but remember the caller is waiting.