Koppel Rinkel aan je CRM, helpdesk, Slack of een eigen tool. Met de Rinkel API en webhooks krijg je gespreksdata daar waar je 'm nodig hebt – en automatiseer je een hoop handwerk.
Goed om te weten ❗
API en webhooks zijn beschikbaar voor Professional- en Expert-abonnementen. Het is technisch werk: een developer of IT'er heeft het zo voor elkaar, zelf uitvogelen kan ook maar kost wat tijd.
Alle technische documentatie staat op developers.rinkel.com (Engels).
Inspiratie nodig? Bekijk de integratiepagina voor concrete voorbeelden.
Wat is een API key en waarvoor heb je 'm nodig?
Een API key is een unieke code – vergelijkbaar met een wachtwoord – waarmee jouw systeem toegang krijgt tot de data van je Rinkel-account. Geen key, geen toegang.
Je maakt een API key aan in MyRinkel (hier).
Let op ❗
Behandel je API key als een wachtwoord. Deel 'm niet publiek en zet 'm niet in code die je naar een openbare repo pusht.
Beginnen met de Rinkel API
De API werkt op basis van REST en je vindt alle endpoints, parameters en voorbeelden op developers.rinkel.com.
Werken met webhooks
Een webhook stuurt automatisch een bericht naar jouw systeem zodra er iets gebeurt in Rinkel. Denk aan: nieuwe inkomende oproep? Open een ticket. Gesprek afgelopen? Werk de klantkaart bij in je CRM.
Webhook instellen
Ga naar deze pagina in MyRinkel.
Kies de webhook die je wilt instellen en vul de URL van je endpoint in (moet POST-verzoeken kunnen ontvangen).
Welke events kun je gebruiken?
Inkomende oproep – er komt een gesprek binnen (nog niet beantwoord). Stuurt id, datetime, to en from.
Uitgaande oproep – je belt naar buiten (nog niet beantwoord). Zelfde velden als hierboven.
Begin van een oproep – gesprek is beantwoord. Stuurt id, datetime, answeredBy en eventuele keuzemenu-keuze.
Einde van een oproep – gesprek is afgelopen. Stuurt id, datetime en cause (zes mogelijke redenen: onbeantwoord, beantwoord, geblokkeerd, voicemail, callcenter, buiten bedrijfstijden).
Heb je AI Insights? Dan kun je ook het Call insights-event gebruiken om samenvatting, sentiment en onderwerpen naar je eigen systeem te sturen. Koppel het aan een gesprek via dezelfde call id.
Exacte payloadvelden vind je op developers.rinkel.com.
Beveiliging
Alle webhook-verkeer gaat via HTTPS en de payload is JSON. Accepteer aan jouw kant alleen verzoeken van het Rinkel-domein.
Werkt je webhook niet?
Loop deze checks even af:
Klopt je endpoint-URL en is 'ie bereikbaar via het internet?
Accepteert je endpoint POST-verzoeken?
Stuurt je applicatie een 200 OK terug bij ontvangst?
Sta je verzoeken van het Rinkel-domein toe?
Loopt het nog steeds vast? Stuur de foutmelding naar [email protected] – we helpen je graag verder.
Veelgestelde vragen
Op welke abonnementen kan ik de API en webhooks gebruiken?
Professional en Expert.
Kan ik AI Insights doorzetten naar mijn CRM?
Ja, via het Call insights webhook-event. Koppel het aan andere webhook-events met dezelfde call id als je ook telefoonnummers nodig hebt.
Ik wil de naam van een beller live in mijn CRM zien tijdens een inkomende oproep – kan dat?
Ja. Gebruik de Inkomende oproep-webhook om de gegevens meteen na binnenkomst naar je CRM te sturen.
Werkt Rinkel met Zapier, Make of Integrately?
De directe Zapier-integratie is gestopt. Via webhooks koppel je Rinkel zelf aan elk platform dat webhooks ontvangt – Zapier, Make en Integrately werken daar prima mee.