1. Webhooks
Flireo AI
  • Assistenten
    • Alle assistenten ophalen
      GET
    • Nieuwe assistent aanmaken
      POST
    • Assistent ophalen
      GET
    • Assistent volledig bijwerken
      PUT
    • Assistent gedeeltelijk bijwerken
      PATCH
    • Assistent verwijderen
      DELETE
    • Gekoppeld telefoonnummer ophalen
      GET
    • Telefoonnummer koppelen aan assistent
      POST
    • Telefoonnummer ontkoppelen van assistent
      DELETE
  • Gesprekken
    • Gesprekken ophalen
      GET
    • Gesprek details ophalen
      GET
    • Gesprek verwijderen
      DELETE
    • Direct uitgaand gesprek starten
      POST
  • Contacten
    • Contacten ophalen
      GET
    • Nieuw contact aanmaken
      POST
    • Contact ophalen
      GET
    • Contact volledig bijwerken
      PUT
    • Contact gedeeltelijk bijwerken
      PATCH
    • Contact verwijderen
      DELETE
  • Telefoonnummers
    • Telefoonnummers ophalen
      GET
    • Telefoonnummer bestellen
      POST
    • Telefoonnummer ophalen
      GET
    • Telefoonnummer verwijderen
      DELETE
    • Beschikbare nummers ophalen (national/mobile)
      GET
    • Beschikbare nummers ophalen (legacy)
      GET
    • Nummerbestellingen ophalen
      GET
    • Bestelling ophalen
      GET
  • Geplande Gesprekken
    • Geplande gesprekken ophalen
    • Gesprek inplannen
    • Gepland gesprek ophalen
    • Gepland gesprek bijwerken
    • Gepland gesprek annuleren
  • SIP Connecties
    • SIP connecties ophalen
    • Nieuwe SIP connectie aanmaken
    • SIP connectie ophalen
    • SIP connectie verwijderen
  • Verificatie
    • Verificatiegroepen ophalen
    • Nieuwe verificatiegroep aanmaken
    • Verificatiegroep ophalen
    • Verificatiegroep verwijderen
    • Documenten van verificatiegroep ophalen
    • Document uploaden voor verificatie
    • Verificatie document verwijderen
    • Beschikbare nummers voor verificatiegroep
    • Nummer bestellen via verificatiegroep
    • Verificatiegroep indienen ter goedkeuring
  • Gebruiker
    • Gebruikersprofiel ophalen
    • Gebruikersprofiel ophalen (uitgebreid)
    • Gebruikersprofiel ophalen (legacy)
  • Geavanceerd
    • Bericht injecteren in actief gesprek
    • Kennisbank bevragen
  • Instant Agents
    • Instant agent aanmaken
    • Veelgestelde vragen genereren
  • Webhooks
    • assistant-request
      POST
    • status-update
      POST
    • tool-calls
      POST
    • end-of-call-report
      POST
  • Schemas
    • PaginationMeta
    • ErrorResponse
    • SuccessMessage
    • Assistant
    • AssistantCreateInput
    • AssistantUpdateInput
    • AssistantPhoneNumberLink
    • Call
    • DirectCallInput
    • Contact
    • ContactDetail
    • ContactCreateInput
    • ContactUpdateInput
    • PhoneNumber
    • AvailablePhoneNumber
    • PhoneNumberOrder
    • PhoneNumberOrderInput
    • PhoneNumberOrderResponse
    • ScheduledCall
    • ScheduledCallCreateInput
    • ScheduledCallUpdateInput
    • SipConnection
    • SipConnectionCreateInput
    • VerificationGroup
    • VerificationGroupCreateInput
    • VerificationDocument
    • OrderNumberInput
    • UserProfile
    • CreditsBalance
    • InstantAgentCreateInput
    • InstantAgentResponse
    • GenerateFaqsInput
    • GenerateFaqsResponse
    • InjectMessageInput
    • InjectMessageResponse
    • QueryKnowledgebaseInput
    • WebhookTaskItem
    • WebhookAnalysisObject
    • WebhookRecordingsObject
    • WebhookAssistantRequestPayload
    • WebhookAssistantRequestResponse
    • WebhookStatusUpdatePayload
    • WebhookToolCallsPayload
    • WebhookToolCallsResponse
    • WebhookEndOfCallReportPayload
API Reference
Documentatie
API Reference
Documentatie
Linkedin
  1. Webhooks

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 ********************
or
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 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 Response Example
{
    "results": [
        {
            "result": "Contact gevonden: Jan de Vries, klantnummer 12345, openstaand saldo €0,00."
        }
    ]
}
Modified at 2026-03-25 11:41:55
Previous
status-update
Next
end-of-call-report
Built with