Preskoči na vsebino
REST API

Rezultati klicev v Google Sheets

Uvozite predlogo n8n in v Google Sheets zapišite vzorčni klic. Povežite račun Volai za samodejno beleženje nadaljnjih zaključenih klicev.

1Uvozite predlogo v n8n

Shranite datoteko JSON s povezave zgoraj. V urejevalniku n8n odprite meni poteka dela in izberite Import from File. Predloga uporablja vgrajena vozlišča in je bila preizkušena z n8n 2.48.5.

2Pripravite preglednico

V Google Sheets ustvarite prazen delovni list z imenom Call results. Kopirajte spodnjo glavo in jo prilepite v A1. Vsaka vrednost naj bo v svojem stolpcu v prvi vrstici.

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

3Zapišite vzorčno vrstico

V vozlišču Write call result to Google Sheets izberite poverilnice Google Sheets OAuth2. Polje Document nastavite na By ID in vstavite del naslova preglednice med /d/ in /edit. V polju Sheet pustite Call results. Za preizkus brez računa Volai onemogočite Confirm successful write. Potek dela zaženite prek Test with a sample call. Poiščite DEMO-call-result-001 z vrednostjo sample v stolpcu Mode. Ponovitev posodobi isto vrstico.

4Povežite račun Volai

Ustvarite račun Volai in ustvarite ključ v nastavitvah API. V n8n ustvarite poverilnico Header Auth. V Name vnesite Authorization, v Value pa Bearer <API key>. Namesto <API key> vnesite svoj ključ. Prikazano ime izberite po želji. Izberite jo v Read Volai call event, za neobvezno potrditev pa tudi v Confirm successful write. Če jo želite poslati, omogočite vozlišče in ponovite preizkus.

5Naročite se na zaključene klice

V Volai call completed kopirajte javni naslov HTTPS Production URL. Če je pot webhooka že v uporabi, jo pred kopiranjem spremenite. V spodnjem ukazu zamenjajte vzorčni naslov in ukaz zaženite v Bashu ali Zshu. Po pozivu vnesite ključ API. Odgovor naj ostane zaseben, iz njega pa kopirajte 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
)

6Objavite potek dela

Ustvarite drugo poverilnico Header Auth. V Name vnesite X-Volai-Webhook-Token, v Value pa vrednost deliveryToken iz odgovora API. Izberite jo v Volai call completed in objavite potek dela. Po naslednjem zaključenem klicu poiščite vrstico z live. Potek dela pred zapisom preveri žeton in prebere dogodek iz Volai.

Kaj lahko z njim naredite

Dnevni pregled klicev

Preštejte zaključene klice po dnevih s časom dogodka v UTC.

Obremenitev ekipe

V vrtilni tabeli primerjajte število in trajanje dohodnih ter odhodnih klicev.

Preverjanje avtomatizacije

Po identifikatorju klica povežite vrstice z zgodovino klicev v Volai.

Pogosta vprašanja

Kateri podatki se zapišejo v preglednico?
Vsaka vrstica vsebuje ID klica, čas dogodka v UTC, smer, stanje, trajanje v sekundah in način sample ali live. Telefonske številke, prepisi in posnetki so izpuščeni.
Kaj se meri med izvajanjem?
Po uspešnem zapisu lahko Confirm successful write pošlje potrditev v Volai. Za račune, ustvarjene prek tega vodnika s soglasjem za merjenje, Volai v sedmih dneh po registraciji ločeno šteje prvo potrjeno vzorčno in prvo dejansko izvedbo. Potrditev ne vsebuje celic. Za dejanske klice Volai z ID-jema naročnine in dogodka preveri lastništvo in stanje. Pošiljanje izklopite tako, da onemogočite vozlišče.
Se lahko isti klic pojavi dvakrat?
Zaporedne ponovitve posodobijo vrstico z istim Call ID. Za vsak delovni list uporabite en potek dela. Pri sočasnih zapisih z istim ID-jem lahko Google Sheets ustvari več vrstic.
Kaj preveriti, če vrstice ni?
Pri vzorčni izvedbi poiščite napako v urejevalniku n8n. Za dejanski klic začasno vklopite Save failed production executions v nastavitvah poteka dela, ponovite težavo, poiščite neuspešni korak v zgodovini in izklopite shranjevanje. Pri pisanju preverite Googlova dovoljenja, ID preglednice, ime lista in natančno glavo. Pri webhooku preverite objavo, javni naslov in žeton.

Preizkusite takoj

Registrirajte se in prvih 2 € je na naš račun.