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.
Call ID Event time (UTC) Direction Status Duration (s) Mode3Zapiš 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.
(
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
samplenebolive. 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 IDaktualizuje 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.