Custom HTTP

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

Overview

Custom HTTP tools allow you to define API calls that your agent can execute during text conversations (SMS, WhatsApp, Instagram, Gmail). 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

Basic Information

HTTP Configuration

Request Parameters

Each request parameter has:

Authentication

Store credentials securely that can be used in headers and request body:

Parameter Modes

Dynamic Mode

When set to Dynamic, the LLM determines the value based on the conversation context. The description helps the AI understand what value to extract from the conversation.

Example: first_name with description “The customer’s first name mentioned in the conversation”

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 automatically.

Example: CRM Update Tool

Tool Name: Update CRM Contact
Description: Updates contact information in the CRM system
API URL: https://api.yourcrm.com/contacts/update
Method: POST
Headers:
  - Authorization: Bearer {api_token}
Request Parameters:
  - first_name (Variable): {{first_name}}
  - last_name (Variable): {{last_name}}
  - email (Dynamic): The customer's email if mentioned
  - notes (Dynamic): Summary of the conversation
Authentication:
  - api_token: your-secret-api-key

Best Practices

• Use descriptive tool names — The AI uses the name to understand the tool’s purpose
• Provide clear descriptions — Ambiguous descriptions lead to incorrect tool usage
• Use Variable mode when possible — Pre-filled data is more reliable than dynamic extraction
• Test thoroughly — Verify the tool works before deploying to production
• Handle errors gracefully — Ensure your API returns meaningful error messages