Met de Call Match API koppel je gesprekken aan je eigen systemen. Je systeem stuurt een ondertekend verzoek met het telefoonnummer van een beller. Call tracking koppelt dat verzoek dan aan het juiste gesprek. In het logboek zie je welke verzoeken binnenkwamen en welke koppelingen zijn vastgelegd.
Let op: je hebt beheerdersrechten nodig in de Qooqie call tracking applicatie. Het bouwen van de koppeling is werk voor een developer.
Geheime sleutel aanmaken
Elk verzoek onderteken je met een geheime sleutel. Die maak je zo aan:
- Ga binnen de Qooqie call tracking applicatie naar Integraties > Call Match API.
- Klik op ‘Geheime sleutel aanmaken’.
- Kopieer de sleutel met ‘Kopiëren’ en bewaar hem veilig in het systeem dat de API aanroept.

Daarna zie je alleen nog een kort kenmerk van de sleutel. Wil je de sleutel opnieuw zien? Klik dan op ‘Sleutel tonen’. Met ‘Verbergen’ verberg je hem weer.
De sleutel geeft toegang tot de gegevens van je organisatie. Deel hem alleen met het systeem dat de API aanroept. Tonen en vernieuwen van de sleutel worden vastgelegd.
Nieuwe sleutel maken
Is de sleutel uitgelekt, of wil je hem vervangen? Klik dan op ‘Nieuwe sleutel maken’ en bevestig. De huidige sleutel werkt dan direct niet meer. Verzoeken met de oude sleutel worden geweigerd totdat je systeem de nieuwe sleutel gebruikt.
Zo stuur je een verzoek
Onder ‘Zo gebruik je de API’ staan de stappen en het adres van jouw omgeving:
- Stuur een POST-verzoek met JSON naar het adres dat op de pagina staat.
- Zet de header x-hook-signature op de hex HMAC-SHA256 van exact de verzonden JSON, met de geheime sleutel.
- Neem minimaal phoneNumber op. Aanvullende velden worden gebruikt voor het koppelen en verschijnen in het logboek.
Op de pagina staat ook voorbeeldcode, met het juiste adres ingevuld. Die kopieer je met de knop ‘Kopiëren’.
Klopt de ondertekening niet? Dan wordt het verzoek geweigerd. Call tracking zoekt het gesprek van dat telefoonnummer in de afgelopen 90 dagen.
Logboek bekijken
Onder ‘Call Match API-logboek’ zie je de ontvangen verzoeken:
- Zoek met ‘Zoeken in logboek’ op aanvraag-ID, gesprek-ID of tijdstip.
- Filter bij ‘Gesprekskoppeling’ op ‘Alle aanvragen’, ‘Met gesprekskoppeling’ of ‘Zonder vastgelegde koppeling’.
- Klik op ‘Details bekijken’ voor de inhoud van een verzoek.
Een ontbrekende koppeling kan betekenen dat de verwerking nog loopt. Het logboek geeft geen definitieve fout- of afleverstatus. Heb je geen toegang tot bellernummers? Dan zijn de telefoonnummers in het logboek gemaskeerd.
