Liigu sisu juurde
REST API

Kõne tulemused Google Sheetsi

Importige n8n-i mall ja kirjutage näidiskõne Google Sheetsi. Ühendage konto teenuses Volai, et edaspidi lõppenud kõned automaatselt salvestada.

1Importige töövoog n8n-i

Salvestage ülal viidatud JSON-fail. Avage n8n-i redaktoris töövoo menüü ja valige Import from File. Mall kasutab sisseehitatud sõlmi ja seda on testitud n8n-i versiooniga 2.48.5.

2Valmistage arvutustabel ette

Looge Google Sheetsis tühi leht nimega Call results. Kopeerige allolev päis ja kleepige see lahtrisse A1. Iga väärtus läheb esimeses reas oma veergu.

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

3Kirjutage näidisrida

Valige sõlmes Write call result to Google Sheets Google Sheetsi OAuth2 ühendus. Valige väljal Document suvand By ID ja kleepige arvutustabeli URL-i lõik /d/ ja /edit vahel. Jätke väljale Sheet väärtus Call results. Prooviks ilma teenuse Volai kontota lülitage Confirm successful write välja. Käivitage töövoog sõlmest Test with a sample call. Otsige rida DEMO-call-result-001, mille veerus Mode on sample. Korduskäivitus uuendab sama rida.

4Ühendage konto teenuses Volai

Looge konto teenuses Volai ja looge API seadetes võti. Lisage n8n-is Header Auth ühendus. Sisestage väljale Name Authorization ja väljale Value Bearer <API key>, asendades <API key> oma võtmega. Ühenduse kuvatava nime saate ise valida. Valige see ühendus sõlmes Read Volai call event ja soovi korral ka sõlmes Confirm successful write. Kinnituse saatmiseks lubage viimane sõlm ja käivitage näidis uuesti.

5Tellige lõppenud kõnede sündmused

Kopeerige sõlmest Volai call completed avalik HTTPS-aadress Production URL. Kui webhooki tee on juba kasutusel, muutke seda enne kopeerimist. Asendage allolevas käsus näidisaadress ja käivitage käsk Bashis või Zshis. Sisestage küsimise peale API võti. Hoidke vastus privaatsena ja kopeerige sealt 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
)

6Avaldage töövoog

Looge teine Header Auth ühendus. Sisestage väljale Name X-Volai-Webhook-Token ja väljale Value API vastusest saadud deliveryToken. Valige see sõlmes Volai call completed ja avaldage töövoog. Pärast järgmist lõppenud kõnet otsige rida, mille tüüp on live. Enne kirjutamist kontrollib töövoog tokenit ja loeb sündmuse teenusest Volai.

Mida sellega teha saab

Kõnede päevaülevaade

Loendage lõppenud kõned päevade kaupa, kasutades sündmuse UTC-aega.

Meeskonna töökoormus

Võrrelge sissetulevate ja väljaminevate kõnede arvu ja kestust liigendtabelis.

Automatiseerimise kontroll

Võrrelge ridu teenuse Volai kõneajalooga kõne ID järgi.

Korduma kippuvad küsimused

Millised andmed tabelisse lähevad?
Rida sisaldab kõne ID-d, sündmuse aega UTC-s, suunda, olekut, kestust sekundites ja tüüpi sample või live. Telefoninumbreid, transkriptsioone ja salvestisi tabelisse ei lisata.
Mida töövoog mõõdab?
Pärast edukat kirjutamist võib Confirm successful write saata teenusele Volai kinnituse. Kui konto loodi selle juhendi kaudu ja mõõtmisega nõustuti, loendab Volai seitsme päeva jooksul eraldi esimese kinnitatud näidiskäituse ja päriskäituse. Kinnitus ei sisalda tabeli lahtreid. Päriskõne korral kontrollib Volai tellimuse ja sündmuse ID järgi omanikku ja olekut. Saatmise peatamiseks lülitage sõlm välja.
Kas sama kõne võib ilmuda kaks korda?
Järjestikused kordused uuendavad sama Call ID-ga rida. Kasutage iga lehe jaoks ühte töövoogu. Kui sama ID-ga kirjutused toimuvad korraga, võib Google Sheets luua kaks rida.
Mida kontrollida, kui rida puudub?
Otsige näidiskäituse vigu n8n-i redaktorist. Päriskõne tõrke korral lülitage töövoo seadetes ajutiselt sisse Save failed production executions. Korrake probleemi, otsige ajaloost nurjunud samm ja lülitage salvestamine uuesti välja. Kirjutusvea puhul kontrollige Google'i õigusi, tabeli ID-d, lehe nime ja päist. Webhooki puhul kontrollige avaldamist, avalikku aadressi ja tellimuse tokenit.

Proovige kohe järele

Registreeruge ja esimesed 2 € on meie kingitus.