Интеграция с Google Sheets

Интеграция позволяет вносить данные подписчика в виде записей в google-таблицы на любом из шагов чат-бота. Если раньше была необходимость в подключении сторонних сервисов, написании кода, то сейчас это делается в несколько кликов.

Создание интеграции

Создание интеграции доступно в чат-боте в виде отдельного шага. Чтобы его создать, необходимо нажать на значок в виде 3-х кубов, либо вызвать контекстное меню в любом месте поля нажатием на правую кнопку мыши, и выбрать Google Sheets.

После того, как вы создали шаг с интеграцией, его необходимо присоединить к вашей схеме точно таким же способом, как и любые другие шаги. В качестве примера - это будет кнопка.

Настройки шага с интеграцией

Настроить - все необходимые настройки интеграции выполняются через эту кнопку.

Обработать ответ - базовая настройка для всех интеграций. Нужна для обработки ответа вебхука и для последующей работы с этим самым ответом.

Ожидание выполнения вебхука - своего рода "проверка" того, верно ли настроена интеграция. Если при включенной опции после выполнения шага с интеграцией пользователь продолжает движение по чат-боту, то интеграция настроена верно. А при выключенной, наоборот, подписчик будет двигаться по боту дальше независимо от выполнения шага с интеграцией.

Подключение аккаунта Google

Перед настройкой интеграции необходимо подключить аккаунт Google, где у вас будет находиться непосредственно сама таблица. Для это нужно нажать на кнопку Настроить. У вас появится окно настроек самой интеграции. Выглядит оно следующим образом:

В появившемся окне нужно нажать на поле с надписью Вход не выполнен и далее Войти. У вас появится форма авторизации, где нужно нажать на Sign in with Google:

Следующим шагом необходимо выбрать тот аккаунт, где расположена ваша таблица:

Затем предоставляете доступ нашему приложению Liidex к вашему аккаунту Google (не переживайте, интеграция не получит полный доступ к вашему аккаунту, а лишь возьмет перечисленные на скрине данные):

После этого выдаете необходимые для работы разрешения:

Если авторизация прошла успешно, то в окне настройки интеграции вместо "Вход не выполнен" будет указана ваша почта Google:

Настройка интеграции

Теперь, находясь в самой таблице, нужно скопировать ссылку на вашу таблицу из адресной строки браузера и вставить ее в соответствующее поле, а также не забыть выбрать лист, в который планируете записывать данные ваших подписчиков, и указать ячейку, откуда будет начинаться запись:

В Действиях можно выбрать либо добавление новых строк с данными подписчиков в таблицу, где каждая последующая запись начинается с новой строки, либо получение данных из таблицы с возможностью записи их в переменную.

А теперь по порядку, и начнем с действия - Добавить строку.

Столбцы и данные - в полях ниже можно указать, какие именно данные передавать в таблицу.

Список данных:

Идентификатор пользователя ВКонтакте
Имя
Фамилия
Дата рождения
Пол (1 - женский, 2 - мужской)
Идентификатор сообщества в Senler
Короткий адрес страницы (domain)
Идентификатор страны
Идентификатор города
Иконка пользователя (в виде ссылки из поля photo)
Семейное положение
Идентификатор сообщества ВКонтакте
Дата первой подписки на сообщения (unixtime)
Дата первой подписки на сообщения
Текст с переменными
Тег
Переменная подписчика
Глобальная переменная
Добавление лида на шаг формат.гугл - Дата
Добавление лида на шаг формат.гугл- Время
Добавление лида на шаг формат.гугл - Дата Время
Добавление лида на шаг формат.строка - Дата
Добавление лида на шаг формат.строка - Время
Добавление лида на шаг формат.строка - Дата Время

Указать столбец уникальности - при включении этой опции, сначала происходит поиск по этому столбцу: если найдена строка с аналогичным значением, то остальные значения в найденной строке обновляются на новые. Если совпадений нет, то добавляется новая строка.

На скрине ниже как раз это продемонстрировано. В качестве столбца уникальности выбран столбец А. В нем есть совпадение по ID пользователя, поэтому строка была перезаписана, о чем свидетельствует поздние дата и время.

Далее рассмотрим подробно следующее действие - Получение данных в переменную.

Записать в переменную - здесь нужно указать, в какую конкретно переменную хотите записать данные из таблицы. В качестве выбора представлены 2 варианта с примерами синтаксиса - переменная подписчика и глобальная переменная.

Метод получения - здесь необходимо выбрать, каким именно способом интеграция будет получать данные для записи из таблицы.

На данный момент доступны 3 метода:

Случайно
По порядку
Из ячейки

Рассмотрим каждый из них по отдельности.

Случайно - это когда интеграция берет любое значение из диапазона для чтения, проверяет его на предмет уникальности по проверочному диапазону, и если оно уникально - записывает в переменную, а также добавляет в столбец проверочного диапазона. В случае, если значение не уникально, то интеграция возвращается к первому столбцу и снова случайным образом выбирает новое. И так по кругу, пока столбец с диапазоном для чтения не иссякнет (справедливо в обоих случаях).

На практике рабочая таблица с данным методом может выглядеть вот так (пример применения - выдача уникальных промокодов):

Обратите внимание на скрин выше. В нем есть 2 столбца:

Столбец А - это диапазон для чтения, т.е. набор значений, из которых интеграция будет выбирать одно и отдавать пользователю путем записи в переменную.

Столбец B - а это проверочный диапазон. Иными словами, в этот столбец попадают те значения, что ранее уже были записаны в переменные и выданы пользователю. Наличие данных в нем гарантирует то, что они повторно не будут выданы. В этом и есть основной смысл проверочного диапазона.

По порядку - все описанное для метода "Случайно" можно применить и к этому, за исключением того, что интеграция в столбце диапазона для чтения будет брать значение уже не случайным образом, а строго по порядку, один за одним.

Из ячейки - а этот метод кардинально отличается от первых двух. Здесь уже нет проверочного диапазона и данные берутся из конкретно указанной ячейки. Например - цена того или иного товара.