Як отримати дані з таблиці Google у чат-ботах

Якщо ви використовуєте Google таблиці як сховище даних про контакти, замовлення або складські відомості про товари, вам може знадобитися передача інформації з них у чат-боти, щоб користувачі отримували актуальні повідомлення.

У статті розглянемо, як налаштувати отримання даних з таблиць Google до блоку Запит API у ланцюжку чат-бота за допомогою інтеграції з Google Sheets API та SendPulse.

SendPulse також пропонує пряму інтеграцію з Google Sheets. Дізнайтеся більше.

Налаштування облікових записів та доступу

Щоб використовувати таблиці Google Sheets для передачі даних, Вам знадобиться налаштувати проєкт у Google Cloud Console та відкрити доступ до документа з базою даних.

Підготовка до підключення

Зайдіть в консоль Google Cloud під своїм обліковим записом Google, створіть новий проєкт або виберіть наявний зі списку. Задайте в проєкті назву та батьківську організацію, якщо потрібно.

Під'єднайте Google Sheets API

У розділі API та сервіси (APIs & services) виберіть Підключені API та сервіси (Enabled APIs & services). Натисніть кнопку Увімкнути API та сервіси (Enable APIs & services) та перейдіть до бібліотеки інтеграцій.

Знайдіть у каталозі Google Sheets API та натисніть Включити (Enable).

Створіть ключ API

Перейдіть до розділу API та сервіси (APIs & services) > Облікові дані (Credentials) та натисніть Створити облікові дані (Create credentials). У списку виберіть Ключ API (API key).

Ви отримаєте повідомлення про створення ключа. Ви можете скопіювати його одразу або повернутися пізніше.

Ми радимо одразу обмежити використання ключа лише для інтеграції з таблицями. Для цього натисніть на три точки навпроти імені ключа, відкрийте Редагувати (Edit) і в пункті Обмеження API (API restrictions) вкажіть Google Sheets API.

Налаштуйте доступ до файлу з таблицею

Відкрийте доступ до файлу на перегляд за посиланням або додайте сервісний обліковий запис вашого проєкту Google Cloud до списку користувачів, які можуть переглядати документ з таблицями.

Налаштування ланцюжка чат-бота

Додайте блок Запит API

Щоб використовувати значення, зібрані в таблиці, вам потрібно сформувати URL-адресу наступного виду:

https://sheets.googleapis.com/v4/spreadsheets/{sheet_id}/values/{sheet_name}!{range}?key={api_key}

Параметри, які використовуються в адресі:

Додайте в ланцюжок блок Запит API (API request), виберіть GET метод для запиту і вставте в поле посилання сформовану URL-адресу.

Ви можете протестувати отримання запиту за допомогою кнопки Перевірити запит (Test request), а потім отримані дані використовувати для Налаштування відповідності (Mapping seyyings).

Для цього натисніть кнопку Додати (Add) та в Полі відповіді (Responce field) виберіть значення з отриманої відповіді на запит: у полі воно буде виведене у вигляді посилання у форматі JSON Path {{$['somekey']['nestedkey']}}.

У сусідньому полі виберіть змінну з аудиторії чат-бота, куди потрібно імпортувати значення, щоб використовувати їх у наступних елементах.

Збережіть результат і налаштуйте наступні блоки

Також отримані дані можна використовувати у повідомленнях як посилання JSON Path. Ви можете скопіювати посилання в поле відповіді, не зберігаючи.

Але потрібно враховувати, що передача значення JSON Path можлива тільки в блоці, наступному відразу після Запиту API, тому якщо ви хочете використовувати дані кілька разів, збережіть їх.

Такі дані можна використовувати в блоках Фільтр (Filter) та Повідомлення (Message), так само як і інші змінні.

Читайте також: Як передавати дані з бота в Google додатки (на прикладі інтеграції з Make).

Оновлено: 27.06.2024