Коротко: Задача сценария, требующая данных из внешней системы, решается через настраиваемую задачу вызова REST API — указываете адрес запроса, параметры и то, что делать с ответом. Это универсальный механизм для интеграции с любой системой, у которой есть HTTP API, без необходимости писать отдельный код под каждую конкретную интеграцию.
Не каждая задача сценария решается внутри самого диалога — иногда нужно свериться с внешней системой прямо посреди разговора: есть ли товар в наличии, какой статус у заказа клиента, какая сейчас цена. Для этого в сценарии есть задача вызова внешнего API.
Когда нужен вызов внешнего API
- Проверка наличия товара на складе перед подтверждением заказа
- Получение статуса заявки или заказа из внешней системы учёта
- Передача данных клиента в CRM для дальнейшей обработки менеджером
- Запрос актуальной информации, которая меняется чаще, чем можно было бы захардкодить в сценарии
Как это работает в сценарии
Задача REST-вызова настраивается как обычный шаг сценария: указывается адрес запроса, метод (получить данные или отправить), какие параметры передать из уже собранных в диалоге переменных, и куда положить результат ответа для использования в следующих шагах диалога.
Клиент: Есть в наличии кроссовки 42 размера?
Бот: Секунду, проверяю [запрос к складской системе через REST]
Бот: Да, есть в наличии, 3 пары. Оформить заказ?
С точки зрения клиента запрос к внешней системе происходит незаметно — он видит, что бот отвечает с актуальной информацией, полученной извне через REST-вызов за секунду до ответа.
Чем это отличается от готовых интеграций
Готовая интеграция под конкретную систему (например конкретную CRM) избавляет от необходимости настраивать параметры запроса вручную — но такая интеграция существует не под каждую систему, которой пользуется бизнес. REST-вызов — универсальный путь: если у внешней системы вообще есть HTTP API, подключить её к сценарию можно, даже если готового коннектора под неё нет.
Что нужно для настройки
- Адрес API внешней системы и способ авторизации запроса (если требуется)
- Понимание, какие данные из диалога нужно передать в запросе
- Понимание структуры ответа — что именно из него использовать дальше в сценарии
- Тестирование на реальном запросе, прежде чем подключать сценарий к настоящим клиентам
Похожий принцип подключения внешних систем описан и в материале про тестирование сценария перед запуском — REST-вызовы к внешним системам тоже стоит проверять в тестовом канале, прежде чем сценарий начнёт работать с реальными клиентами.
Подключите свою систему к диалоговому сценарию
Опишите задачу текстом — платформа Aigine поможет настроить обращение к внешнему API внутри сценария.
Частые вопросы
Нужен ли программист для настройки REST-вызова?
Настройка происходит через параметры внутри платформы, но потребуется понимание структуры API внешней системы — для сложных случаев привлечение технического специалиста ускоряет процесс.
Можно ли подключить любую внешнюю систему?
Если у системы есть HTTP API — да, REST-вызов не привязан к конкретному вендору или сервису.
Что если внешняя система не отвечает вовремя?
Логика сценария должна предусматривать, что делать в случае задержки или ошибки ответа — это часть настройки задачи, а не то, что решается само собой.
Отличается ли это от готовых интеграций платформы?
Да, готовые интеграции упрощают настройку под конкретную систему, а REST-вызов — универсальный механизм для любой системы с HTTP API, включая те, под которые готового коннектора нет.