Siirry sisältöön
REST API

Puhelujen tulokset Google Sheetsiin

Tuo n8n-malli ja kirjoita esimerkkipuhelu Google Sheetsiin. Yhdistä Volai-tili, niin tulevat päättyneet puhelut tallentuvat automaattisesti.

1Tuo työnkulku n8n:ään

Tallenna JSON-tiedosto yllä olevasta linkistä. Avaa työnkulun valikko n8n-editorissa ja valitse Import from File. Malli käyttää sisäisiä solmuja ja on testattu n8n-versiolla 2.48.5.

2Valmistele laskentataulukko

Luo Google Sheetsiin tyhjä välilehti nimeltä Call results. Kopioi alla oleva otsikkorivi ja liitä se soluun A1. Jokaiselle arvolle tulee ensimmäisellä rivillä oma sarake.

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

3Kirjoita esimerkkirivi

Valitse Write call result to Google Sheets -solmussa Google Sheets OAuth2 -tunnistetiedot. Valitse Document-kentässä By ID ja liitä laskentataulukon osoitteen osa kohtien /d/ ja /edit välistä. Säilytä Sheet-kentän arvona Call results. Ota Confirm successful write pois käytöstä, jos testaat ilman Volai-tiliä. Käynnistä työnkulku kohdasta Test with a sample call. Etsi DEMO-call-result-001, jonka Mode-sarakkeessa on sample. Uusi ajo päivittää saman rivin.

4Yhdistä Volai-tili

Luo Volai-tili ja luo avain API-asetuksissa. Luo n8n:ssä Header Auth -tunniste. Syötä Authorization kenttään Name ja Bearer <API key> kenttään Value. Korvaa <API key> avaimella. Näyttönimen voi valita vapaasti. Valitse tunniste kohdassa Read Volai call event ja haluttaessa kohdassa Confirm successful write. Lähetä vahvistus ottamalla jälkimmäinen solmu käyttöön ja ajamalla esimerkki uudelleen.

5Tilaa päättyneiden puhelujen tapahtumat

Kopioi Volai call completed -solmusta julkinen HTTPS-osoite Production URL. Jos webhookin polku on jo käytössä, muuta se ennen kopiointia. Korvaa alla olevan komennon esimerkkiosoite ja suorita komento Bashissa tai Zsh:ssa. Syötä API-avain pyydettäessä. Pidä vastaus yksityisenä ja kopioi siitä 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
)

6Julkaise työnkulku

Luo toinen Header Auth -tunniste. Syötä X-Volai-Webhook-Token kenttään Name ja API-vastauksen deliveryToken kenttään Value. Valitse tunniste kohdassa Volai call completed ja julkaise työnkulku. Etsi seuraavan päättyneen puhelun jälkeen rivi, jossa on live. Ennen kirjoittamista työnkulku tarkistaa tunnuksen ja lukee tapahtuman Volai-palvelusta.

Mitä sillä voi tehdä

Päivittäinen puheluraportti

Laske päättyneet puhelut päiväkohtaisesti tapahtuman UTC-ajan mukaan.

Tiimin työkuorma

Vertaa saapuvien ja lähtevien puhelujen määrää ja kestoa pivot-taulukossa.

Automaation tarkistus

Yhdistä rivit Volai-puheluhistoriaan puhelutunnisteella.

Usein kysyttyä

Mitä taulukkoon kirjoitetaan?
Rivillä on puhelutunniste, tapahtuma-aika UTC:ssa, suunta, tila, kesto sekunteina ja arvo sample tai live. Puhelinnumerot, litteroinnit ja tallenteet jätetään pois.
Mitä työnkulku mittaa?
Onnistuneen kirjoituksen jälkeen Confirm successful write voi lähettää vahvistuksen Volai-palveluun. Kun tili on luotu tämän ohjeen kautta ja mittaukseen on annettu suostumus, Volai laskee ensimmäisen vahvistetun esimerkkiajon ja ensimmäisen tosiajon erikseen seitsemän päivän kuluessa rekisteröitymisestä. Vahvistuksessa ei ole taulukon soluja. Tosiajoissa Volai tarkistaa tilauksen ja tapahtuman tunnisteilla niiden omistajuuden ja tilan. Lähetyksen voi lopettaa poistamalla solmun käytöstä.
Voiko sama puhelu näkyä kahdesti?
Peräkkäiset toistot päivittävät saman Call ID -tunnisteen rivin. Käytä yhtä työnkulkua välilehteä kohden. Saman tunnisteen yhtäaikaiset kirjoitukset voivat luoda Google Sheetsiin kaksi riviä.
Mitä tarkistetaan, jos rivi puuttuu?
Esimerkkiajon virheet näkyvät n8n-editorissa. Ota oikean puhelun vianmääritystä varten tilapäisesti Save failed production executions käyttöön työnkulun asetuksissa. Toista virhe, etsi epäonnistunut vaihe ajohistoriasta ja poista tallennus käytöstä. Tarkista kirjoitusvirheen yhteydessä Google-oikeudet, asiakirjan tunniste, välilehti ja otsikot. Webhook-virheen yhteydessä tarkista julkaisu, julkinen osoite ja tilauksen tunnus.

Kokeile heti

Rekisteröidy, niin saat ensimmäiset 2 € meiltä.