Naar de inhoud springen
REST API

Gespreksresultaten naar Google Sheets

Importeer het n8n-sjabloon en schrijf een voorbeeldgesprek naar Google Sheets. Verbind uw Volai-account om volgende afgeronde gesprekken automatisch vast te leggen.

1Importeer de workflow in n8n

Sla het JSON-bestand via de link hierboven op. Open in de n8n-editor het workflowmenu en kies Import from File. Het sjabloon gebruikt ingebouwde nodes en is getest met n8n 2.48.5.

2Bereid het werkblad voor

Maak in Google Sheets een leeg tabblad met de naam Call results. Kopieer de kopregel hieronder en plak deze in A1. Zet elke waarde in een aparte kolom op de eerste rij.

text
Call ID	Event time (UTC)	Direction	Status	Duration (s)	Mode

3Schrijf een voorbeeldrij

Selecteer in Write call result to Google Sheets uw Google Sheets OAuth2-inloggegevens. Stel Document in op By ID en plak het deel van de spreadsheet-URL tussen /d/ en /edit. Laat Sheet op Call results staan. Schakel voor een test zonder Volai-account Confirm successful write uit. Start via Test with a sample call. Zoek DEMO-call-result-001 met sample in kolom Mode. Een herhaling werkt dezelfde rij bij.

4Verbind uw Volai-account

Maak een Volai-account aan en maak een sleutel in de API-instellingen. Voeg in n8n een Header Auth-verbinding toe. Vul Authorization in bij Name en Bearer <API key> bij Value. Vervang <API key> door uw sleutel. Kies zelf de weergavenaam. Kies deze verbinding in Read Volai call event en voor de optionele bevestiging ook in Confirm successful write. Schakel die node in en herhaal de proef om de bevestiging te sturen.

5Abonneer u op afgeronde gesprekken

Kopieer de openbare HTTPS-adreswaarde Production URL uit Volai call completed. Is het webhookpad al in gebruik, wijzig het dan eerst. Vervang het voorbeeldadres in de opdracht hieronder en voer deze uit in Bash of Zsh. Voer uw API-sleutel in zodra daarom wordt gevraagd. Houd het antwoord privé en kopieer hieruit deliveryToken.

bash
(
  printf 'Volai API key> '
  IFS= read -rs VOLAI_API_KEY
  printf '\n'
  printf 'Authorization: Bearer %s\n' "$VOLAI_API_KEY" |
    curl --fail-with-body --silent --show-error \
      --header @- \
      --header 'Content-Type: application/json' \
      --data '{"url":"https://your-n8n.example/webhook/volai-call-result-to-sheets","events":["call.completed"]}' \
      https://volai.cz/v1/webhook-subscriptions
)

6Publiceer de workflow

Maak een tweede Header Auth-verbinding. Vul X-Volai-Webhook-Token in bij Name en de waarde van deliveryToken uit het API-antwoord bij Value. Selecteer die in Volai call completed en publiceer de workflow. Zoek na het volgende afgeronde gesprek een rij met live. Vóór het schrijven controleert de workflow de token en haalt hij de gebeurtenis op bij Volai.

Wat u ermee doet

Dagelijks gespreksoverzicht

Tel afgeronde gesprekken per dag op basis van de gebeurtenistijd in UTC.

Werkdruk van het team

Vergelijk aantal en duur van inkomende en uitgaande gesprekken in een draaitabel.

Automatisering controleren

Vergelijk de rijen met uw gespreksgeschiedenis in Volai via het gespreks-ID.

Veelgestelde vragen

Wat wordt er vastgelegd?
Elke rij bevat het gespreks-ID, gebeurtenistijd in UTC, richting, status, duur in seconden en de modus sample of live. Telefoonnummers, transcripties en opnames blijven buiten de tabel.
Wat meet de workflow?
Na een geslaagde schrijfactie kan Confirm successful write een bevestiging naar Volai sturen. Voor via deze handleiding aangemaakte accounts met toestemming voor meting telt Volai de eerste bevestigde proef en de eerste bevestigde live-uitvoering afzonderlijk binnen zeven dagen. De bevestiging bevat geen cellen. Voor live-uitvoeringen controleert Volai het eigendom en de status met de abonnements- en gebeurtenis-ID's. Schakel de node uit om verzending te stoppen.
Kan hetzelfde gesprek dubbel verschijnen?
Bij opeenvolgende herhalingen wordt de rij met dezelfde Call ID bijgewerkt. Gebruik één workflow per tabblad. Bij gelijktijdig schrijven van hetzelfde ID garandeert Google Sheets geen enkele rij.
Wat controleer ik als de rij ontbreekt?
Bekijk fouten in de proef rechtstreeks in de n8n-editor. Schakel bij een live-fout tijdelijk Save failed production executions in de workflowinstellingen in. Herhaal het probleem, bekijk de mislukte stap in de geschiedenis en schakel het opslaan weer uit. Controleer bij schrijffouten de toegangsrechten bij Google, het document-ID, de tabbladnaam en de precieze kopregel. Controleer voor de webhook of de workflow is gepubliceerd en of de openbare URL en token kloppen.

Probeer het meteen

Registreer u en de eerste € 2 is voor onze rekening.