Custom HTTP

Build custom HTTP tools to connect your voice agent to any external API or service.

Overview

Custom HTTP tools allow you to define API calls that your agent can execute during voice conversations. This is useful for integrating with internal systems or APIs not available in the marketplace.

Creating a Custom Tool

Navigate to your agent’s Tools tab, click Add Tool, and select Custom HTTP.

Configuration Fields

Body Parameters

Each body parameter has:

Dynamic Mode

When set to Dynamic, the LLM determines the value based on the conversation context. Add a description to help the AI understand what value to extract.

Variable Mode

When set to Variable, select from your predefined variables (e.g., {{first_name}}, {{last_name}}). The value will be pulled from the lead’s data.

Example: CRM Update Tool

Tool Name: Update CRM Contact
When to Execute: When the caller provides updated contact information
API Endpoint: https://api.yourcrm.com/contacts/update
Method: POST
Headers:
  - Authorization: Bearer {api_token}
Body Parameters:
  - first_name (Variable): {{first_name}}
  - last_name (Variable): {{last_name}}
  - phone (Dynamic): The caller's phone number
  - notes (Dynamic): Summary of the call

Best Practices

• Use descriptive tool names — The AI uses the name to understand the tool’s purpose
• Provide clear execution conditions — Ambiguous conditions lead to incorrect tool usage
• Test with sample calls — Verify the tool works before deploying to production
• Handle errors gracefully — Configure fallback messages if the API call fails