Pāriet uz saturu
REST API

Zvanu rezultāti Google Sheets

Importējiet n8n veidni un ierakstiet Google Sheets parauga zvanu. Pievienojiet Volai kontu, lai turpmāk pabeigtos zvanus reģistrētu automātiski.

1Importējiet darbplūsmu n8n

Saglabājiet JSON failu no iepriekš redzamās saites. n8n redaktorā atveriet darbplūsmas izvēlni un izvēlieties Import from File. Veidnē izmantoti iebūvēti mezgli, un tā pārbaudīta n8n versijā 2.48.5.

2Sagatavojiet izklājlapu

Izveidojiet tukšu Google Sheets lapu ar nosaukumu Call results. Nokopējiet zemāk redzamo galveni un ielīmējiet šūnā A1. Katrai vērtībai jābūt savā pirmās rindas kolonnā.

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

3Ierakstiet parauga rindu

Mezglā Write call result to Google Sheets atlasiet Google Sheets OAuth2 piekļuves datus. Laukā Document izvēlieties By ID un ielīmējiet izklājlapas adreses daļu starp /d/ un /edit. Laukā Sheet atstājiet Call results. Lai izmēģinātu bez Volai konta, atspējojiet Confirm successful write. Palaidiet darbplūsmu no Test with a sample call. Meklējiet DEMO-call-result-001 ar sample kolonnā Mode. Atkārtota palaišana atjaunina to pašu rindu.

4Pievienojiet Volai kontu

Izveidojiet Volai kontu un izveidojiet atslēgu API iestatījumos. n8n izveidojiet Header Auth piekļuves datus. Laukā Name ievadiet Authorization un laukā Value ievadiet Bearer <API key>, aizstājot <API key> ar savu atslēgu. Redzamo nosaukumu izvēlieties brīvi. Atlasiet tos mezglā Read Volai call event un, lai nosūtītu apstiprinājumu, arī Confirm successful write. Šādā gadījumā iespējojiet mezglu un palaidiet paraugu vēlreiz.

5Abonējiet pabeigto zvanu notikumus

Mezglā Volai call completed nokopējiet publisko HTTPS adresi Production URL. Ja webhook ceļš jau tiek lietots, mainiet to pirms kopēšanas. Aizstājiet piemērā norādīto adresi un izpildiet komandu Bash vai Zsh. Pēc uzaicinājuma ievadiet API atslēgu. Saglabājiet atbildi privātu un nokopējiet no tās deliveryToken vērtību.

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
)

6Publicējiet darbplūsmu

Izveidojiet otrus Header Auth piekļuves datus. Laukā Name ievadiet X-Volai-Webhook-Token un laukā Value ielīmējiet deliveryToken vērtību no API atbildes. Atlasiet tos mezglā Volai call completed un publicējiet darbplūsmu. Pēc nākamā pabeigtā zvana meklējiet rindu ar live. Pirms ieraksta darbplūsma pārbauda marķieri un nolasa notikumu no Volai.

Ko ar to varēsit izdarīt

Zvanu dienas pārskats

Saskaitiet pabeigtos zvanus pa dienām pēc notikuma laika UTC.

Komandas noslodze

Rakurstabulā salīdziniet ienākošo un izejošo zvanu skaitu un ilgumu.

Automatizācijas pārbaude

Salīdziniet rindas ar Volai zvanu vēsturi pēc zvana ID.

Biežāk uzdotie jautājumi

Kādi dati tiek ierakstīti izklājlapā?
Katrā rindā ir zvana ID, notikuma laiks UTC, virziens, statuss, ilgums sekundēs un režīms sample vai live. Tālruņu numuri, transkripcijas un ieraksti netiek pievienoti.
Ko mēra darbplūsma?
Pēc sekmīga ieraksta Confirm successful write var nosūtīt apstiprinājumu uz Volai. Kontiem, kas izveidoti no šī ceļveža ar piekrišanu mērīšanai, Volai pirmajās septiņās dienās atsevišķi uzskaita pirmo apstiprināto parauga un pirmo reālo izpildi. Apstiprinājumā nav tabulas šūnu. Reāliem zvaniem Volai ar abonementa un notikuma ID pārbauda piederību un statusu. Lai apturētu sūtīšanu, atspējojiet mezglu.
Vai viens zvans var parādīties divreiz?
Secīga atkārtošana atjaunina rindu ar to pašu Call ID. Lietojiet vienu darbplūsmu katrai lapai. Vienlaikus ierakstot vienu un to pašu ID, Google Sheets var izveidot divas rindas.
Ko pārbaudīt, ja rindas nav?
Parauga izpildes kļūdu meklējiet tieši n8n redaktorā. Reāla zvana kļūdas izmeklēšanai darbplūsmas iestatījumos īslaicīgi ieslēdziet Save failed production executions. Atkārtojiet problēmu, atrodiet kļūdaino soli vēsturē un atkal atspējojiet saglabāšanu. Ieraksta kļūdas gadījumā pārbaudiet Google piekļuvi, dokumenta ID, lapas nosaukumu un galveni. Webhook kļūdas gadījumā pārbaudiet publicēšanu, publisko adresi un abonementa marķieri.

Izmēģiniet uzreiz

Reģistrējieties un pirmie 2 € ir uz mūsu rēķina.