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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Использование переменных при добавлении строки

При настройке действия "Добавить строку" можно передавать в Google Sheets данные профиля подписчика, значения переменных и произвольный текст.

Формат записи зависит от выбранного типа данных.

Текст с переменными

Позволяет передавать произвольный текст с подстановкой значений подписчика. Для этого используются метки в формате {%имя%}.

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

При подстановке значения поиск выполняется в следующем порядке:

1. Поле профиля подписчика.
2. Переменная подписчика.
3. Глобальная переменная.

Если существуют поле профиля и переменная подписчика с одинаковым именем, используется значение поля профиля.

Например, {%first_name%} подставляет имя из профиля подписчика.

Доступные поля профиля:

vk_user_id, first_name, last_name, bdate, sex, group_id, domain, country_id, city_id, photo, relation, vk_group_id, unixtime, date.

Для подписчиков Telegram идентификатор пользователя также хранится в поле vk_user_id, а короткий адрес - в username.

Пример использования

Для формирования ссылки на страницу пользователя ВКонтакте можно указать:

https://vk.ru/id{%vk_user_id%}

При выполнении шага вместо {%vk_user_id%} будет подставлен идентификатор пользователя.

Важно использовать правильные имена полей. Например, userid не является полем профиля. При использовании https://vk.ru/id{%userid%} в таблицу будет записано https://vk.ru/id.

Обратите внимание: в поле «Текст с переменными» подстановка работает только для формата {%имя%}. Записи %имя% и [%имя%] остаются обычным текстом.

Например, https://vk.ru/id%vk_user_id% будет записано в таблицу без изменений.

Переменная подписчика и глобальная переменная

При выборе типов данных «Переменная подписчика» или «Глобальная переменная» необходимо указать только имя переменной, без дополнительных символов и скобок.

Например:

• email - имя переменной подписчика.
• price - имя глобальной переменной.

Не следует использовать записи {%email%} или [%price%]. В этих полях они воспринимаются как имена целиком. Если переменных с такими именами нет, в таблицу будет записано null.

Тег

При выборе типа данных "Тег" указанное значение записывается в таблицу без изменений.

Особенности подстановки значений

Если переменная в поле "Текст с переменными" не найдена, соответствующая метка удаляется, а остальной текст сохраняется.

Если после подстановки ячейка остаётся пустой, в неё записывается null.

Аналогичное значение записывается при отсутствии или пустом значении поля профиля, переменной подписчика либо глобальной переменной.

Числовое значение 0 сохраняется как ноль.

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

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

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

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

Записать в переменную - позволяет выбрать переменную, в которую будут записаны данные из Google Sheets.

В зависимости от типа переменной используется следующий формат:

• Переменная подписчика - {%имя%}.
• Глобальная переменная - [%имя%].

Для выбора переменной можно воспользоваться кнопкой "Переменные". При выборе переменной её имя автоматически подставляется в нужном формате.

Если указанная переменная ещё не существует, она будет создана при сохранении шага.

Если выбранная ячейка Google Sheets пустая, в переменную записывается пустое значение.

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

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

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

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

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

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

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

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

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

Ограничения

1. Максимальное количество ячеек на всех страницах: 10 млн.