Meer conversies Betere prestaties Direct aan de slag

Zo gebruik je de Call Match API

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:

  1. Ga binnen de Qooqie call tracking applicatie naar Integraties > Call Match API.
  2. Klik op ‘Geheime sleutel aanmaken’.
  3. Kopieer de sleutel met ‘Kopiëren’ en bewaar hem veilig in het systeem dat de API aanroept.
De Call Match API-pagina met een ingestelde geheime sleutel en de knoppen ‘Sleutel tonen’ en ‘Nieuwe sleutel maken’.

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:

  1. Stuur een POST-verzoek met JSON naar het adres dat op de pagina staat.
  2. Zet de header x-hook-signature op de hex HMAC-SHA256 van exact de verzonden JSON, met de geheime sleutel.
  3. 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.

Klaar voor meer inzicht, meer leads en betere conversies?

Begin met het optimaliseren van jouw resultaten.

Probeer een gratis proefperiode van 14 dagen, geen creditcard vereist.