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

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

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

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

Также SendPulse выпустил прямую интеграцию с Google Sheets. Подробнее.

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

Войдите в свою учетную запись в 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.

Обновлено: 21.06.2024