​

Integrate any system with custom function

​

Overview

​

When to use

• Connect to external APIs
• Integrate with business systems
• Access databases
• Trigger workflows
• Custom business logic

​

Configuration

​

Function Definition

• Endpoint URL - API endpoint to call
• Method - HTTP method (GET, POST, PUT, DELETE)
• Headers - Authentication and content headers
• Parameters - Dynamic parameters from conversation
• Response Mapping - How to handle responses

​

Authentication Options

• API Key - Header-based authentication
• OAuth 2.0 - Token-based authentication
• Basic Auth - Username/password
• Custom - Custom authentication scheme

​

Implementation

{
  "function": "custom_function",
  "parameters": {
    "endpoint": "https://api.example.com/customers",
    "method": "POST",
    "headers": {
      "Authorization": "Bearer your_api_key",
      "Content-Type": "application/json"
    },
    "body": {
      "name": "{{user_name}}",
      "email": "{{user_email}}",
      "phone": "{{user_phone}}"
    },
    "response_mapping": {
      "success": "response.status == 201",
      "customer_id": "response.data.id"
    }
  }
}

​

Best Practices

• Secure API credentials
• Handle errors gracefully
• Validate parameters
• Rate limiting considerations
• Response time optimization

​

Next Steps

• Code Tool
• Extract Dynamic Variables