Gesprekstranscripties automatisch ophalen met N8N

• Gespreksopnames correct ingeschakeld
• Een werkende instantie van N8N
• Technische kennis
• Begrijpen hoe de gespreksnotificaties werken
• ze ingeschakeld hebben in freedom
• Basiskennis van API's, met name onze get call transcription API

In deze node (webhook) luisteren we naar gespreksnotificaties door de data van freedom naar onze N8N-instantie te sturen. Hiervoor moet je de link van N8N toevoegen aan de gespreksnotificaties in Freedom. Op deze manier worden alle gespreksnotificaties voor alle nummers en alle gesprekken (uitgaand + inkomend) naar N8N gestuurd.

‣

N8N: kopieer hier de webhook-url

‣

Freedom: plak hier de webhook-url

In deze node (If) wachten we tot de 'status' in de gespreksnotificatie 'ended' + reason=completed is. Zo weten we dat het gesprek is beëindigd. Er is geen garantie dat er een gespreksopname is, omdat we niet checken of het gesprek is beantwoord (door eerst de in-progress te controleren).

‣

N8N

We gebruiken een teller om opnieuw te proberen na een bepaalde wachttijd, als de API-call om de uitwerking op te halen mislukt.

‣

N8N

Nadat het gesprek is beëindigd en een teller op 0 is gezet, wachten we 1 minuut, zodat we zeker weten dat de server genoeg tijd heeft gehad om de gespreksopname uit te werken en beschikbaar te maken voor de API.

‣

N8N

Waarschijnlijk is deze stap overbodig, maar hier halen we het call ID op in een variabele genaamd call_id.

‣

N8N

Nu gaan we het API GET-verzoek maken. Je hebt 3 dingen nodig.

‣

Client_UUID

Je vindt de Client_UUID onder je persoonlijke freedom-instellingen. Je vindt het rechtsboven in je freedom-portaal, onder: persoonlijk - Persoonlijke instellingen.

Andere methoden zijn het kopiëren van het linkadres van de gespreksnotificatie of het kopiëren van een deel van de URL uit de Openingstijden | Basis Module.

Nadat we de Bearer auth token en de client_UUID hebben verkregen, kunnen we verder met het HTTP-verzoek in N8N. De makkelijkste manier is om naar onze openAPI docs te gaan en de Client_UUID en bearer auth token in te vullen, en het gegenereerde curl-commando te kopiëren zoals hieronder weergegeven.

‣

In de API docs

Genereer het Curl-commando door je api token en client_uuid in de vereiste velden te kopiëren. De call_id laten we in dit voorbeeld leeg.

‣

In N8N

1. Importeer eerst het curl-commando.

2. Genereer een voorbeeld van een gespreksnotificatie ended, vang het op in N8N, en plaats de {{ $json.body.call_id }} in de http request URL.


Copy-pasten van de {{ $json.body.call_id }} zou ook moeten werken, maar dat hebben we niet getest.

Nu kun je de data schrijven waar je maar wilt.

• Google Drive
• Slack
• Email
• Je CRM
• …..

We verhogen de waarde van de teller met 1

‣

N8N

Copy

{{ $counter = $counter|0 + 1 }}

We checken of de teller kleiner of gelijk is aan 15. Op deze manier probeert het 14 keer opnieuw.

‣

N8N