Wat zijn Gespreksnotificaties?
Met de module Gespreksnotificaties verstuur je automatisch gespreksdata naar een URL van je keuze. Deze notificaties worden verstuurd voor alle gesprekken binnen jouw portal.
Wanneer je deze gespreksnotificaties koppelt aan je CRM-software, zie je wie er heeft gebeld, wanneer dat was en hoe lang het gesprek duurde.
De notificaties worden getriggerd bij inkomende, interne en uitgaande gesprekken. Je kunt gespreksnotificaties ook gebruiken voor andere doeleinden, zoals het meten van gesprekstatistieken.
- Wat zijn Gespreksnotificaties?
- Instellingen Gespreksnotificaties
- De gespreksnotificatie triggers
- Volgorde van notificaties
- Gespreksnotificaties instellen
- Voorbeeldintegraties
- Veelgestelde vragen
- Gerelateerde pagina's
Instellingen Gespreksnotificaties
- Beschrijving: Geef deze notificatie een naam die je in één oogopslag herkent. Alleen jouw team ziet deze naam, nooit de beller.
- Pakket: Kies waar deze notificatie naartoe gaat: kies Aangepast om het zelf in te stellen, of Robin om de notificatie direct naar de Robin integratie te sturen.
- Web hook URL: Plak hier de volledige webhook URL, inclusief https://, waar je deze notificaties naartoe wilt sturen.

