Tool/Function Call

Webhook

POST

tool-calls

Webhooks

Last modified:2026-01-09 14:25:39

Maintainer:Not configured

Called when the AI needs to execute a tool/function during the conversation.

Sync tools: Must respond within 10 seconds with the result.
Async tools: Respond immediately with 200 OK (fire-and-forget).

Tools are defined in llm_config.tools[] with optional per-tool URL override.

Response Formats

Multiple response formats are supported:

Object format (recommended):

{"results": [{"toolCallId": "tool_abc123", "result": {"name": "Jan"}}]}

Simple format:

{"result": {"name": "Jan"}}

Direct format (your data directly):

{"name": "Jan"}

Error format:

{"error": "Contact niet gevonden"}

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Tool result (for sync tools)

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://your-api-server.com' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "message": {
        "type": "tool-calls",
        "timestamp": "2025-12-13T12:00:00.000Z",
        "call": {
            "id": "5c4d030f-43e3-4e65-899e-8148521e660f",
            "type": "inboundPhoneCall",
            "status": "in-progress"
        },
        "phoneNumber": {
            "number": "+31850835037",
            "name": "Flireo Demo"
        },
        "customer": {
            "number": "+31612345678"
        },
        "toolCallList": [
            {
                "id": "tool_abc123def456",
                "type": "function",
                "function": {
                    "name": "lookup_contact",
                    "arguments": {
                        "query": "Jan de Vries"
                    }
                }
            }
        ]
    }
}'

Response Example

Object format (recommended)

{
    "results": [
        {
            "toolCallId": "tool_abc123def456",
            "result": {
                "name": "Jan de Vries",
                "email": "jan@example.com",
                "phone": "+31612345678"
            }
        }
    ]
}

Modified at 2026-01-09 14:25:39

Dynamic assistant configuration webhook

Call Status Update

Tool/Function Call

Response Formats#

Request

Responses

Response Formats