Skip to navigation
Integraties

Webhooks

Geef je receptionist aangepaste tools die je HTTP-endpoints aanroepen.

De integratie Webhook Tool maakt je HTTP-endpoints beschikbaar als tools die je receptionist of bedrijfsassistent tijdens gesprekken kan aanroepen. De AI bepaalt op basis van het gesprek wanneer het endpoint wordt aangeroepen.

Hoe webhooktools werken

Wanneer je een webhooktool maakt, definieer je:

  1. Een HTTP-endpoint om aan te roepen.
  2. Een beschrijving van wat het doet, zodat de AI weet wanneer deze moet worden gebruikt.
  3. Parameters die de AI uit het gesprek moet verzamelen.

Wanneer het gesprek tijdens een gesprek overeenkomt met het doel van de tool, verzamelt je receptionist de parameters, roept het endpoint aan en gebruikt de reactie om het gesprek voort te zetten.

Een webhooktool maken

Ga naar Integrations, selecteer Add integration en kies Webhook Tool. Configureer de onderstaande velden en selecteer Enable. Je kunt meerdere webhooktools toevoegen.

VeldBeschrijving
NameToolnaam die de AI ziet, bijvoorbeeld check_order_status
DescriptionWanneer en waarom deze tool moet worden gebruikt
MethodGET, POST, PUT, PATCH of DELETE
URLJe HTTP-endpoint
Response timeout (seconds)Hoe lang er op je server wordt gewacht: 5–120 seconden, standaard 20
Assign to agentsReceptionist, Assistant agent of beide
Disable interruptionsVoorkom dat de beller onderbreekt terwijl de tool wordt uitgevoerd
Request HeadersOptionele headers die bij elk verzoek worden verzonden, zoals een API-sleutel
Body ParametersParameters die in de requestbody worden verzonden
Query ParametersParameters die als URL-querystrings worden verzonden

Parameters

Elke parameter heeft:

  • Key: de veldnaam.
  • Type: string, number of boolean.
  • Description: welke waarde de AI uit het gesprek moet halen.
  • Required: of de AI deze moet verzamelen voordat er wordt aangeroepen.

Toepassingen

ScenarioBeschrijvingMethode
CRM opzoekenKlantinformatie in je systeem opzoekenGET
VoorraadcontroleProductbeschikbaarheid in realtime controlerenGET
LeadregistratieGegevens van de beller naar je marketingsysteem sturenPOST
Ticket makenTijdens het gesprek een supportticket makenPOST
PrijsopgaveEen aangepaste prijsopgave berekenen op basis van de wensen van de bellerPOST

Voorbeeld

Een loodgietersbedrijf maakt een webhooktool:

  • Name: check_service_area
  • Description: “Controleer of we de postcode van de beller bedienen en wat het eerstvolgende beschikbare tijdslot is.”
  • URL: https://api.mybusiness.com/check-area
  • Method: POST
  • Request Headers: Authorization ingesteld op de API-sleutel van het bedrijf
  • Body Parameters: zip_code (string, verplicht), service_type (string, verplicht)

Wanneer een beller vraagt naar service in diens regio, verzamelt de receptionist de postcode, roept de webhook aan en vertelt de uitkomst.

Webhooktools zijn beschikbaar in elk abonnement.