- Intelligence samenvatting events versturen: Vink je dit aan, dan worden gesprekssamenvattingen meegestuurd met de notificaties. Let op: Intelligence moet wel ingeschakeld zijn.
- Intelligence transcriptie events versturen: Vink je dit aan, dan worden gesprekstranscripties meegestuurd met de notificaties. Let op: Intelligence moet wel ingeschakeld zijn.
De gespreksnotificatie triggers
Tijdens een gesprek wordt informatie naar de opgegeven URL gestuurd op zes verschillende momenten voor inkomende, interne en uitgaande gesprekken: Created, Ringing, Answered, Warm transfer, Cold transfer en Hang-up. De notificaties worden verstuurd als een POST-verzoek met de data in een JSON-document. Hieronder lees je precies welke informatie wordt verstuurd.
Created
Een created event wordt getriggerd wanneer een inkomend gesprek start.
- call_id: Een unieke string om het gesprek te identificeren.
- timestamp: De datum en tijd waarop de webhook wordt gegenereerd, in ISO 8601-formaat.
- status: De status van het gesprek. Voor dit notificatietype is dit
created. - version: Een versie-attribuut dat in de toekomst kan worden gebruikt om te migreren naar een andere versie van de webhooks. Op dit moment is dit altijd
v2. - direction: Of een gesprek inkomend (
inbound) of uitgaand (outbound) is. Het created event wordt alleen verstuurd voor inkomende gesprekken. - caller: Informatie over de beller.
- number: Het telefoonnummer dat de beller gebruikt.
- name: De naam van de beller.
- account_number: Het interne nummer van het VoIP-account (waar beschikbaar, bij inkomende gesprekken is dit bijna altijd
null). - user_numbers: De interne nummers van de gebruikers die bereikbaar zijn (waar beschikbaar, kan een lege array zijn).
- user_emails: De e-mailadressen van de gebruikers.
- destination: Informatie over waar het gesprek naartoe gaat.
- number: Het telefoonnummer dat de beller heeft gebeld.
Ringing
Een ringing notificatie wordt verstuurd wanneer toestellen beginnen te rinkelen door een inkomend gesprek.
Het kan zijn dat er meerdere ringing notificaties achter elkaar worden verstuurd naarmate nieuwe toestellen beginnen te rinkelen.
- call_id: Een unieke string om het gesprek te identificeren.
- timestamp: De datum en tijd waarop de webhook wordt gegenereerd, in ISO 8601-formaat.
- status: De status van het gesprek. Voor dit notificatietype is dit
ringing. - version: Een versie-attribuut dat in de toekomst kan worden gebruikt om te migreren naar een andere versie van de webhooks. Op dit moment is dit altijd
v2. - direction: Of een gesprek inkomend (
inbound) of uitgaand (outbound) is. Gesprekken tussen collega's worden gemarkeerd alsoutbound. - caller: Informatie over de beller.
- number: Het telefoonnummer dat de beller gebruikt.
- name: De naam van de beller.
- account_number: Het interne nummer van het VoIP-account (waar beschikbaar, bij inkomende gesprekken is dit bijna altijd
null). - user_numbers: De interne nummers van de gebruikers die bereikbaar zijn (waar beschikbaar, kan een lege array zijn).
- user_emails: De e-mailadressen van de gebruikers.
- destination: Informatie over waar het gesprek naartoe gaat.
- number: Het telefoonnummer dat de beller heeft gebeld.
- targets: De toestellen die rinkelen voor dit gesprek. Toestellen die niet bereikbaar zijn worden niet getoond.
- number: Het nummer dat wordt gebeld. Dit is meestal hetzelfde als destination.number, maar kan veranderen als het gesprek wordt doorgeschakeld.
- name: De naam van degene die wordt gebeld. Bij inkomende gesprekken is dit bijna altijd
null. - account_number: De interne nummers van de gebruikers die hun VoIP-account bereikbaar hebben ingesteld (waar beschikbaar, kan een lege array zijn).
- user_numbers: De interne nummers van de gebruikers die bereikbaar zijn (waar beschikbaar, kan een lege array zijn).
- user_emails: De e-mailadressen van de gebruikers.
Opgenomen (in-progress)
Als een gesprek wordt opgenomen, krijg je een in-progress notificatie.
target die opneemt is niet altijd een van de toestellen die aanvankelijk overging. Door call pickup kan het gesprek op een ander toestel worden opgenomen.- call_id: Een unieke string om het gesprek te identificeren.
- timestamp: De datum en tijd waarop de webhook wordt aangemaakt, in ISO 8601 formaat.
- status: De status van het gesprek. Voor dit notificatietype is dat
in-progress. - version: Een versie-attribuut dat in de toekomst gebruikt kan worden om naar een andere versie van de webhooks te migreren. Op dit moment is dat altijd
v2. - direction: Of een gesprek inkomend (
inbound) of uitgaand (outbound) is. Gesprekken tussen collega's zijn gemarkeerd alsoutbound. - caller: Informatie over de beller.
- number: Het telefoonnummer dat de beller gebruikt.
- name: De naam van de beller.
- account_number: Het interne nummer van het VoIP-account (waar beschikbaar, bij inkomende gesprekken is dit vrijwel altijd
null). - user_numbers: De interne nummers van de gebruikers die bereikbaar zijn (waar beschikbaar, kan een lege array zijn).
- user_emails: De e-mailadressen van de gebruikers.
- destination: Informatie over waar het gesprek naartoe gaat.
- number: Het telefoonnummer dat de beller heeft gebeld.
- targets: De telefoons die overgaan voor dit gesprek. Telefoons die onbereikbaar zijn worden niet getoond.
- number: Het nummer dat wordt gebeld. Dit is meestal hetzelfde als destination.number, maar kan veranderen als het gesprek wordt doorgeschakeld.
- name: De naam van de persoon die gebeld wordt. Bij inkomende gesprekken is dit vrijwel altijd
null. - account_number: De interne nummers van de gebruikers die hun VoIP-account bereikbaar hebben ingesteld (waar beschikbaar, kan een lege array zijn).
- user_numbers: De interne nummers van de gebruikers die bereikbaar zijn (waar beschikbaar, kan een lege array zijn).
- user_emails: De e-mailadressen van de gebruikers.
Warm transfer
Een warm-transfer notificatie krijg je als een gesprek 'warm' wordt doorverbonden. Bij een warm transfer belt de doorverbinder eerst de nieuwe deelnemer, die neemt op, spreekt met de doorverbinder, en dan wordt het gesprek doorverbonden.
Het gesprek van de doorverbinder naar de derde partij genereert ook ringing en in-progress notificaties met een eigen call_id. Tijdens een transfer worden deze twee gesprekken eigenlijk samengevoegd tot één gesprek. De call_id van één van de twee gesprekken wordt dan gebruikt voor het gesprek na de transfer. De andere call_id wordt opgenomen in de transfer als de merged_id en daarna niet meer gebruikt.
- call_id: Een unieke string om het gesprek te identificeren, overgenomen van een van de eerdere gesprekken.
- merged_id: De call_id van het andere eerdere gesprek, die niet meer wordt gebruikt.
- timestamp: De datum en tijd waarop de webhook wordt aangemaakt, in ISO 8601 formaat.
- status: De status van het gesprek. Voor dit notificatietype is dat
warm-transfer. - version: Een versie-attribuut dat in de toekomst gebruikt kan worden om naar een andere versie van de webhooks te migreren. Op dit moment is dat altijd
v2. - direction: Of een gesprek inkomend (
inbound) of uitgaand (outbound) is. Gesprekken tussen collega's zijn gemarkeerd alsoutbound. - caller: Informatie over de beller.
- number: Het telefoonnummer dat de beller gebruikt.
- name: De naam van de beller.
- account_number: Het interne nummer van het VoIP-account (waar beschikbaar, bij inkomende gesprekken is dit vrijwel altijd
null). - user_numbers: De interne nummers van de gebruikers die bereikbaar zijn (waar beschikbaar, kan een lege array zijn).
- user_emails: De e-mailadressen van de gebruikers.
- destination: Informatie over waar het gesprek naartoe gaat.
- number: Het telefoonnummer dat de beller heeft gebeld.
- targets: De telefoons die overgaan voor dit gesprek. Telefoons die onbereikbaar zijn worden niet getoond.
- number: Het nummer dat wordt gebeld. Dit is meestal hetzelfde als destination.number, maar kan veranderen als het gesprek wordt doorgeschakeld.
- name: De naam van de persoon die gebeld wordt. Bij inkomende gesprekken is dit vrijwel altijd
null. - account_number: De interne nummers van de gebruikers die hun VoIP-account bereikbaar hebben ingesteld (waar beschikbaar, kan een lege array zijn).
- user_numbers: De interne nummers van de gebruikers die bereikbaar zijn (waar beschikbaar, kan een lege array zijn).
- user_emails: De e-mailadressen van de gebruikers.
- redirector: Informatie over de deelnemer die de transfer heeft uitgevoerd.
- number: Het telefoonnummer dat de doorverbinder gebruikt.
- name: De naam van de doorverbinder.
- account_number: Het interne nummer van het VoIP-account (waar beschikbaar, bij inkomende gesprekken is dit vrijwel altijd
null). - user_numbers: De interne nummers van de gebruikers die bereikbaar zijn (waar beschikbaar, kan een lege array zijn).
- user_emails: De e-mailadressen van de gebruikers.
Cold transfer
Een cold-transfer notificatie wordt verstuurd wanneer een gesprek via een cold transfer wordt doorverbonden. Bij een cold transfer belt de doorverbinder naar de nieuwe deelnemer, maar verbindt het gesprek door zonder te wachten tot er wordt opgenomen.
Er zijn twee belangrijke verschillen tussen een cold-transfer en een warm-transfer:
- Bij een warm transfer is er altijd één gebelde partij, terwijl er bij een cold transfer meerdere kunnen zijn (bijvoorbeeld als het gesprek wordt doorverbonden naar een Belgroep).
- Bij een warm transfer worden eerst
ringingenin-progressnotificaties gegenereerd. Bij een cold transfer wordt alleen eenringingnotificatie verstuurd, en volgt eenin-progressnotificatie pas als de derde partij het gesprek opneemt.
Het gesprek van de doorverbinder naar de derde partij genereert ook een ringing notificatie met een eigen call_id. Tijdens een transfer worden deze twee gesprekken feitelijk samengevoegd tot één gesprek. Het call_id van één van de twee gesprekken wordt dan gebruikt voor het gesprek na de transfer. Het andere call_id wordt in de transfer opgenomen als merged_id en daarna niet meer gebruikt.
- call_id: Een unieke string om het gesprek te identificeren, overgenomen van een van de vorige gesprekken.
- merged_id: Het call_id van het andere vorige gesprek, dat niet meer wordt gebruikt.
- timestamp: De datum en tijd waarop de webhook wordt gegenereerd, in ISO 8601 formaat.
- status: De status van het gesprek. Voor dit notificatietype is dit
cold-transfer. - version: Een versie-attribuut dat in de toekomst gebruikt kan worden om te migreren naar een andere versie van de webhooks. Momenteel is dit altijd
v2. - direction: Of een gesprek inkomend (
inbound) of uitgaand (outbound) is. Gesprekken tussen collega's worden gemarkeerd alsoutbound. - caller: Informatie over de beller.
- number: Het telefoonnummer dat de beller gebruikt.
- name: De naam van de beller.
- account_number: Het interne nummer van het VoIP-account (waar beschikbaar, bij inkomende gesprekken is dit bijna altijd
null). - user_numbers: De interne nummers van de gebruikers die bereikbaar zijn (waar beschikbaar, kan een lege array zijn).
- user_emails: De e-mailadressen van de gebruikers.
- destination: Informatie over waar het gesprek naartoe gaat.
- number: Het telefoonnummer dat de beller heeft gebeld.
- targets: De telefoons die overgaan voor dit gesprek. Telefoons die onbereikbaar zijn worden niet getoond.
- number: Het nummer dat wordt gebeld. Dit is meestal hetzelfde als destination.number, maar kan veranderen als het gesprek wordt doorgeschakeld.
- name: De naam van degene die wordt gebeld. Bij inkomende gesprekken is dit bijna altijd
null. - account_number: De interne nummers van de gebruikers die hun VoIP-account bereikbaar hebben ingesteld (waar beschikbaar, kan een lege array zijn).
- user_numbers: De interne nummers van de gebruikers die bereikbaar zijn (waar beschikbaar, kan een lege array zijn).
- user_emails: De e-mailadressen van de gebruikers.
- redirector: Informatie over de deelnemer die de transfer heeft uitgevoerd.
- number: Het telefoonnummer dat de doorverbinder gebruikt.
- name: De naam van de doorverbinder.
- account_number: Het interne nummer van het VoIP-account (waar beschikbaar, bij inkomende gesprekken is dit bijna altijd
null). - user_numbers: De interne nummers van de gebruikers die bereikbaar zijn (waar beschikbaar, kan een lege array zijn).
- user_emails: De e-mailadressen van de gebruikers.
Ophangen (ended)
Een ended notificatie wordt verstuurd wanneer een gesprek eindigt. Er zijn verschillende redenen waarom een gesprek kan eindigen.
Een ended notificatie kan worden verstuurd na een in-progress notificatie als het gesprek door een van de deelnemers werd opgehangen, na een ringing notificatie als niemand opnam, of als enige notificatie als er geen toestellen bereikbaar waren.
- call_id: Een unieke string om het gesprek te identificeren.
- timestamp: De datum en tijd waarop de webhook wordt gegenereerd, in ISO 8601 formaat.
- status: De status van het gesprek. Voor dit notificatietype is dit
ended. - reason: De reden waarom het gesprek eindigde. De reden kan een van de volgende waarden zijn:
- completed: Het gesprek is succesvol afgerond.
- busy: Het gesprek werd afgewezen, de gebelde was in gesprek.
- no-answer: Niemand heeft het gesprek beantwoord om verschillende redenen.
- failed: Er is een fout opgetreden waardoor het gesprek niet tot stand kon komen.
- cancelled: De beller hing op voordat iemand kon opnemen.
- abandon: De beller hing op terwijl hij in de wachtrij stond.
- version: Een versie-attribuut dat in de toekomst gebruikt kan worden om te migreren naar een andere versie van de webhooks. Momenteel is dit altijd
v2. - direction: Of een gesprek inkomend (
inbound) of uitgaand (outbound) is. Gesprekken tussen collega's worden gemarkeerd alsoutbound. - caller: Informatie over de beller.
- number: Het telefoonnummer dat de beller gebruikt.
- name: De naam van de beller.
- account_number: Het interne nummer van het VoIP-account (waar beschikbaar, bij inkomende gesprekken is dit bijna altijd
null). - user_numbers: De interne nummers van de gebruikers die bereikbaar zijn (waar beschikbaar, kan een lege array zijn).
- user_emails: De e-mailadressen van de gebruikers.
- destination: Informatie over waar het gesprek naartoe gaat.
- number: Het telefoonnummer dat de beller heeft gebeld.
Transcriptie aangemaakt
Er wordt een call_transcription notificatie verstuurd zodra de transcriptie klaar is.
Als Voys Intelligence actief is, volgt dit event direct na de ended notificatie. Gebruik je ook gesprekssamenvattingen? Dan volgt het summary event snel daarna.
{
"call_id": "ua0-grq-prd-1780997460.58680",
"call_transcription": "Speaker 1: Hi how are you.\nSpeaker 2: Hey great that you called.",
}Samenvatting aangemaakt
Er wordt een summary notificatie verstuurd zodra de gespreksamenvatting klaar is.
Als Voys Intelligence actief is, is dit het laatste event voor dit specifieke gesprek.
{
"call_id": "ua0-grq-prd-1780997460.58680",
"summary": "This was a great call."
}Gespreksopname aangemaakt
Er wordt een call recording created event verstuurd zodra een opname van een gesprek beschikbaar is.
Het event ziet er zo uit:
{
"call_id": "ua0-grq-prd-1741083170.160935",
"recording_url": "https://api.voys.nl/api/v2/clients/9f515223-c139-4704-a031-57342c8809a4/callrecordings/ua0-grq-prd-1741083170.160935/audio"
}Je kunt recording_url direct gebruiken om de opname op te halen met je API-sleutel. Je hoeft de URL niet zelf samen te stellen of je client-ID op te zoeken.
Volgorde van notificaties
Per gesprek worden er meerdere notificaties verstuurd. Welke dat zijn hangt af van hoe het gesprek verloopt. Hieronder zie je de volgorde van notificaties voor de meest voorkomende soorten gesprekken.
Eenvoudig gesprek
Een geslaagd gesprek met twee deelnemers:
- ringing - A belt B
- in-progress - A belt B
- ended - A belt B (reden:
completed)
Eenvoudig gesprek met Voys Intelligence actief
Een geslaagd gesprek met twee deelnemers:
- ringing - A belt B
- in-progress - A belt B
- ended - A belt B (reden:
completed) - call_transcription - transcriptie van het gesprek is klaar
- summary - samenvatting van het gesprek is klaar
Niet opgenomen
De telefoon van de gebelde persoon gaat over, maar wordt niet opgenomen.
- ringing - A belt B
- ended - A belt B (reden:
busyofno-answer, afhankelijk van het toestel)
Gebelde persoon niet bereikbaar
De gebelde persoon is niet bereikbaar (bijvoorbeeld als de telefoon op Niet storen staat), dus de telefoon gaat niet over en het gesprek wordt niet opgenomen.
- ended - A belt B (reden:
busy)
Attended Transfer
Bij een attended transfer (warme transfer) belt A eerst met B, waarna een van de deelnemers het gesprek doorverbindt naar C. De deelnemer belt eerst met C, en na een gesprekje wordt het gesprek doorverbonden. Alleen deelnemers A en C blijven in het gesprek.
- ringing - A belt B
- in-progress - A belt B
- ringing - B belt C
- in-progress - B belt C
- warm-transfer - B verbindt A en C door
- ended - A en C hangen op (reden:
completed) - call_transcription - transcriptie van het gesprek is klaar (één per gespreksdeel, indien actief)
- summary - samenvatting van het gesprek is klaar (één per gespreksdeel, indien actief)
Blind transfer
Bij een blind transfer (koude transfer) belt A eerst met B, waarna een van de deelnemers het gesprek doorverbindt naar C zonder te wachten of C beschikbaar is.
- ringing - A belt B
- in-progress - A belt B
- ringing - B belt C
- cold-transfer - B verbindt A en C
- in-progress - A belt C
- ended - A belt C niet meer (reden:
completed) - call_transcription - transcriptie van het gesprek is klaar
- summary - samenvatting van het gesprek is klaar
Semi-attended transfer
Bij een semi-attended transfer (lauwe transfer) belt A eerst B, waarna een van de deelnemers het gesprek doorzet naar C. Die deelnemer probeert C eerst te bereiken, maar zet het gesprek door voordat C opneemt.
- ringing - A belt B
- in-progress - A belt B
- ringing - B belt C
- cold-transfer - B verbindt A en C
- in-progress - A belt C
- ended - A belt C niet meer (reden:
completed) - call_transcription - transcriptie van het gesprek is klaar
- summary - samenvatting van het gesprek is klaar
Call Pickup
Staan twee toestellen in dezelfde PickupGroup? Dan kun je vanaf het ene toestel een gesprek voor het andere toestel overnemen.
- ringing - A belt B
- in-progress - A belt C
- ended - A belt C niet meer (reden:
completed) - call_transcription - transcriptie van het gesprek is klaar
- summary - samenvatting van het gesprek is klaar
Doorschakelen
Wanneer een gebruiker zijn toestel zo instelt dat inkomende gesprekken automatisch doorgeschakeld worden naar een ander nummer.
- ringing - A belt B
- ringing - A belt B & C
- in-progress of ended, afhankelijk van of iemand opneemt.
- call_transcription - transcriptie van het gesprek is klaar
- summary - samenvatting van het gesprek is klaar
Gespreksnotificaties instellen
- Ga naar Gespreksnotificaties.
- Klik op Toevoegen.
- Vul in het veld Beschrijving in waar deze notificatie voor dient.
- Kies 'Aangepast' bij Pakket, tenzij je liever een standaardoptie gebruikt.
- Vul de Web hook URL in waar de gespreksnotificaties naartoe gestuurd moeten worden.
- Vul het API-token in als je gekozen service dit aanbiedt.
- Klik op Opslaan.
Voorbeeldintegraties
Hieronder vind je wat voorbeelden van integraties in combinatie met Zapier:
- Stuur een bericht naar Slack bij een gemiste oproep.
- Verstuur een e-mail bij een gemiste oproep.
- Robin-integratie.
Microsoft Power Automate (voorheen Microsoft Flow)- Zapier-integratie
En een voorbeeld met N8N en onze gesprektranscriptie-API
Veelgestelde vragen
Webhooks worden afgevuurd op een specifiek moment in je belplan en werken alleen bij inkomende oproepen. Je kunt per webhook een aparte URL instellen. Een webhook wordt op één moment in de tijd aangeroepen.
Gespreksnotificaties werken bij zowel inkomende als uitgaande oproepen. Meer details vind je hier:
Bij gespreksnotificaties kun je de URL op zes verschillende momenten in de levenscyclus van een gesprek aanroepen.
Inkomende, uitgaande en interne gesprekken.
Er wordt een formulier in JSON-formaat naar jouw URL gestuurd.
- Voor webhooks gebruik je een GET request.
- Voor gespreksnotificaties gebruik je een POST request.
Eerste check: staat Voys Intelligence aan? De opties voor gespreksnotificaties zijn namelijk ook instelbaar wanneer Intelligence uitstaat. Je setup ziet er dan prima uit, maar er wordt niks verstuurd. Geen samenvattingen, geen transcripties, zelfs geen lege notificatie. Zet Voys Intelligence aan en je webhook ontvangt ze wel.