Preskočiť na obsah
REST API

Výsledok hovoru do Google Sheets

Importujte šablónu do n8n a zapíšte ukážkový hovor do Google Sheets. Po pripojení účtu Volai sa budú ďalšie dokončené hovory zapisovať automaticky.

1Importujte šablónu do n8n

Uložte súbor JSON z odkazu vyššie. V editore n8n otvorte ponuku workflow a vyberte Import from File. Šablóna používa vstavané uzly n8n a bola otestovaná vo verzii 2.48.5.

2Pripravte tabuľku

V Google Sheets vytvorte prázdny hárok s názvom Call results. Skopírujte hlavičku nižšie a vložte ju do bunky A1. Každá hodnota patrí do samostatného stĺpca v prvom riadku.

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

3Zapíšte ukážkový riadok

V uzle Write call result to Google Sheets vyberte pripojenie Google Sheets OAuth2. V poli Document nastavte By ID a vložte časť adresy tabuľky medzi /d/ a /edit. V poli Sheet ponechajte Call results. Na skúšku bez účtu Volai vypnite uzol Confirm successful write. Spustite workflow cez Test with a sample call. V tabuľke nájdite DEMO-call-result-001 s hodnotou sample v stĺpci Mode. Opakované spustenie aktualizuje ten istý riadok.

4Pripojte účet Volai

Vytvorte si účet Volai a v nastaveniach API si vytvorte kľúč. V n8n pridajte pripojenie Header Auth. Do poľa Name zadajte Authorization a do Value zadajte Bearer <API key>, pričom <API key> nahraďte svojím kľúčom. Názov pripojenia si zvoľte ľubovoľne. Vyberte ho v uzle Read Volai call event. Ak chcete posielať potvrdenia zápisu, vyberte ho aj v Confirm successful write, uzol zapnite a spustite ukážku znova.

5Prihláste sa na odber dokončených hovorov

Z uzla Volai call completed skopírujte verejnú adresu HTTPS Production URL. Ak sa cesta webhooku už používa, zmeňte ju pred kopírovaním. Nahraďte ukážkovú adresu v príkaze nižšie a spustite ho v Bash alebo Zsh. Na výzvu zadajte kľúč API. Odpoveď ponechajte v súkromí a skopírujte z nej 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
)

6Publikujte workflow

Vytvorte druhé pripojenie Header Auth. Do poľa Name zadajte X-Volai-Webhook-Token a do Value vložte hodnotu deliveryToken z odpovede API. Vyberte ho v uzle Volai call completed a publikujte workflow. Po ďalšom dokončenom hovore nájdite riadok s live. Workflow overí token a načíta udalosť z Volai pred zápisom.

Čo s tým urobíte

Denný prehľad hovorov

Spočítajte dokončené hovory po dňoch podľa času udalosti v UTC.

Vyťaženosť tímu

V kontingenčnej tabuľke porovnajte počet a dĺžku prichádzajúcich a odchádzajúcich hovorov.

Kontrola automatizácie

Spárujte riadky s históriou Volai podľa ID hovoru.

Časté otázky

Čo sa zapisuje do tabuľky?
Riadok obsahuje ID hovoru, čas udalosti v UTC, smer, stav, dĺžku v sekundách a režim sample alebo live. Telefónne čísla, prepisy a nahrávky sa vynechávajú.
Čo sa pri spustení meria?
Po úspešnom zápise môže uzol Confirm successful write odoslať potvrdenie Volai. Pri účtoch vytvorených z tohto návodu so súhlasom s meraním sa v prvých siedmich dňoch počíta zvlášť prvé potvrdené ukážkové a prvé skutočné spustenie. Potvrdenie neobsahuje bunky tabuľky. Pri skutočnom hovore Volai použije ID odberu a udalosti na overenie vlastníctva a stavu. Odosielanie vypnete deaktiváciou uzla.
Môže sa jeden hovor zapísať dvakrát?
Postupné opakovanie aktualizuje pôvodný riadok podľa Call ID. Používajte jeden workflow na hárok. Pri súbežnom zápise rovnakého ID Google Sheets nezaručuje jediný riadok.
Čo skontrolovať, ak riadok chýba?
Chybu pri ukážke hľadajte priamo v editore n8n. Pri skutočnom hovore dočasne zapnite Save failed production executions v nastaveniach workflow, zopakujte problém a pozrite si neúspešný krok v histórii spustení. Potom ukladanie vypnite. Pri zápise skontrolujte oprávnenia Google, ID tabuľky, názov hárka a presnú hlavičku. Pri webhooku skontrolujte publikovanie, verejnú adresu a token odberu.

Vyskúšajte to hneď

Zaregistrujte sa a prvých 2 € je na nás.