Dit is een taak voor de beheerder. Deze schermen zijn alleen zichtbaar voor de eigenaar van het team.
Koppel je belsysteem zodat je telefoongesprekken automatisch in Converdo binnenkomen en gescoord worden. Ga in de instellingen naar CRM & Telefonie. Dat opent de pagina Connectors ("Koppel de systemen die call-data naar Converdo brengen voor scoring."). Drie koppelingen kun je nu gebruiken: GoHighLevel, Rinkel en Voys.
GoHighLevel
GoHighLevel pusht elke call naar Converdo, dat vervolgens de opname ophaalt en scoort. Je hebt twee dingen nodig:
- De webhook-URL. Kopieer op de kaart GoHighLevel de Webhook-URL en plak die in de webhook of automation in GHL. In de app: "Plak deze URL in de webhook/automation van het systeem. Houd 'm geheim: hij identificeert jouw workspace."
- Een Private Integration token. In de app staat: "Maak in GoHighLevel een Private Integration (Settings → Private Integrations) met deze scopes: View Conversations (conversations.readonly), View Conversation Messages (conversations/message.readonly), View Contacts (contacts.readonly). Plak de token hieronder (begint meestal met pit-). Wordt versleuteld opgeslagen (Vault); niet opnieuw getoond."
Rinkel
Rinkel pusht elke call naar Converdo, dat de opname via de Rinkel-API ophaalt en scoort. Je hebt het Rinkel Expert-abonnement nodig: webhooks en gespreksopnames zitten niet in de lagere pakketten.
Vul op de kaart Rinkel je API-key in: "Genereer een API-key in My Rinkel (de Rinkel-API is beta en beschikbaar op Professional en Expert; zo nodig aanvragen via rinkel.com/integrations). Converdo gebruikt de key uitsluitend om je gespreksopnames op te halen. Wordt versleuteld opgeslagen (Vault); niet opnieuw getoond." Klik daarna op Test verbinding; bij succes zie je "Verbinding geslaagd: de API-key werkt." Zie je een foutmelding, controleer dan of je de sleutel volledig hebt gekopieerd, zonder spaties ervoor of erachter.
Doorloop daarna de vier stappen zoals ze op de kaart staan:
- "Genereer in Rinkel onder Integraties → API een API-key en plak die hieronder. Converdo test de verbinding direct bij het opslaan."
- "Registreer onder Integraties → Webhooks de webhook-URL hierboven, met content-type application/json. Gebruik de Test-knop van Rinkel en klik Save."
- "Zet daarbij alle vier de call-events aan. Converdo verwerkt ze alle vier: Inkomende oproep en Uitgaande oproep (richting en telefoonnummer), Start oproep (koppelt de medewerker) en Einde oproep (start de verwerking en het ophalen van de opname). Overige events, zoals call insights, kunnen uit; Converdo negeert ze."
- "Zet gespreksopname aan voor de nummers die je wilt scoren: zonder opname valt er niets op te halen. Webhooks en opnames vereisen het Rinkel Expert-abonnement."
Controleren of het werkt
Voer een testgesprek en hang op. Binnen enkele minuten hoort het gesprek in je Gesprekken-overzicht te staan. Op de connectorkaart zie je bovendien wanneer het laatste gesprek is binnengekomen; dat is de snelste manier om te controleren of de koppeling nog leeft. Blijft het uit, kijk dan bij Als het niet werkt (Rinkel) hieronder.
De sleutel vervangen of de token roteren
Op de Rinkel-kaart staan twee knoppen met een verschillend doel:
- Vervangen zet een nieuwe API-sleutel, bijvoorbeeld nadat je die in Rinkel opnieuw hebt gegenereerd. De webhook-URL blijft gelijk.
- Roteer token maakt een nieuwe webhook-URL aan. Doe dit als je vermoedt dat de oude URL bij iemand terecht is gekomen die hem niet hoort te hebben. Vergeet niet de nieuwe URL daarna in Rinkel te registreren, anders komen er geen gesprekken meer binnen.
Als het niet werkt (Rinkel)
Er komen geen gesprekken binnen. Controleer in Rinkel of de webhook nog geregistreerd staat en of de vier gebeurtenissen aanstaan. Test de webhook opnieuw vanuit Rinkel.
Gesprekken komen binnen, maar zonder opname. Dan staat de gespreksopname in Rinkel niet aan voor dat nummer, of de API-sleutel is niet meer geldig. Controleer de sleutel met de testknop in Converdo.
Gesprekken komen binnen bij de verkeerde medewerker of bij niemand. Converdo koppelt op telefoonnummer. Controleer bij Instellingen → Medewerkers of het nummer van die medewerker klopt en volledig is ingevuld.
GoHighLevel en Rinkel delen dezelfde webhook-token. Roteer je de token, dan stoppen beide URL's met werken tot je de nieuwe URL op beide plekken opnieuw plakt.
Voys
Voys stuurt elk gesprek via een webhook naar Converdo, dat de opname daarna via de Voys-API ophaalt en scoort. De koppeling heeft twee kanten: instellingen in het Voys-portaal (die kan Converdo niet zien of controleren) en twee waarden die je overtypt naar de Voys-kaart op de Connectors-pagina.
Eerst: in het Voys-portaal
Vijf instellingen, in deze volgorde. Converdo kan niet detecteren of ze goed staan; slaat er één over, dan komen er stil geen gesprekken of geen audio binnen. De Voys-kaart toont dezelfde punten als checklist, met de valkuilen erbij — houd die ernaast.
- Maak een API-token aan onder Persoonlijke instellingen → Gebruikertokens, met een account dat beheerder is én opnamerechten heeft. Dit is de stap die het vaakst misgaat: een token van een gewone gebruiker lijkt te werken — gesprekken komen binnen, de koppeling meldt zich actief — maar levert géén opnames, en de fout die Voys dan geeft is niet te onderscheiden van "de opname is nog niet klaar". Controleer de rechten dus vóór je verdergaat.
- Zet gespreksopname globaal aan.
- Geef het belplan een opname-stap, ingesteld op "start bij opnemen".
- Zet uitgaande opname aan, per VoIP-account. Deze staat standaard uit en niets meldt dat.
- Stel de webhook in onder Integratie → Gespreksnotificaties, met de webhook-URL die boven op de Voys-kaart staat. Let op de naam: dit is de grátis module Gespreksnotificaties. Het betaalde product dat "Webhooks" heet is iets anders (een belplan-stap) en werkt hier niet.
Dan: twee waarden overtypen naar de kaart
- Client-UUID, uit Persoonlijke instellingen → Gebruikertokens. Dit is geen wachtwoord — hij identificeert alleen welke Voys-omgeving bij dit account hoort.
- Numeriek client-ID, uit de adresbalk van het Voys-portaal:
/client/<nummer>/…, meestal zes cijfers. Dit is niet je KVK-nummer en niet het client-UUID hierboven. Converdo gebruikt het om de lijst met VoIP-accounts op te halen.
De volgorde op de kaart is niet vrij: het API-token maakt de koppeling aan, dus het client-UUID kan pas daarna worden opgeslagen. Vul je het UUID eerst in, dan vraagt de kaart je eerst het token op te slaan.
Testen en medewerkers koppelen
Klik op de kaart op Verbinding testen. Die vertelt of het token en de omgeving kloppen en of er VoIP-accounts gevonden zijn; een rechtenprobleem of een verkeerd client-ID krijgt daar zijn eigen melding.
Kies daarna per medewerker het toestelnummer bij Instellingen → Medewerkers. Neem het nummer van het VoIP-account over (meestal de 2xx-reeks: de toestellen), niet het gebruikersnummer (meestal 6xx). Kies je het verkeerde nummer, dan komt er geen foutmelding — gesprekken worden dan stil aan de verkeerde of aan geen enkele medewerker gekoppeld.
Wat je daarna mag verwachten
Een gesprek verschijnt pas na afloop in je Gesprekken-overzicht, niet al tijdens het bellen: Voys meldt het gesprek zodra het is afgerond, waarna Converdo de opname ophaalt en scoort.
Als het niet werkt (Voys)
- Gesprekken komen binnen, maar zonder opname. Vrijwel altijd de rechten van de tokenhouder (stap 1) of een van de opname-instellingen uit stap 2-4. Maak zo nodig een nieuw token aan onder een beheerder met opnamerechten en vervang het op de kaart.
- Er komt niets binnen. Controleer de webhook onder Integratie → Gespreksnotificaties, inclusief het laatste deel van de URL — dat is jouw persoonlijke token en per klant verschillend.
- Het client-UUID wordt niet geaccepteerd. Het moet de volledige UUID zijn (vier streepjes), zonder spaties ervoor of erachter.
- De medewerkerlijst uit Voys blijft leeg. Controleer het numerieke client-ID op de kaart; voor de opnames zelf is dat ID niet nodig.
Routering naar een afdeling (optioneel)
Onder Standaard-afdeling stel je een vangnet in: "calls van deze connector waarvan de medewerker geen afdeling oplevert, landen in deze afdeling. Leeg gelaten gaan ze naar triage."
Na het koppelen
Zodra een gesprek binnenkomt, haalt Converdo de opname op, transcribeert en scoort het. Zorg dat elke medewerker als teamlid met een functie-rol aan het team hangt: zonder die koppeling blijft een call op Wacht op toewijzing staan (het scherm Aandacht nodig). Zie Hoe Converdo je gesprekken scoort.