tool-calls

POST

https://api.flireo.nl/v1/webhooks/tool-calls

Last modified:2026-03-25 11:41:55

Maintainer:Not configured

Wordt verstuurd wanneer de AI-assistent een of meer tools wil uitvoeren tijdens een gesprek.

Je server ontvangt een lijst van tool-aanroepen (toolCallList) en moet synchroon voor elke aanroep een resultaat teruggeven. De AI pauzeert het gesprek totdat de resultaten ontvangen zijn.

Vereiste response tijd: < 20 seconden per tool-aanroep (daarna time-out).

Gebruik: Sla afspraken op in je agenda, zoek klantgegevens op in je CRM, controleer voorraadinformatie — alles wat de assistent in real-time nodig heeft.

Let op: Stuur altijd precies één resultaat terug in results[0].result.

Request

Authorization

Bearer Token

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

Resultaten van de tool-uitvoering. Geef voor elke toolCallId uit de request een resultaat terug.

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.flireo.nl/v1/webhooks/tool-calls' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "eventTimestamp": 1774435909719,
    "eventType": "tool-calls",
    "callId": "c1d2e3f4-a5b6-7890-cdef-1234567890ab",
    "fromCaller": "+31612345678",
    "toAssistant": "+31201234567",
    "tasksInitiated": [
        {
            "taskId": "call_abc123def456",
            "taskName": "lookup_contact",
            "taskPayload": "{\"phone_number\": \"+31612345678\"}"
        }
    ],
    "userMetadata": {
        "klant_id": "12345"
    }
}'

Response Example

{
    "results": [
        {
            "result": "Contact gevonden: Jan de Vries, klantnummer 12345, openstaand saldo €0,00."
        }
    ]
}

Modified at 2026-03-25 11:41:55

status-update

end-of-call-report