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.

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://your-api-server.com' \ --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?", "maxDurationSeconds": 300, "metadata": { "user-metadata": { "klant_id": "12345", "prioriteit": "hoog" } } } }

Request

Responses