Skip to main content

HTTP Call

HTTP_CALL lets the AI call an API, endpoint, or webhook during a conversation. The function tool name must match the configuration config_key.

Configuration

The tool may declare zero to 20 variables of type string, number, integer, boolean, or enum.

Webhook authentication

When the endpoint uses a bearer token, configure a header:

Outgoing request

The request may also include config_fields when this content is configured in additional_data.

Expected response

Direct messages

direct_messages accepts:
  • Text: { "type": "text", "content": "..." }
  • Audio: { "type": "audio", "url": "..." }
  • Video: { "type": "video", "url": "..." }
  • Image: { "type": "image", "url": "...", "content": "optional caption" }
  • Document by URL: { "type": "document", "url": "...", "content": "...", "filename": "contract.pdf" }
All types optionally accept active_in_chat. Binary documents can be returned as multipart/form-data, with a json part and a binary part whose name matches the filename declared in the JSON.

Timeout

The maximum effective timeout is 60 seconds. A missing, invalid, zero, or negative value also results in a 60-second timeout.