Создание вебхука
Чтобы получить ссылку на вебхук, необходимо сперва его создать, заполнив необходимые поля. После создания вебхука - откройте его снова. Там появится ссылка. которую вы уже сможете использовать для размещения на сторонних ресурсах, которые поддерживают отправку внешних запросов.
Перед настройкой вебхука прочитайте инструкции по отправке внешних запросов на сайте, где будете размещать ссылку.
Параметры вебхука:
Тип контакта - выберите тип контакта, если вам необходимо идентифицировать пользователя. Пользователь будет автоматически создан с этим типом контакта, если такого нет в базе.
Источник данных - выберите источник данных, поддерживаемый сервисом, который будет отправлять вам запрос Это формат данных, в котором будут содержаться данные, передаваемые внешним сервисом: VK/TG id, телефон и т.д.
Путь к значению контакта - по сути - это переменная внешнего сервиса, в которой он будет передавать контакт.
Задать интеграцию - ну и крайне рекомендованное поле - которое позволяет сразу задать интеграцию новому пользователю, привязав его к нему. Например, можно выбрать Telegram-бота, от которого вы будете слать сообщения.
Настроили, создали, скопировали ссылку, вставили её в нужный сайт - отлично!
Теперь идем настраивать схему!
Настраиваем реакцию на вебхук
Нам понадобится событие "Входящий вебхук"
С условием "Вебхук, который запустил событие"
Выбираем созданный ранее вебхук из списка.
Готово!
Осталось теперь вывести результат и посмотреть что внутри.
{var:object} - содержимое события
{var:platform} - информация платформы
{var:request} - все полезные данные вебхука
Добавьте эти переменные в сообщение после события, сохраните схему и запустите нужное действие на внешнем сайте.
Не забудьте предварительно переключить интеграцию и выбрать, куда бот будет отправлять данные:
После того, как получите сообщение с кучей данных в json-формате, сформируйте нужные переменные, с которыми будете работать в дальнейшем.
Возьмем пример вебхука.
Содержимое {var:request} выдаст нам вот такой код:
Сделать его красивым можно в сервисе: https://jsonformatter.org
{
"url": "http://callback/api/v1/hook/app/46c382d46a4438e0c068e5497c62bba5?test=value",
"is_secure": false,
"domain": "callback",
"port": null,
"path": "/api/v1/hook/app/46c382d46a4438e0c068e5497c62bba5",
"query": {
"test": "value"
},
"form": {},
"json": null
}
Нам нужно достать value.
Значит переменная будет выглядеть так: {var:request.query.test}