Przejdź do treści
REST API

Wyniki połączeń w Google Sheets

Po zaimportowaniu szablonu n8n można zapisać przykładowe połączenie w Google Sheets. Po podłączeniu konta Volai kolejne zakończone połączenia zapisują się automatycznie.

1Import szablonu do n8n

Plik JSON można pobrać z odnośnika powyżej. W menu przepływu pracy w edytorze n8n należy wybrać Import from File. Szablon używa wbudowanych węzłów i został przetestowany w n8n 2.48.5.

2Przygotowanie arkusza

W Google Sheets potrzebna jest pusta karta o nazwie Call results. Poniższy nagłówek należy wkleić do komórki A1. Każda wartość powinna trafić do osobnej kolumny pierwszego wiersza.

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

3Zapis przykładowego wiersza

W węźle Write call result to Google Sheets należy wybrać dane uwierzytelniające Google Sheets OAuth2. W Document w trybie By ID należy wkleić część adresu między /d/ a /edit. W polu Sheet pozostaje Call results. W próbie bez konta Volai potrzebne jest wyłączenie Confirm successful write. Przepływ uruchamia się z Test with a sample call. Wynik pojawia się jako DEMO-call-result-001 z wartością sample w kolumnie Mode. Kolejne uruchomienie aktualizuje ten sam wiersz.

4Połączenie konta Volai

Po założeniu konta Volai można utworzyć klucz w ustawieniach API. W n8n należy dodać dane uwierzytelniające Header Auth. W polu Name trzeba wpisać Authorization, a w polu Value Bearer <API key>. W miejsce <API key> należy wstawić własny klucz. Nazwa wyświetlana jest dowolna. Te dane należy wybrać w Read Volai call event oraz opcjonalnie w Confirm successful write. Aby wysłać potwierdzenie, wystarczy włączyć ten węzeł i ponowić próbę.

5Subskrypcja zakończonych połączeń

Z Volai call completed należy skopiować publiczny adres HTTPS Production URL. Gdy ścieżka webhooka jest już zajęta, trzeba ją wcześniej zmienić. Poniższe polecenie można uruchomić w Bash lub Zsh po podstawieniu własnego adresu. Gdy terminal poprosi o klucz API, należy go wpisać. Odpowiedź należy zachować dla siebie i skopiować z niej wartość 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
)

6Publikacja przepływu pracy

Należy dodać osobne dane Header Auth. W polu Name trzeba wpisać X-Volai-Webhook-Token, a w polu Value wkleić deliveryToken z odpowiedzi API. Po wybraniu tych danych w Volai call completed można opublikować przepływ. Wiersz z live pojawi się po następnym zakończonym połączeniu. Przed zapisem przepływ sprawdza token i pobiera zdarzenie z Volai.

Co Państwo z tym zrobią

Dzienny raport połączeń

Czas zdarzenia w UTC pozwala policzyć zakończone połączenia według dnia.

Obciążenie zespołu

Tabela przestawna ułatwia porównanie liczby i czasu trwania połączeń przychodzących i wychodzących.

Kontrola automatyzacji

Identyfikator połączenia pozwala odnaleźć odpowiadający wpis w historii Volai.

Często zadawane pytania

Co trafia do arkusza?
Wiersz zawiera identyfikator połączenia, czas zdarzenia w UTC, kierunek, status, czas trwania w sekundach oraz tryb sample lub live. Numery telefonów, transkrypcje i nagrania są pomijane.
Co mierzy ten przepływ?
Po udanym zapisie Confirm successful write może wysłać potwierdzenie do Volai. Dla kont utworzonych z tego poradnika za zgodą na pomiar Volai liczy osobno pierwsze potwierdzone uruchomienie próbne i rzeczywiste w ciągu siedmiu dni od rejestracji. Potwierdzenie nie obejmuje komórek arkusza. Dla rzeczywistych połączeń Volai sprawdza przynależność i stan za pomocą identyfikatorów subskrypcji i zdarzenia. Wyłączenie węzła zatrzymuje wysyłanie.
Czy połączenie może pojawić się dwukrotnie?
Kolejne wykonania aktualizują wiersz z tym samym Call ID. Zalecany jest jeden przepływ na kartę. Przy równoczesnym zapisie tego samego identyfikatora Google Sheets może utworzyć dwa wiersze.
Co sprawdzić, jeśli brakuje wiersza?
Błędy próby widać w edytorze n8n. W razie problemu z rzeczywistym połączeniem należy tymczasowo włączyć Save failed production executions w ustawieniach przepływu, powtórzyć błąd i odszukać nieudany krok w historii. Po diagnostyce można ponownie wyłączyć zapisywanie. Przy błędzie zapisu należy sprawdzić uprawnienia Google, ID dokumentu, nazwę karty i nagłówek. Przy błędzie webhooka należy sprawdzić publikację, publiczny URL i token subskrypcji.

Proszę wypróbować od razu

Proszę się zarejestrować, a pierwsze 10 zł salda dostają Państwo od nas.