Как передать персонализированную информацию из строки Google Sheets в чат-бот

Сервис Integromat сменил адрес сайта, дизайн и название на Make. Возможности интеграций остались такими же, но дизайн может отличаться от скриншотов, приведенных в статье.

Вы можете интегрировать чат-боты SendPulse с другими сервисами для запроса информации через Make. В этой статье, мы разберемся, как посмотреть информацию (числовую или текстовую) из определенной строки в Google Sheets.

C помощью такого сценария вы можете проверять персональную информацию по клиенту или выдавать ее пользователю. Идентифицировать пользователя (чьи данные записаны на одной строке и одна из колонок идентифицирующая) вы можете по любым своим данным, которые есть в чат-боте и Google sheets — ID подписчика, контактные данные и прочее.

В статье рассматривается интеграция с таблицами Google с помощью Make, но вы также можете получать данные из таблиц напрямую, используя только инструменты Google Sheets API и SendPulse. Читайте в статье: «Как получить данные из таблицы Google в чат-ботах».

Как начать работу

Войдите в свою учетную запись в Make, нажмите «+ Create a new scenario», чтобы начать создавать сценарий.

Вы можете сразу выбрать, какие сервисы подключить (в данном случае это Webhooks и Google Sheets), используя поиск, или находить и добавлять их непосредственно в самом конструкторе. Нажмите «Continue» в правом верхнем углу.

Как создать вебхук

Нажмите на блок с вопросом по центру экрана и выберите блок «Webhooks» — это будет стартовый блок, который запустит цепочку.

Вам необходимо создать сам вебхук, на который будут отправляться данные с вашей цепочки из чат-бота. Из раскрывающегося списка выберите блок «Custom webhook».

Нажмите «Add», чтобы создать новый вебхук.

Введите имя для вебхука и нажмите «Save».

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

Теперь Make ожидает первого полученного вебхука, чтобы определить структуру данных, с которыми ему нужно будет работать.

Как добавить ссылку на вебхук в цепочку чат-бота

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

Добавьте и разместите блок «Запрос API» сразу за блоком, после которого нужно отправлять вебхук. Выберите тип запроса «GET» и введите URL, скопированный из Make.

Вы можете запрашивать персонализированное значение, например, ID пользователя, — для этого добавьте параметр в URL запроса в виде contact_id={{contact_id}} в конец URL. Также вы можете передавать контактные данные подписчика с помощью переменных {{email}} и {{phone}}.

Нажмите «Проверить запрос», чтобы запрос отправился в Make и распознал полученные данные.

Когда Make получит вебхук, в блоке «Webhooks» вы увидите сообщение «Successfully determined».

Теперь можно добавлять другие блоки.

Как получить информацию из Google таблицы

Нажмите на «Add another module» возле блока «Webhooks», выберите «Google Sheets» и действие «Search Rows».

Подключите свой Google Account, выберите таблицу и лист.

Чтобы прочитать все строки таблицы, где столбец А равен переданному емейлу пользователя, в секции «Filter» в первом поле выберите ваш столбец с емейлами в Google Sheets и во втором поле выберите полученный параметр «Email» из вебхука (или «6.contact.id», если передавали ID подписчика).

Если у вас нет переменной вида 6.Email (где 6 — это номер блока в Make, в котором вы получили эту переменную из чат-бота), нажмите «Run once» в нижнем левом углу и проверьте запрос в блоке или запустите цепочку в чат-боте, в котором вы настроили вебхук. После первого прохождения цепочки переменная появится в Make.

Нажмите «ОК».

Как передать запись Google таблицы в чат-бот

Нажмите на «Add another module» рядом с блоком таблиц. Выберите «Webhooks» > «Webhook response».

В поле «Body» выберите значения из таблицы, которые будут возвращаться в чат-бот, и запишите их в формате JSON:

{"название переменной":"столбец из гугл таблицы", "название переменной":"столбец из гугл таблицы"}

Нажмите «ОK» для сохранения параметров.

Вернитесь в редактирование цепочки вашего чат-бота в SendPulse к блоку с вебхуком.

Вы можете записать полученное значение в переменную, чтобы использовать фильтр и добавлять его в сообщение, как переменную. Или вы можете отобразить данные пользователю один раз без записи, используя запись вида {{$[‘переменная’]}}. Читайте подробнее «Использование данных в виде выражения JSON Path».

Добавьте и разместите блок «Сообщение» сразу за блоком «Запрос API» и добавьте к нему переменную или выражение JSON path.

Сохранение и запуск

Перед сохранением и выходом необходимо проверить, корректно ли все работает.

Нажмите «Run once» и запустите цепочку в которой вы настроили вебхук. Если вы все настроили верно, под блоками «Webhook» и «Google Sheets» отобразятся зеленые галочки.

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

Чтобы активировать сценарий, переведите тумблер в положение «ON».

Как просмотреть историю работы сценария

Перейдите в нужный вам сценарий. В списке «Last runs» или «History» нажмите «Details» по нужной операции. Вам откроется диаграмма всех блоков с историей выполнения блоков.

Кликните по нужному блоку, чтобы просмотреть информацию по нему. Вам будет доступна вся информация по блоку: какие значения принял и передал дальше.

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

Если возникнут вопросы по настройке или сбоям сценария, можете обратится в службу поддержки Make.

Обновлено: 15.03.2023