Как передать персонализированную информацию из строки 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
или