Skip to main content
CloudTalk heeft niet voor elk CRM een kant-en-klare connector. Hebt u uw eigen systeem gebouwd of gebruikt u een platform dat niet op onze lijst met native integraties staat, dan kunt u het alsnog met CloudTalk verbinden. In dit artikel leest u welke mogelijkheden worden ondersteund.
Gebruikersniveau: Admin

​
Voordat u begint

API-toegang is beschikbaar vanaf het Essential-plan en hoger. Waar u uw sleutels vindt en hoe u ze genereert, leest u in Toegang krijgen tot uw CloudTalk API-sleutels en deze genereren. Ziet u het tabblad API-sleutels niet in uw dashboard, dan zit uw account waarschijnlijk op een lager plan. Weet u het niet zeker, neem dan contact op met CloudTalk Support, dan zoeken wij het voor u uit.

​
Optie 1: Directe REST API-integratie (voor ontwikkelaars)

CloudTalk biedt een openbare REST API waarmee u programmatisch gegevens kunt lezen en schrijven, waaronder contacten, gesprekken en opnames.
  1. Genereer uw API-inloggegevens: ga naar Account > Instellingen > API-sleutels en klik op + API-sleutel toevoegen. Kopieer zowel de Access Key ID als de Access Key Secret.
  2. Stuur verzoeken naar de API op api.cloudtalk.io met Basic Authentication (uw Key ID als gebruikersnaam en uw Secret als wachtwoord). Let op: dit is een ander adres dan developers.cloudtalk.io (de documentatie) en dashboard.cloudtalk.io (het dashboard), dus zorg dat uw verzoeken naar api.cloudtalk.io gaan.
  3. Bekijk de beschikbare endpoints en requestformaten op developers.cloudtalk.io.
  4. Bouw in uw CRM de logica om deze endpoints aan te roepen bij de gebeurtenissen die voor u van belang zijn, bijvoorbeeld het aanmaken of bijwerken van een contact nadat een gesprek is beëindigd.
Tip: Test uw API-aanroepen in een tool als Postman voordat u ze in uw CRM inbouwt. Gebruik de optie Authorization > Basic Auth en plak uw Key ID en Secret. Houd de responsheaders voor de rate limit in de gaten en schroef uw verzoeken terug als u ze bereikt; de huidige limieten staan gedocumenteerd op developers.cloudtalk.io.

​
Optie 2: Realtime gebeurtenissen ontvangen met Webhooks (voor ontwikkelaars)

Webhooks sturen CloudTalk-gebeurtenissen op het moment dat ze plaatsvinden naar een HTTPS-endpoint dat van u is, zodat uw CRM synchroon blijft zonder de API te pollen. De gebeurtenissen hebben betrekking op gesprekken, contacten, gebruikers, berichten, Conversation Intelligence, VoiceAgents en Dialer. Elke gebeurtenis komt binnen als ondertekende JSON.
  1. Ga naar Account > Webhooks en klik op Endpoint toevoegen. Hiervoor hebt u een Admin-rol nodig.
  2. Voer uw HTTPS-URL in en kies de gewenste gebeurtenistypen. Laat de selectie leeg om alle gebeurtenissen te ontvangen, inclusief gebeurtenissen die later worden toegevoegd.
  3. Kopieer de signing secret van het endpoint en verifieer de handtekening bij elke levering.
  4. Klik op Send test event en controleer of uw endpoint antwoordt met een 2xx. Het resultaat ziet u in het afleverlogboek.
Mislukte leveringen worden automatisch opnieuw geprobeerd en u kunt ze tot 30 dagen lang vanaf dezelfde pagina opnieuw versturen of herstellen. Zie de ontwikkelaarsgids voor Webhooks voor payloads, handtekeningverificatie en best practices.

​
Optie 3: Gebeurtenissen naar uw CRM sturen met Workflow-automatisering

Wilt u dat CloudTalk automatisch gegevens naar uw CRM stuurt zodra er iets gebeurt (bijvoorbeeld wanneer een gesprek wordt beëindigd), dan kunt u een Workflow-automatisering instellen die een HTTP-verzoek naar een endpoint stuurt dat u zelf beheert.
  1. Stel in uw CRM, of op een server die u beheert, een endpoint in dat HTTP POST-verzoeken kan ontvangen.
  2. Ga in CloudTalk naar Account > Workflow automatiseringen en maak een automatisering die wordt getriggerd door de gewenste gebeurtenis en die een actie toevoegt die een HTTP-verzoek naar uw endpoint-URL stuurt. Zie de gids voor Workflow automatiseringen voor de instelling.
  3. CloudTalk stuurt de gebeurtenisgegevens naar uw endpoint zodra de trigger wordt geactiveerd.
  4. Verwerk de payload in uw CRM om records bij te werken, gesprekken te loggen of vervolgacties te starten.
Goed om te weten: HTTP-verzoeken vanuit Workflow-automatisering worden op best-effort-basis afgeleverd. Is uw endpoint tijdelijk onbereikbaar, dan kan een levering worden gemist en kunt u die niet zelf opnieuw laten versturen. Hebt u betrouwbare levering van gebeurtenissen nodig met nieuwe pogingen en opnieuw versturen, gebruik dan Webhooks (optie 2).

​
Optie 4: No-code-koppeling via Zapier of Make

Schrijft u liever geen code, dan kunnen Zapier en Make als brug tussen CloudTalk en uw CRM fungeren. Beide ondersteunen CloudTalk als trigger en als actiebron. Zapier: Volg de gids Zapier configureren om uw CloudTalk-account te koppelen en maak vervolgens een Zap die wordt getriggerd door een CloudTalk-gebeurtenis en die gegevens naar uw CRM stuurt, via een native CRM-actie of via een webhookstap. Make (voorheen Integromat): Voeg de CloudTalk-app toe in Make (zie de CloudTalk-documentatie van Make op apps.make.com/cloudtalk) en bouw vervolgens een scenario dat wordt getriggerd door een CloudTalk-gebeurtenis, zoals een nieuw gesprek, en dat de velden naar uw CRM mapt. De CloudTalk-app van Make bevat een algemene actie “Make an API Call”: is uw CRM geen native app in Make of hebt u een CloudTalk-bewerking nodig waarvoor geen aparte module bestaat, dan kunt u via die stap alsnog elk CloudTalk-endpoint bereiken. Beide tools ondersteunen aangepaste webhook-/HTTP-stappen, dus zelfs een CRM dat in geen van beide platforms een native app is, kan toch gegevens ontvangen.

​
Welke optie past bij mij?

Hulp nodig of hebt u een vraag? Neem gerust contact met ons op via ons Supportportaal — we staan voor u klaar.