Maak in het dashboard onder Instellingen → Developer een webhook aan met het adres van je eigen systeem. Zodra een debrief klaar is, staat de samenvatting met de actiepunten daar. Geen zin in code? Zet er Zapier of Make tussen. Wil je zelf iets ophalen, dan is er een API met een sleutel.
Wat is het verschil tussen de API en webhooks?
Bij een webhook stuurt Ajora de samenvatting uit zichzelf naar jou, zodra het gesprek klaar is. Bij de API vraag je er zelf om, op het moment dat het jou uitkomt.
Voor de meeste mensen is de webhook wat je wilt. Die zet je een keer aan en daarna gebeurt het vanzelf. De API is er voor als je terug wilt kijken: alle gesprekken met een bepaalde klant ophalen, bijvoorbeeld, of een oude samenvatting opnieuw binnenhalen.
| Webhook | API | |
|---|---|---|
| Wie begint | Ajora, zodra de debrief klaar is | Jij, wanneer je iets nodig hebt |
| Waarvoor | Elk nieuw gesprek automatisch wegschrijven | Terugzoeken en achteraf ophalen |
| Wat je nodig hebt | Een adres waar wij naartoe mogen sturen | Een sleutel om mee in te loggen |
| Typisch gebruik | Gesprek klaar, notitie staat in het CRM | Alle gesprekken met een klant op een rij |
Wat kun je er praktisch mee?
Alles waar je nu na een gesprek nog handmatig iets voor overtypt. De samenvatting bij de juiste klant in het CRM, de actiepunten in je takenlijst, een seintje in Slack als er iets belangrijks is besproken.
De notitie staat al in je CRM
Je hangt op, en voordat je bij je laptop bent staat de samenvatting bij het juiste contact. Omdat het telefoonnummer meekomt, weet je systeem zelf bij wie het hoort.
Actiepunten worden taken
De actiepunten komen apart mee, niet als een lap tekst. Je kunt er dus echt taken van maken in het systeem dat je daarvoor gebruikt.
Je team leest mee zonder te vragen
Stuur de samenvatting naar een Slack-kanaal en iedereen die over die klant gaat weet wat er is afgesproken, zonder dat iemand het hoeft na te vertellen.
Je kennisbank vult zichzelf
Wij doen dit zelf: elk telefoongesprek dat we voeren, landt automatisch in onze eigen kennisbank. Terugzoeken wat een klant drie maanden geleden zei, kost geen moeite meer.
Moet je hiervoor kunnen programmeren?
Nee, niet per se. Met Zapier of Make klik je de koppeling in elkaar zonder een regel code: je plakt het webhook-adres dat je daar krijgt in Ajora, en klikt in Zapier of Make aan waar het naartoe moet.
Heb je een ontwikkelaar of doe je het zelf, dan werk je rechtstreeks met de API en de webhooks. Dat scheelt een tussenpartij en je houdt je gegevens in eigen hand. De volledige technische uitleg staat op debrief.ajora.io/docs/developer; hieronder staat wat je moet weten om te bepalen of het bij je past.
Werk je met Apollo, dan heb je dit allemaal niet nodig: daarvoor is er een kant-en-klare koppeling. Voor andere systemen loopt het via een webhook of de API, met Zapier of Make als tussenstap als je niet wilt programmeren.
Wat stuurt Ajora precies door?
Zodra een debrief klaar is, sturen we de gegevens van het gesprek en de inhoud van de samenvatting naar het adres dat jij opgeeft. Het transcript zit daar nooit bij; dat haal je apart op via de API.
- Het gesprek zelf: wanneer, hoe lang, welk kanaal, en de telefoonnummers en namen van beide kanten
- De titel en de samenvatting van het gesprek
- De actiepunten, als losse punten
- De besluiten die genomen zijn
- De toon van het gesprek
- Een directe link naar de debrief in Ajora
Wat er in dat verslag hoort en hoe het tot stand komt, lees je in gespreksverslag maken met AI.
Er zijn twee momenten waarop we iets sturen: debrief.completed als de samenvatting voor het eerst klaar is, en debrief.updated als je hem daarna in Ajora aanpast. Zo blijft de notitie in je eigen systeem kloppen als je achteraf nog iets verbetert.
Een webhook aanzetten
Zorg dat je een adres hebt om naartoe te sturen
Dat is een webadres dat berichten van ons kan ontvangen. Gebruik je Zapier of Make, dan krijg je dat adres daar met een kopieerknop. Bouw je het zelf, dan is het een endpoint op je eigen server. Het moet
httpszijn.Ga naar Instellingen → Developer
In het Ajora-dashboard op debrief.ajora.io vind je daar het onderdeel voor webhooks en API-sleutels.
Maak de webhook aan
Plak het adres, kies bij welke gebeurtenissen we mogen sturen en sla op. Je krijgt dan eenmalig een geheime sleutel te zien waarmee je kunt controleren dat een bericht echt van ons komt (de signing secret). Hij begint met
dbf_whsec_live_. Bewaar hem meteen, want we laten hem daarna niet opnieuw zien.Bel een keer en kijk of het aankomt
Voer een kort testgesprek. Zodra de debrief klaar is, hoort het bericht binnen te komen op het adres dat je hebt opgegeven. Komt er niets, open dan het Afleverlog bij de webhook. Daar zie je per poging wat je adres terugstuurde.
Bouw je het zelf, controleer dan de handtekening in de header X-Debrief-Signature voordat je iets met het bericht doet. Anders kan iedereen die je adres kent nepgesprekken in je systeem zetten. Hoe je dat nakijkt staat in de documentatie.
Een API-sleutel aanmaken
De API gebruik je om zelf gegevens op te halen. Je maakt de sleutel op dezelfde plek aan, onder Instellingen → Developer.
Maak de sleutel aan
Geef hem een naam waaraan je later herkent waar hij voor is, bijvoorbeeld de naam van het systeem dat hem gebruikt. Je ziet de sleutel eenmalig; hij begint met
dbf_live_. Zet hem meteen in je wachtwoordmanager of je secrets.Kies wat de sleutel mag
Standaard mag een sleutel je gesprekken en debriefs lezen en webhooks beheren. Toegang tot de letterlijke transcripten is een apart recht dat je er bewust bij zet.
Gebruik hem alleen aan de achterkant
Een sleutel hoort in je server of je secrets-manager, nooit in een app of een website waar een bezoeker hem uit de code kan halen. En nooit in een chatvenster van Claude of ChatGPT: daarvoor is de MCP-koppeling.
Wat je daarna kunt ophalen: je gesprekken op een rij, een specifiek gesprek, de debrief bij dat gesprek, en alle gesprekken met een bepaald telefoonnummer. Die laatste is in de praktijk de handigste, want daarmee haal je in één keer de hele geschiedenis met een klant op. Alle adressen beginnen met https://debrief.ajora.io/api, en het telefoonnummer schrijf je internationaal, dus +31612345678.
| Wat je wilt | Wat je aanroept |
|---|---|
| Je gesprekken op een rij | GET /v1/calls |
| Een specifiek gesprek | GET /v1/calls/{id} |
| De samenvatting bij dat gesprek | GET /v1/calls/{id}/debrief |
| Alles met een klant, op telefoonnummer | GET /v1/calls/by-phone/{nummer} |
| Het transcript, als je sleutel dat mag | GET /v1/calls/{id}/transcript |
Waar moet je op letten?
Op drie dingen: de sleutels zie je maar één keer, de transcripten zijn bewust apart afgeschermd, en je zit aan een grens van 120 aanroepen per minuut per sleutel. Dat laatste merk je in normaal gebruik niet.
- Per account kun je tot vijf actieve sleutels en tien webhooks hebben. Genoeg voor een paar koppelingen naast elkaar, en het houdt het overzichtelijk.
- Een sleutel of een ondertekengeheim zie je alleen op het moment dat je hem aanmaakt. Kwijt is kwijt: dan maak je een nieuwe aan en vervang je de oude.
- Transcripten zitten achter een apart recht, want daar staat letterlijk in wat er gezegd is. De samenvatting volstaat voor bijna alles.
- De koppeling hoort bij een betaald abonnement en werkt niet tijdens de proefperiode.
- Bij Teams kan een beheerder sleutels en webhooks aanmaken voor de gesprekken van het hele team. Elk teamlid kan daarnaast een eigen sleutel maken voor de eigen gesprekken.
Wat er met de gegevens zelf gebeurt, verandert niet: de audio verwijderen we na het uitschrijven, uiterlijk binnen 24 uur, en je gesprekken en debriefs staan versleuteld opgeslagen in Duitsland. Stuur je de samenvattingen door naar je eigen systeem, dan gelden vanaf dat moment natuurlijk jouw eigen afspraken. Meer daarover staat op beveiliging en in de verwerkersovereenkomst.
Veelgestelde vragen over de Ajora API en webhooks
Kan ik Ajora aan mijn CRM koppelen zonder ontwikkelaar?
Ja, via Zapier of Make. Je maakt daar een koppeling die op een webhook wacht, plakt het adres dat je krijgt in Ajora onder Instellingen → Developer, en klikt aan in welk veld van je CRM de samenvatting moet landen. Daar komt geen code bij kijken.
Hoe weet mijn CRM bij welke klant het gesprek hoort?
Het telefoonnummer van de andere kant komt mee in het bericht. Vrijwel elk CRM kan daarop zoeken en het gesprek bij het juiste contact zetten.
Komt het letterlijke gesprek ook mee?
Nee. Een webhook stuurt de samenvatting, de actiepunten en de besluiten, nooit het transcript. Wil je het transcript, dan haal je het op via de API, met een sleutel die daar apart toestemming voor heeft.
Wat gebeurt er als mijn systeem even plat ligt?
Lukt de aflevering niet, dan proberen we het nog drie keer: na 5 seconden, na 30 seconden en na 2 minuten. Lukt het dan nog steeds niet, dan zetten we de webhook op Ongezond en sturen we er niets meer heen. Maak hem dan opnieuw aan en haal de gemiste gesprekken op via de API.
Wat als ik een samenvatting achteraf aanpas in Ajora?
Dan sturen we een tweede bericht, debrief.updated, met de bijgewerkte tekst. Je kunt de notitie in je eigen systeem dus mee laten veranderen.
Kost de API extra?
Nee, de koppeling zit bij een betaald abonnement inbegrepen. Tijdens de gratis proefperiode is hij nog niet beschikbaar. De prijzen staan op de homepage.
Ik wil vragen stellen aan AI over mijn gesprekken. Heb ik daar de API voor nodig?
Nee, dan is de MCP-koppeling makkelijker. Daarmee verbind je Ajora aan Claude of ChatGPT en stel je je vraag in gewone taal. Zie Ajora koppelen aan Claude en ChatGPT.
Bronnen
- Developer API: authenticatie, endpoints, webhooks en het nakijken van de handtekeningAjora Debrief-documentatie, geraadpleegd 20-09-2026
- Claude en ChatGPT verbinden met AjoraAjora Debrief-documentatie, geraadpleegd 20-09-2026