Към съдържанието
REST API

Резултати от обаждания в Google Sheets

Импортирайте шаблона в n8n и запишете примерно обаждане в Google Sheets. Свържете акаунта си във Volai за автоматичен запис на следващите приключили обаждания.

1Импортирайте работния процес в n8n

Запазете JSON файла от връзката по-горе. В редактора на n8n отворете менюто на работния процес и изберете Import from File. Шаблонът използва вградени възли и е тестван с n8n 2.48.5.

2Подгответе електронната таблица

Създайте празен лист в Google Sheets с име Call results. Копирайте заглавния ред по-долу и го поставете в A1. Всяка стойност трябва да е в отделна колона на първия ред.

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

3Запишете примерен ред

В Write call result to Google Sheets изберете удостоверяване с Google Sheets OAuth2. Задайте By ID в Document и поставете частта от адреса между /d/ и /edit. Оставете Call results в Sheet. За проба без акаунт във Volai деактивирайте Confirm successful write. Стартирайте от Test with a sample call. Потърсете DEMO-call-result-001 със sample в колоната Mode. Повторното изпълнение обновява същия ред.

4Свържете акаунта във Volai

Създайте акаунт във Volai и генерирайте ключ в настройките на API. В n8n добавете Header Auth. В полето Name въведете Authorization, а в Value въведете Bearer <API key>, като замените <API key> с вашия ключ. Изберете произволно показвано име. Изберете го в Read Volai call event и по желание в Confirm successful write. За да изпратите потвърждение, активирайте този възел и изпълнете примера отново.

5Абонирайте се за приключили обаждания

В Volai call completed копирайте публичния HTTPS адрес Production URL. Ако пътят на webhook вече се използва, променете го преди копиране. Заменете примерния адрес в командата и я изпълнете в Bash или Zsh. Въведете API ключа при поискване. Пазете отговора поверителен и копирайте от него 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
)

6Публикувайте работния процес

Добавете второ удостоверяване Header Auth. В полето Name въведете X-Volai-Webhook-Token, а в Value поставете стойността на deliveryToken от отговора на API. Изберете го в Volai call completed и публикувайте. След следващото приключило обаждане потърсете ред с live. Преди запис процесът проверява токена и прочита събитието от Volai.

Какво ще постигнете

Дневен отчет за обажданията

Пребройте приключилите обаждания по дни според часа на събитието в UTC.

Натоварване на екипа

Сравнете броя и продължителността на входящите и изходящите обаждания в обобщена таблица.

Проверка на автоматизацията

Съпоставете редовете с историята във Volai по идентификатора на обаждането.

Често задавани въпроси

Какво се записва в таблицата?
Всеки ред съдържа идентификатор на обаждането, час на събитието в UTC, посока, статус, продължителност в секунди и режим sample или live. Телефонните номера, транскрипциите и записите се пропускат.
Какво измерва работният процес?
След успешен запис Confirm successful write може да изпрати потвърждение до Volai. За акаунти, създадени през това ръководство със съгласие за измерване, Volai отчита отделно първото потвърдено примерно и първото реално изпълнение до седем дни от регистрацията. Потвърждението не включва клетки от таблицата. При реални обаждания Volai проверява собствеността и състоянието по идентификаторите на абонамента и събитието. Деактивирайте възела, за да спрете изпращането.
Може ли едно обаждане да се появи два пъти?
Последователните повторения обновяват реда със същия Call ID. Използвайте един работен процес на лист. При едновременни записи със същия идентификатор Google Sheets може да създаде два реда.
Какво да проверя, ако редът липсва?
Потърсете грешки в примера направо в редактора на n8n. При реално обаждане включете временно Save failed production executions в настройките на работния процес. Възпроизведете проблема, намерете стъпката с грешка в историята и изключете запазването. При проблем със записа проверете достъпа до Google, идентификатора на таблицата, името на листа и заглавния ред. При проблем с webhook проверете публикуването, публичния адрес и токена на абонамента.

Опитайте веднага

Регистрирайте се и първите 2 € са от нас.