Skip to navigation
Integraties

Webhooks

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

Met de integratie Webhook Tool stel je 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 het moet gebruiken.
  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 het antwoord 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
NaamToolnaam die de AI ziet, bijvoorbeeld check_order_status
BeschrijvingWanneer en waarom je deze tool gebruikt
MethodeGET, POST, PUT, PATCH of DELETE
URLJe HTTP-endpoint
Responstime-out (seconden)Hoe lang er op je server wordt gewacht: 5–120 seconden, standaard 20
Toewijzen aan agentsReceptionist, Assistant agent of beide
Onderbrekingen uitschakelenVoorkomt dat de beller onderbreekt terwijl de tool wordt uitgevoerd
Request HeadersOptionele headers die met elk request worden verzonden. Type is Value of Secret. Een Secret wordt versleuteld opgeslagen en nooit meer getoond. Een header afkomstig van ElevenAgents kan Environment variable of Variable tonen, met een melding dat deze is ingesteld in het agents-platform.
Path ParametersWordt getoond wanneer de URL placeholders tussen accolades bevat, zoals /orders/{order_id}. Bewerk de URL om er een toe te voegen of te verwijderen.
Body ParametersParameters die in de requestbody worden verzonden. Value kan From the conversation of een Fixed value zijn.
Query ParametersParameters die als URL-querystrings worden verzonden. Value kan From the conversation of een Fixed value zijn.

Parameters

Elke parameter heeft:

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

Gebruiksscenario’s

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

Voorbeeld

Een loodgietersbedrijf maakt een webhooktool:

  • Naam: check_service_area
  • Beschrijving: “Controleer of we service verlenen in de postcode van de beller en wat het eerstvolgende beschikbare tijdslot is.”
  • URL: https://api.mybusiness.com/check-area
  • Methode: POST
  • Request Headers: Authorization ingesteld op de API-sleutel van het bedrijf
  • Body Parameters: zip_code (string, vereist), service_type (string, vereist)

Wanneer een beller naar service in diens gebied vraagt, verzamelt de receptionist de postcode, roept deze de webhook aan en vertelt het resultaat.

Webhooktools zijn beschikbaar in elk abonnement.