что такое вебхук в sendpulse
Как подключить вебхуки для email сервиса
Webhook — это механизм получения уведомлений об определенных событиях. Вы можете настроить оповещения себе в систему о доставляемости писем и активности подписчиков.
Содержание
Как создать вебхук
Чтобы включить отправку автоматических вебхуков по событиям Email сервиса, перейдите в раздел «Настройки аккаунта» на вкладку «API» и нажмите «Создать webhook».
Выберите событие относительно отправки письма, по которому будет срабатывать вебхук в email сервисе:
Далее укажите URL, на который будут отправляться уведомления.
Для каждого события создается отдельный вебхук.
Формат отправляемых данных
При срабатывании вебхука, SendPulse отправляет на указанный URL POST запрос с JSON типом данных.
Данные отсылаются каждую минуту или при достижении лимита в 100 событий.
Данные пересылаются в следующем формате:
Форматы запросов, в зависимости от события
Изменение статуса рассылки:
Пример скрипта, принимающего запрос, на языке PHP:
Как создать авторассылку стартующую по вебхуку контакта
Вебхук контакт позволяет отслеживать открытие рассылок и переходы по ссылкам в отправленных кампаниях.
Как использовать вебхук контакта?
Рассмотрим пример цепочки с вебхуком: вы делаете рассылку, например, к празднику, подписчики открывают письмо. Срабатывает вебхук и подписчикам отправляется сообщение, действия с которым переносят их в другую адресную книгу.
Создайте авторассылку
Выберите Automation 360.
Укажите опции авторассылки.
Опции «Дни отправки» и «Время рассылки» задают приоритетное время отправки писем. Чтобы опция работала правильно, во время создания цепочки писем необходимо установить время отправки в блоках «Email» через N дней.
Например, выберите чекбоксы «Пн», «Ср», «Пт» для опции «Дни отправки», а для опции «Время рассылки» установите 10:00. Затем, во время создания цепочки писем, для всех блоков «Email» укажите время отправки «Через 3 дней». Запустите рассылку. После срабатывания триггера сервис будет ждать 3 дня, а затем отправит письмо в ближайший день, который соответствует условиям, установленным в опциях рассылки. То есть, если триггер сработал в среду в 14:00, то письмо будет отправлено в следующий понедельник в 10:00.
Кликните «Применить», чтобы сохранить настройки.
Укажите «Вебхук контакта» стартом серии.
Привяжите к вебхуку адресную книгу. Она впоследствии будет изменена по итогам срабатывания цепочки.
Перетащите блок «Email» в поле редактора и укажите параметры отправки стартового сообщения.
Выберите шаблон письма, действия с которым определят дальнейшие шаги цепочки.
Если элементы цепочки не помещаются на экране, то поле редактора можно перетащить вверх или вбок.
К блоку «Email» привяжите блок «Условие».
В этом примере условием срабатывания цепочки будет «Открытие письма».
Добавьте блок «Действие».
Выберите «Переместить подписчика» и укажите адресную книгу, в которую будет перенесен подписчик, который совершит нужное действие.
Цепочка авторассылки готова. Cохраните и запустите ее.
Создайте рассылку
Теперь нужно сделать рассылку на ту же адресную книгу, чтобы получатели, которые откроют сообщение, запустили цепочку авторассылки.
Нажмите «Создать рассылку».
Выберите адресную книгу, привязанную ранее к авторассылке и укажите недостающие данные.
Кликните «Далее» и перейдите к выбору шаблона письма.
Если вы выбрали готовый шаблон, добавьте прехедер письма, файлы и снова кликните «Далее».
Если же вы перешли к редактированию, внесите необходимые изменения и кликните «Сохранить и продолжить».
Затем добавьте прехедер письма и файлы и кликните «Далее».
В настройках рассылки выберите чекбокс «Запустить автоматическую рассылку цепочки писем по триггерному событию» и принцип срабатывания вебхука — прочтение письма или переход по ссылкам в сообщении. Выберите авторассылку.
Проверьте введенные параметры рассылки. Установите время отправки и кликните «Начать рассылку».
Подписчики из указанной адресной книги получат письмо, откроют его, запустится цепочка авторассылки.
Тем, кто откроет письмо, будет отправлено новое сообщение, по результатам действий с которым будет изменена указанная адресная книга — в этом случае, такие подписчики перейдут в другую адресную книгу.
Таким же образом можно настроить перенос пользователя в соответствующую адресную книгу после перехода по ссылке, добавление переменной по результату действий подписчика с письмом и так далее.
Как настроить отправку вебхуков к себе в систему
Вебхук — механизм оповещения системы о событиях. Вебхук в Automation 360 — способ оповещения вашей системы о событиях, которые происходят с сообщениями в авторассылке.
Для чего можно использовать отправку вебхука?
С помощью этой функции вы можете, например, после перехода подписчика по ссылке в письме отправить данные о событии в свою систему для дальнейшей работы с этим клиентом. Или же можно использовать отправку вебхука, когда пользователь дошел до какой-то цели.
Например, лиды оставляют заявку у вас на сайте, их контактные данные попадают в вашу CRM-систему и синхронизируются с SendPulse. По этим лидам стартует цепочка Automation 360 для дальнейшего прогрева. Вы хотите прозванивать всех, кто открыл третье письмо из цепочки. Для этого необходимо изменить статус лидов в вашей CRM. Именно с помощью вебхука вы можете это сделать, отправив в вашу систему данные о свершившемся событии для подписчика.
Как включить отправку вебхука в авторассылку
Укажите название вебхука и URL, на который будет отправляться вебхук. В названии вебхука разрешено использовать только цифры и латинские символы.
Настройте отправку ключа в ответ на первый вебхук, чтобы снять лимит на отправку вебхуков. Иначе сервис позволит отправлять максимум один вебхук в час.
Когда цепочка авторассылки готова, кликните «Сохранить и выйти», чтобы сохранить ее, или «Сохранить и запустить», чтобы сохранить рассылку и запустить ее.
Структура вебхука
Вебхук передает такие данные:
В зависимости от того, по чем стартует авторассылка, в вебхуке отправляются переменные из адресной книги или события.
Как отследить отписки и жалобы на спам
Отслеживание отписок пользователей и жалоб на спам можно включить в настройках аккаунта.
Пример вебхука жалобы на спам:
Как передавать данные из бота в Google приложения
Передавайте данные потенциальных клиентов, собранные в цепочках чат-бота Telegram, VKontakte, Facebook Messenger с помощью вебхука, в другие приложения и сервисы, чтобы ими управлять. Рассмотрим, как фильтровать полученные данные контакта в зависимости от переменных. Вы узнаете, как сохранять данные в Google таблицы, создавать событие в Google календаре, создавать CSV файл и сохранять его на Google диск и как отправлять себе email уведомления после любого выполненного блока.
Содержание
Как начать работу
Для реализации задач по передаче данных в другие сервисы мы будем делать связку SendPulse с сервисом, который поддерживает обработку входящих вебхуков и дальнейшую работу с данными из вебхука.
Ниже описан способ связки SendPulse и Integromat. Мы выбрали этот сервис, потому что он включает в себя наибольшее количество приложений и сервисов из разряда CRM, CMS, почтовые сервисы, календари, вложения, карты, списки. Он позволяет фильтровать и редактировать данные. На бесплатном тарифе можно отправлять до 1 000 различных операций, а также он включает в себя нужные нам вебхуки.
Войдите в свою учетную запись в Integromat, нажмите “Create a new scenario”, чтобы начать создавать сценарий.
Вы можете сразу выбрать, какие сервисы подключить, используя поиск, или находить и добавлять их непосредственно в самом конструкторе. Нажмите “Continue” в правом верхнем углу.
Как создать Вебхук
Нажмите на блок с вопросом по центру экрана и выберите блок “Webhooks” — это будет стартовый блок, который запустит цепочку.
Вам необходимо создать сам вебхук, на который будут отправляться данные с вашей цепочки по чат-боту. Из раскрывающегося списка выберите блок “Custom webhook”.
Нажмите “Add”, чтобы создать новый вебхук.
Введите имя для вебхука и нажмите “Save”.
Ваш вебхук создан. Скопируйте ссылку — ее нужно вставить в цепочку вашего чат-бота.
Теперь Integromat ожидает первого полученного вебхука, чтобы определить структуру данных, с которыми ему нужно будет работать.
Как добавить ссылку на вебхук в цепочку
Войдите в личный кабинет SendPulse. Выберите нужного вам бота, откройте режим редактирования созданной цепочки.
Вы можете настроить отправку запроса через блок «Действие: отправить вебхук» (в таком случае передаваемые данные генерируются автоматически) или через «Запрос API» и создать свой формат запроса с переменными.
Через блок «Действие: отправить вебхук»
Добавьте и разместите блок «Действие» сразу за блоком, после которого нужно отправлять вебхук. В ведите название вебхука и URL, скопированный из Integromat.
На нашем примере ниже показана возможная цепочка записи в ветеринарную клинику. Событием в ней является подтверждение заполненных данных.
Через блок «Запрос API»
Добавьте и разместите блок «Запрос API» сразу за блоком, после которого нужно отправлять вебхук. Выберите тип запроса «POST» и введите URL, скопированный из Integromat.
Добавьте тело вашего кастомного запроса в JSON. В запросе можете использовать переменные вашего чат-бота.
Сохраните цепочку, отправьте себе тест в мессенджер и пройдитесь по цепочке до первого вебхука (или прохождение блока «Запрос API»), чтобы запрос отправился в Integromat.
Когда Integromat получит вебхук, в своем аккаунте Integromat вы увидите сообщение “Successfully determined”.
Теперь можно добавлять другие блоки.
Как добавить запись в Google таблицу
Нажмите на “Add another module” возле блока “Webhooks”.
Выберите “Google Sheets”.
Выберите действие “Add a Row”.
Чтобы авторизоваться и подключить свой Google аккаунт, нажмите “Add”.
Выберите, какой аккаунт подключить и дайте разрешение на доступ к вашему Google аккаунту для чтения и записи данных.
Выберите документ и лист, в который необходимо записать данные.
Отметьте, какие переменные в какие ячейки таблицы добавлять. Помимо переменных, вы также можете добавлять свой текст, корректировать его и задавать условия.
Нажмите “Ок” для сохранения параметров.
Сохранение и запуск
Перед сохранением и выходом необходимо проверить, корректно ли все работает. Нажмите “Run once” и запустите цепочку в которой вы настроили вебхук. Если вы все настроили верно, под блоками “Webhook” и “Google Sheet” отобразятся зеленые галочки.
А в нашей Google таблице появилась строка с данными, которые заполняли.
Теперь можно сохранять цепочку. Нажмите на иконку панели управления снизу для сохранения.
Чтобы активировать сценарий, переведите тумблер в положение “ON”.
Выберите частоту срабатывания сценария. Для нашего случая выберем срабатывание каждый раз, как получаем вебхук — “Immediately”.
Дополнительные возможности
В Integromat также доступны разные инструменты для автоматизации процессов. Рассмотрим дополнительные функции и блоки.
Как добавить фильтр данных по переменным
Integromat позволяет фильтровать все данные. Вы можете добавить фильтр по всем переменным, которые получаете по вебхуку и распределять данные по разным таблицам.
Чтобы распределять данные, вам понадобится инструмент «Router». Вы найдете его в панели инструментов снизу. Выберите этот инструмент и соедините его с блоком «Webhooks».
После блока “Router” добавьте блоки с Google таблицей согласно инструкции выше. Теперь нажмите на линию между “Router” и таблицей для установления фильтра.
Введите название фильтра, затем выберите переменную, по значению которой будут фильтроваться данные, и оператор условия.
Введите значение переменной, к которой будут применяться условия.
Вы можете добавить несколько условий, объединяя их операторами “и” и “или”. В нашем примере мы фильтруем по вопросам, с которыми обратился клиент, чтобы добавить его в таблицу к соответствующему ветврачу.
Также примером может быть фильтр уже по определенному врачу, если вы в цепочке настроили добавление этой переменной. Можно также установить фильтр по породе, по определенному электронному адресу, если необходимо отследить конкретного клиента.
Как добавить событие в Google календарь
Так же как добавить запись в таблицу, вы можете добавить событие в календарь. К примеру, клиент записался на определенное число и вам необходимо добавить запись на эту дату.
Добавьте блок “Google Calendar”. Выберите действие “Create an event”. Введите название события — можете добавлять переменные в него.
При заполнении даты события важно добавить функцию форматирования даты, чтобы запись отработала. В полях “Start date” и “End date” перейдите на вкладку “Date and time”, выберите функцию “formatDate”.
Затем выберите переменную, которая у вас отвечает за нужную дату, и переместите ее внутрь скобок, как показано на скриншоте.
Нажмите “Ок” и ваш сценарий записи события в календарь готов.
Как отправить уведомление с данными себе на почту
Вы можете добавить блок “Email”, чтобы отправить себе письмо после любого события. К примеру, каждый раз, когда добавляется новая запись в Google таблицу, определенное количество строк или определенная переменная.
Выберите блок “Email” и действие “Send an email” вслед за блоком, после исполнения которого нужно отправить письмо.
Заполните нужные поля: кому отправить письмо, с какой темой и шаблоном сообщения. Вы также можете использовать переменные для добавления в текст сообщения.
Также вы можете добавлять вложения в письмо, нажав на “Attachments” и выбрав файл, который был сохранен ранее в цепочке.
Как просмотреть историю работы сценария
Перейдите в нужный вам сценарий. Вам будет доступна диаграмма всех блоков с историей выполнения блоков. Кликните по нужному блоку, чтобы просмотреть информацию по нему.
Вам будет доступна вся информация по блоку: какие значения принял и передал дальше.
Если какой-то из блоков не выполнился, он подсветится красным и при нажатии отобразится причина ошибки и подсказка, как ее исправить. Обратите внимание, что до устранения ошибки весь сценарий может приостановится и не выполнятся; операции будут становиться в очередь.
Если возникнут вопросы по настройке или сбоям сценария, можете обратится в службу поддержки Integromat.
На этом возможности сервиса не заканчиваются, вы можете придумать еще больше разнообразных связок и способов передачи и использования информации с помощью вебхуков.
Настраивайте интеграцию, если планируете создавать бота для записи к ветеринару, записи к мастеру в салон красоты. Если вам нужно оставить отзыв по событию в Google документы, записать номер телефона, чтобы передать в документы отделу продаж, заказать блюда в службе доставки, чтобы можно было планировать закупку.
Как настроить отправку вебхука в чат-ботах
Вы можете настроить отправку вебхука по сценарию цепочки вашего чат-бота или активировать глобальные вебхуки по различным событиям вашего чат-бота и получать информацию в своей системе. Рассмотрим, что такое вебхуки и где они используются, а также как их активировать и какая структура получаемых данных.
Содержание
Где используются вебхуки
Вебхук — механизм оповещения о событиях посредством отправки HTTP запроса на URL, где находится обработчик.
С помощью этой интеграции вы сможете настроить отправку данных о событии в цепочке бота в свою систему для дальнейшей работы с этим клиентом.
Представьте сценарий: вы создали последовательный опрос для пользователя, чтобы он мог зарегистрироваться на мероприятие в мессенджере. Вам нужно узнать о новом зарегистрированном на определенную лекцию, чтобы связаться с ним или изменить статус в вашей CRM.
Именно с помощью добавленного вебхука вы можете это сделать. Как только пользователь проходит отслеживаемый блок настроенной цепочки, в вашу систему отправляются данные о свершившемся событии.
Как включить отправку вебхука в цепочке
Вы можете добавить вебхук в конструкторе цепочки и отслеживать определенную информацию по мере прохождения нужных вам блоков цепочки:
Чтобы вставить отправку вебхука, добавьте блок «Действие» после отслеживаемого блока.
Выберите опцию «Отправить вебхук». Введите название отправляемого вебхука и URL, куда передавать данные.
Как включить глобальные вебхуки
Вы можете также подключить вебхуки, которые будут отправляться по событиям всего чат-бота.
Перейдите в настройки бота, во вкладку «Вебхуки». Активируйте настройку и вставьте URL, на который нужно отправлять данные.
Выберите события, по которым нужно отправлять оповещения, и нажмите «Сохранить» для применения настроек.
Вы можете выбрать следующие события:
«Подписка на бота» — отправляется с информацией о пользователей, когда пользователь подписался на выбранного чат-бота;
«Входящие сообщения» — отправляется при каждом новом входящем сообщении от пользователя в чате с информацией о пользователе и текстом сообщения.
«Исходящие сообщения» — отправляется при каждом отправленном сообщении пользователю с информацией о пользовате и текстом сообщении.
«Открытие чата» — отправляется после прохождения пользователем цепочки с действием с информацией о пользователе.
«Старт пользовательской цепочки» — отправляется при запуске триггерных цепочек с информацией о пользователе и цепочке.
«Переход по ссылке» — отправляется при проходе пользователем по ссылкам в кнопках и тексте с информацией о ссылке, отправляющем блоке и пользователе.
«Отписка от бота» — отправляется при отписке пользователя от бота с информацией о пользователе и боте.
«Заблокировал бота» — отправляется при блокировке пользователем сообщений от бота с информацией о пользователе и боте.
Структура вебхука
Вебхук передает такие данные:
Пример вебхука отправляемого из цепочки чат-бота:
Пример вебхука для «Подписка на бота»:
Пример вебхука для «Входящие сообщения»:
Пример вебхука для «Исходящие сообщения»:
Пример вебхука для «Открытие чата»:
Пример вебхука для «Старт пользовательской цепочки»:
Пример вебхука для «Переход по ссылке»:
Пример вебхука для «Отписка от бота»:
Пример вебхука для «Заблокировал бота»:
Изменения формата данных вебхука
Данные вебхука приходят с типом application/json.