Treceți la conținut
REST API

Rezultatele apelurilor în Google Sheets

Importați șablonul n8n și scrieți un apel demonstrativ în Google Sheets. Conectați contul Volai pentru a înregistra automat apelurile finalizate ulterior.

1Importați fluxul de lucru în n8n

Salvați fișierul JSON de la linkul de mai sus. În editorul n8n, deschideți meniul fluxului de lucru și alegeți Import from File. Șablonul folosește noduri integrate și a fost testat cu n8n 2.48.5.

2Pregătiți foaia de calcul

Creați în Google Sheets o filă goală cu numele Call results. Copiați antetul de mai jos și lipiți-l în A1. Fiecare valoare ocupă o coloană separată din primul rând.

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

3Scrieți un rând demonstrativ

În Write call result to Google Sheets, selectați datele de autentificare Google Sheets OAuth2. Setați Document la By ID și lipiți partea din adresa foii de calcul dintre /d/ și /edit. Păstrați Call results în câmpul Sheet. Pentru a testa fără cont Volai, dezactivați Confirm successful write. Porniți din Test with a sample call. Căutați DEMO-call-result-001 cu sample în coloana Mode. La repetare se actualizează același rând.

4Conectați contul Volai

Creați un cont Volai și generați o cheie în setările API. În n8n, creați o autentificare Header Auth. Introduceți Authorization în Name și Bearer <API key> în Value, înlocuind <API key> cu cheia proprie. Numele afișat poate fi ales liber. Selectați-o în Read Volai call event și, pentru confirmarea opțională, în Confirm successful write. Dacă doriți confirmarea, activați nodul și rulați din nou exemplul.

5Abonați-vă la apelurile finalizate

Copiați adresa HTTPS publică Production URL din Volai call completed. Dacă ruta webhook este deja folosită, modificați-o înainte de copiere. Înlocuiți adresa demonstrativă din comanda de mai jos și rulați-o în Bash sau Zsh. Introduceți cheia API atunci când vi se cere. Păstrați răspunsul în siguranță și copiați deliveryToken din el.

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
)

6Publicați fluxul de lucru

Creați o a doua autentificare Header Auth. Introduceți X-Volai-Webhook-Token în Name și valoarea deliveryToken din răspuns în Value. Selectați-o în Volai call completed și publicați fluxul. După următorul apel finalizat, căutați un rând cu live. Fluxul verifică tokenul și citește evenimentul din Volai înainte de scriere.

Ce puteți face cu el

Raport zilnic al apelurilor

Numărați apelurile finalizate pe zile, folosind ora evenimentului în UTC.

Volumul de lucru al echipei

Comparați numărul și durata apelurilor primite și efectuate într-un tabel pivot.

Verificarea automatizării

Asociați rândurile cu istoricul apelurilor Volai folosind identificatorul apelului.

Întrebări frecvente

Ce date ajung în foaia de calcul?
Fiecare rând conține identificatorul apelului, ora evenimentului în UTC, direcția, starea, durata în secunde și modul sample sau live. Numerele de telefon, transcrierile și înregistrările audio sunt omise.
Ce măsoară fluxul de lucru?
După o scriere reușită, Confirm successful write poate trimite o confirmare către Volai. Pentru conturile create din acest ghid cu acord de măsurare, Volai numără separat prima rulare demonstrativă confirmată și prima rulare reală confirmată în șapte zile de la înregistrare. Confirmarea nu include celulele foii. Pentru apelurile reale, Volai verifică apartenența și starea cu identificatorii abonamentului și evenimentului. Dezactivați nodul pentru a opri trimiterea.
Același apel poate apărea de două ori?
Repetările succesive actualizează rândul cu același Call ID. Folosiți un flux de lucru pentru fiecare filă. Google Sheets poate crea două rânduri dacă apar scrieri simultane pentru același ID.
Ce verific dacă lipsește rândul?
Verificați erorile exemplului direct în editorul n8n. Pentru un apel real, activați temporar Save failed production executions în setările fluxului, reproduceți eroarea și căutați pasul cu probleme în istoricul execuțiilor. Opriți apoi salvarea. Pentru scriere, verificați permisiunile Google, ID-ul documentului, numele filei și antetul exact. Pentru webhook, verificați publicarea, adresa publică și tokenul.

Încercați chiar acum

Înregistrați-vă și primii 10 lei sunt din partea noastră.