Gå til indholdet
REST API

Opkaldsresultater i Google Sheets

Importér n8n-skabelonen, og skriv et eksempelopkald til Google Sheets. Tilslut en Volai-konto for automatisk at registrere kommende afsluttede opkald.

1Importér workflowet i n8n

Gem JSON-filen fra linket ovenfor. Åbn workflowmenuen i n8n-editoren, og vælg Import from File. Skabelonen bruger indbyggede noder og er testet i n8n 2.48.5.

2Klargør regnearket

Opret en tom fane i Google Sheets med navnet Call results. Kopiér kolonneoverskrifterne nedenfor, og indsæt dem i A1. Hver værdi skal have sin egen kolonne i første række.

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

3Skriv en eksempelrække

Vælg Google Sheets OAuth2-forbindelsen i Write call result to Google Sheets. Sæt Document til By ID, og indsæt den del af regnearkets adresse, der står mellem /d/ og /edit. Behold Call results i Sheet. Deaktivér Confirm successful write for at teste uden en Volai-konto. Start fra Test with a sample call. Find DEMO-call-result-001 med sample i kolonnen Mode. En ny kørsel opdaterer samme række.

4Tilslut Volai-kontoen

Opret en Volai-konto, og generér en nøgle i API-indstillingerne. Opret en Header Auth-forbindelse i n8n. Skriv Authorization i Name og Bearer <API key> i Value, hvor <API key> erstattes med nøglen. Visningsnavnet kan vælges frit. Vælg den i Read Volai call event og også i Confirm successful write, hvis bekræftelser skal sendes. Aktivér i så fald noden, og kør eksemplet igen.

5Abonnér på afsluttede opkald

Kopiér den offentlige HTTPS-adresse Production URL i Volai call completed. Er webhookstien allerede i brug, skal den ændres først. Udskift eksempeladressen i kommandoen nedenfor, og kør kommandoen i Bash eller Zsh. Indtast API-nøglen, når der bliver bedt om den. Hold svaret privat, og kopiér værdien 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
)

6Udgiv workflowet

Opret endnu en Header Auth-forbindelse. Skriv X-Volai-Webhook-Token i Name og værdien af deliveryToken fra API-svaret i Value. Vælg den i Volai call completed, og udgiv workflowet. Find en række med live efter næste afsluttede opkald. Workflowet kontrollerer tokenet og læser hændelsen fra Volai inden skrivning.

Hvad den kan bruges til

Daglig opkaldsoversigt

Tæl afsluttede opkald pr. dag ud fra hændelsestidspunktet i UTC.

Teamets arbejdsbelastning

Sammenlign antal og varighed af indgående og udgående opkald i en pivottabel.

Kontrol af automatiseringen

Match rækkerne med opkaldshistorikken i Volai ved hjælp af opkalds-id.

Ofte stillede spørgsmål

Hvad bliver skrevet til arket?
Hver række har opkalds-id, hændelsestidspunkt i UTC, retning, status, varighed i sekunder og tilstanden sample eller live. Telefonnumre, transskriptioner og optagelser udelades.
Hvad måler workflowet?
Efter en vellykket skrivning kan Confirm successful write sende en bekræftelse til Volai. For konti, der er oprettet via denne vejledning med samtykke til måling, tæller Volai den første bekræftede prøvekørsel og den første bekræftede driftskørsel hver for sig i de første syv dage. Bekræftelsen indeholder ingen celler. Ved rigtige opkald bruger Volai abonnements- og hændelses-id til at kontrollere ejerskab og status. Deaktivér noden for at stoppe afsendelsen.
Kan samme opkald vises to gange?
Gentagelser efter hinanden opdaterer rækken med samme Call ID. Brug ét workflow pr. fane. Google Sheets kan oprette to rækker, hvis samme id skrives samtidig.
Hvad kan kontrolleres, hvis rækken mangler?
Find fejl i prøvekørslen direkte i n8n-editoren. Ved fejl med rigtige opkald kan Save failed production executions aktiveres midlertidigt i workflowindstillingerne. Gentag problemet, find det fejlede trin i historikken, og slå lagring fra igen. Kontrollér ved skrivefejl Google-adgang, dokument-id, fanenavn og præcise kolonneoverskrifter. Kontrollér udgivelse, offentlig adresse og abonnementstoken ved webhookfejl.

Prøv det med det samme

Opret en konto, og de første 15 kr. i saldo er på os.