Nodul LogoNodul

Связь со сценариями Nodul

Нативная интеграция в разработке

Полноценный нативный доступ App Builder к авторизациям, интеграциям и узлам Nodul находится в разработке.

Пока нативной интеграции нет, приложение из App Builder можно связать с любым сценарием, узлом или ИИ-агентом Nodul через обычный HTTP-запрос на вебхук.

Как это работает

В конструкторе сценариев соберите нужную цепочку узлов между двумя базовыми узлами:

  1. В начало поставьте Триггер по вебхуку: он принимает HTTP-запрос из кода вашего приложения.
  2. В середину добавьте нужные шаги: интеграцию с внешним сервисом или ИИ-агента с инструментами.
  3. В конец поставьте Ответ вебхуку: он возвращает результат обратно в приложение, чтобы код продолжил работу.

Передайте агенту в чате App Builder URL вебхука и опишите формат запроса и ответа.

Вариант 1: обычный эндпоинт для интеграции

Используйте эту схему, когда приложению нужно выполнить конкретное действие в подключённом сервисе (например, создать контакт или сделку в CRM, отправить письмо, записать строку).

Код приложения отправляет HTTP-запрос с данными на вебхук, сценарий вызывает нужный узел (на примере ниже: Создать контакт в amoCRM) и возвращает через Ответ вебхуку подтверждение или данные созданной записи.

Сценарий для вызова интеграции: Триггер по вебхуку, создание контакта в amoCRM и Ответ вебхуку

Вариант 2: вызов ИИ-агента внутри Nodul

Используйте эту схему, когда запрос от пользователя должен обработать ИИ-агент с доступом к вашим инструментам и базам знаний в Nodul.

Код приложения отправляет HTTP-запрос на вебхук, AI агент внутри сценария сам решает, какие инструменты вызвать (на примере ниже: Создать контакт в amoCRM и поиск по базе знаний RAG Search), а итоговый ответ уходит обратно в приложение через Ответ вебхуку.

Сценарий с ИИ-агентом: Триггер по вебхуку, AI агент с amoCRM и RAG Search, Ответ вебхуку

Прямые запросы без сценария

Если сценарий Nodul не нужен, приложение может обращаться к сторонним API напрямую из кода: Интеграция с внешними сервисами. Для хранения данных также доступны локальная база SQLite и прямое подключение Nodul Таблиц по API-токену: Хранение данных.