assistant-request

Wordt verstuurd voordat een gesprek wordt beantwoord, zodat je server dynamisch kan bepalen welke assistent het gesprek afhandelt.

Flireo stuurt dit event naar de server_url die geconfigureerd is op de assistent of het telefoonnummer. Je server moet synchroon reageren met assistantOverrides om de assistent-configuratie aan te passen, of een lege response {} om de dashboard-configuratie ongewijzigd te gebruiken.

Vereiste response tijd: < 5 seconden (daarna time-out).

Gebruik: Perfect voor multi-tenant setups waarbij je op basis van het binnenkomende telefoonnummer of tijdstip een andere assistent-configuratie wilt inzetten.

Webhook verificatie: Controleer de X-Flireo-Signature header om te verifiëren dat het verzoek daadwerkelijk van Flireo afkomstig is.

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

application/json

Assistent configuratie voor dit gesprek. Geef assistantId terug voor een opgeslagen assistent, of assistant voor een volledig inline configuratie.

Body

curl --location --request POST 'https://api.flireo.nl/v1/webhooks/assistant-request' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data-raw '{ "eventTimestamp": 1774435909719, "eventTimestampISO": "2026-03-25T10:28:28.152Z", "eventType": "assistant-request", "callSession": "c1d2e3f4-a5b6-7890-cdef-1234567890ab", "callId": "c1d2e3f4-a5b6-7890-cdef-1234567890ab", "fromCaller": "+31612345678", "toAssistant": "+31201234567" }'

{ "assistantOverrides": { "firstMessage": "Goedemiddag, u spreekt met de AI-assistent. Hoe kan ik u helpen?", "metadata": { "user-metadata": { "klant_id": "12345" } } } }

Request

Responses