Přeskočit na obsah
REST API

Výsledek hovoru do Google Sheets

Importuj šablonu do n8n a vyzkoušej zápis fiktivního hovoru. Po připojení účtu Volai se každý dokončený hovor zapíše do Google Sheets.

1Importuj šablonu do n8n

Ulož soubor JSON z odkazu výše. V editoru n8n otevři nabídku workflow a vyber Import from File. Šablona používá vestavěné uzly n8n a je ověřená ve verzi 2.48.5.

2Připrav tabulku

V Google Sheets vytvoř prázdný list s názvem Call results. Zkopíruj záhlaví níže a vlož ho do buňky A1. Každá hodnota patří do vlastního sloupce v prvním řádku.

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

3Zapiš ukázkový řádek

V uzlu Write call result to Google Sheets vyber Google Sheets OAuth2. Do Document v režimu By ID vlož část adresy tabulky mezi /d/ a /edit. V poli Sheet ponech Call results. Pro zkoušku bez účtu Volai vypni uzel Confirm successful write. Spusť workflow přes Test with a sample call. V tabulce se objeví DEMO-call-result-001 s hodnotou sample ve sloupci Mode. Opakovaný běh aktualizuje stejný řádek.

4Připoj účet Volai

Založ si účet Volai a v nastavení API si vytvoř API klíč. V n8n přidej přihlašovací údaj Header Auth. Do pole Name zadej Authorization a do Value zadej Bearer <API key>, kde místo <API key> vložíš svůj klíč. Připojení si pojmenuj libovolně. Vyber ho v uzlu Read Volai call event a také v Confirm successful write, pokud chceš odesílat potvrzení zápisu. V takovém případě uzel znovu zapni a spusť ukázku ještě jednou.

5Přihlas se k události dokončeného hovoru

V uzlu Volai call completed zkopíruj veřejnou HTTPS adresu Production URL. Pokud v n8n už používáš stejnou cestu webhooku, změň ji před kopírováním. V příkazu níže nahraď ukázkovou adresu zkopírovanou adresou a spusť ho v Bash nebo Zsh. Po výzvě zadej svůj API klíč. Odpověď si nech v soukromí a zkopíruj z ní hodnotu 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
)

6Zapni zápis skutečných hovorů

Přidej druhý přihlašovací údaj Header Auth. Do pole Name zadej X-Volai-Webhook-Token a do Value vlož hodnotu deliveryToken z odpovědi API. Vyber ho v uzlu Volai call completed, pak workflow publikuj. Po příštím dokončeném hovoru hledej v tabulce řádek s live. Workflow ověří token a načte událost z Volai, než ji zapíše.

Co s tím uděláš

Denní přehled hovorů

Spočítej dokončené hovory po dnech podle času události v UTC.

Vytíženost týmu

Porovnej délku a počet příchozích a odchozích hovorů ve vlastní kontingenční tabulce.

Kontrola automatizace

Porovnej řádky v tabulce s historií ve Volai podle jedinečného ID hovoru.

Časté otázky

Jaké údaje se zapisují do tabulky?
Zapisuje se ID hovoru, čas události v UTC, směr, stav, délka v sekundách a režim sample nebo live. Workflow vynechává telefonní čísla, přepisy a nahrávky.
Co se měří při prvním spuštění?
Po úspěšném zápisu může uzel Confirm successful write odeslat potvrzení Volai. U účtů založených z tohoto návodu se souhlasem s měřením se v prvních sedmi dnech počítá zvlášť první ukázkový a první skutečný běh. Údaje z řádku se v potvrzení neposílají. U skutečného hovoru Volai použije ID odběru a události k ověření jejich vlastnictví a stavu. Odesílání vypneš v n8n deaktivací tohoto uzlu.
Může se jeden hovor zapsat dvakrát?
Při postupném opakování se podle Call ID aktualizuje původní řádek. Používej jednu šablonu na jeden list a při souběžném doručení počítej s tím, že Google Sheets dvěma zápisům stejného ID nemusí zabránit.
Co mám zkontrolovat, když řádek nepřibyl?
U ukázky najdi chybu přímo v editoru n8n. Při potížích se skutečným hovorem v nastavení workflow dočasně zapni Save failed production executions, zopakuj problém a najdi chybu v historii spuštění. Pak ukládání zase vypni. U zápisu zkontroluj oprávnění Google, ID tabulky, název listu a přesné záhlaví. U webhooku ověř publikování, veřejnou adresu a správný token daného odběru.

Vyzkoušej to hned

Zaregistruj se a prvních 50 Kč je na nás.