Что такое webhook-ссылка?
Webhook-ссылка — это один из способов запуска ботов через Orchestrator SaaS. Такая ссылка позволяет запускать workflow по HTTP-запросу.
Для чего это нужно?
Один из возможных сценариев использования webhook-ссылок — это запуск workflow из программ и приложений, которые не связаны с ElectroNeek, но в которые необходимо интегрировать бота ElectroNeek. Например, в вашей компании уже есть написанная программа на каком-либо языке программирования, которая решает определенную бизнес-задачу. Если вы хотите расширить функционал этой программы интеграцией с ботом ElectroNeek, то использование webhook-ссылки как раз поможет это сделать.
Как это работает?
Сгенерировать webhook-ссылку можно на странице управления ботом в Orchestrator.
- Опубликуйте созданного бота в Orchestrator SaaS.
- Убедитесь, что состояние бота отображается как «Готов».
- Найдите строку «Webhook ссылка» в параметрах бота. Нажмите на переключатель, чтобы создать такую ссылку.
- Нажмите на кнопку «Ссылка», чтобы скопировать webhook ссылку в буфер обмена.
Чтобы скопировать ссылку в буфер обмена, нажмите на кнопку «Ссылка».
Передача параметров в HTTP-запрос
Существует возможность передать какие-либо параметры «внутрь» бота при использовании webhook-ссылки. В Studio Pro существует переменная webhook_data
. Именно в нее будут переданы параметры, которые вы зададите.
Для передачи нужных параметров в переменную можно использовать какой-нибудь webhook-агент, например, Postman.
Пример параметров, передаваемых в бота через Postman:
Выберите опцию «POST», скопируйте webhook-ссылку и вставьте ее в строку рядом. В разделе «Body» запишите параметры, которые вам необходимо передать в переменную.
Так может выглядеть workflow, в который будут передаваться параметры:
Обратите внимание, что параметр «Значение» действия «Ввод в приложение» использует опцию «Вычислить значение», а в поле ввода прописано значение webhook_data
. Это необходимо для того, чтобы параметры переданные в webhook_data
использовались данным действием.
Таким образом, результат действий этого бота будет выглядеть так: