De API gebruiken met een API-sleutel
Gebruik je bots vanuit je eigen software, een intranet of een app. Je maakt een API-sleutel in het portaal en kiest welke bots en gegevens hij mag gebruiken.
Met de API gebruik je je bots vanuit je eigen software: een intranet, een app of een CRM. Je stelt vragen aan een bot, haalt leads op of past de inhoud aan zonder het portaal te openen.
Wat kun je met de API?
- Je bots opvragen en een vraag stellen aan een bot, ook met streaming. Je kunt een gesprek ophalen en voortzetten.
- Met Toegang tot leads: leads, klachten en bugmeldingen ophalen, de opvolging aanpassen, reservaties bekijken en rechtstreeks reserveren, gesprekken oplijsten en webhooks instellen.
- Met Inhoud beheren: offerteformulieren, reservaties (ook sluitingsdagen), FAQ's en bronnen aanpassen.
- Met Mag bots aanmaken: nieuwe bots aanmaken. Elke bot heeft een eigen plan, dus een extra bot kost geld. De aanroeper moet die prijs bevestigen.
- Cijfers en inzichten van een bot opvragen.
Alle calls, met voorbeelden in curl, JavaScript en Python, staan in de API-documentatie.
Een API-sleutel maken
- Ga in het menu naar Verbindingen → API-sleutels.
- Klik op Nieuwe sleutel.
- Geef een Naam, zodat je later weet waarvoor de sleutel dient.
- Kies Toegang tot alle bots (ook bots die je later toevoegt), of zet het uit en kies bij Bots een selectie.
- Zet aan wat de sleutel extra mag: Mag bots aanmaken, Toegang tot leads en Inhoud beheren. Standaard staat alles uit.
- Klik op Aanmaken.
- Kopieer de sleutel meteen en bewaar hem veilig. Je kunt hem hierna niet meer bekijken. Onder Probeer het staat een eerste call om te testen.
Sleutels beheren
In de lijst zie je per sleutel de toegang, wanneer hij Laatst gebruikt werd en wie hem aanmaakte. Met Bewerken pas je de naam, de bots en de rechten aan. Met Intrekken schakel je een sleutel meteen uit. Toepassingen die hem gebruiken, hebben dan geen toegang meer, en de webhooks die ermee aangemaakt werden, worden verwijderd. Dat kan niet ongedaan gemaakt worden.
Goed om te weten
- Enkel de beheerder van het account (rol Beheerder) maakt en beheert API-sleutels. Zie Team.
- Geef een sleutel enkel de rechten die hij nodig heeft. Met Toegang tot leads kan software contactgegevens van bezoekers lezen.
- Is een sleutel uitgelekt? Trek hem in en maak een nieuwe.
- Wil je leads meteen doorsturen zonder zelf op te vragen? Gebruik webhooks.
- Wil je je bots in ChatGPT of Claude gebruiken, dan heb je geen sleutel nodig. Zie MCP.