Интеграция на сайте
Для чего нужен этот тип
Выбирайте «Интеграцию на сайте», когда основной интерфейс и бизнес-логика находятся во внешнем сервисе, а пользователь должен подключить к нему свой проект Senler AI. Например, это может быть CRM, платёжный сервис, аналитика или личный кабинет на сайте разработчика.
Подключение начинается на внешнем сайте. Пользователь подтверждает запрошенные права в Senler AI, после чего сервер интеграции получает OAuth-токены и вызывает API от имени подключённого проекта.
Что получает пользователь
- карточку приложения в каталоге плагинов с переходом на сайт разработчика;
- понятный OAuth-экран с перечнем запрошенных разрешений;
- ссылку на документацию приложения, если разработчик её опубликовал.
Этот тип не добавляет агентам инструменты и не показывает встроенную страницу внутри кабинета. Для таких возможностей используйте тип «Инструмент». Если нужно установить готовый набор ресурсов в проект, используйте «Готовое решение».
Что настраивает разработчик
- Указывает название, описание, аватар, сайт и публичную документацию в общих настройках приложения.
- Сохраняет разрешённые Redirect URI, выбирает минимально необходимые права и безопасно хранит Client Secret. Подробности приведены в OAuth-настройках.
- На сервере обменивает
authorization_codeна access token, обновляет его черезrefresh_tokenи не передаёт Client Secret в браузер. - При необходимости объявляет события для агентов, добавляет вебхуки и документацию своего сервиса.
Доступ к проекту
Создание приложения и знание Client ID или Client Secret не дают доступа к данным проекта. Доступ появляется только после явного OAuth-подтверждения пользователя и ограничивается выбранными разрешениями. Удаление подключения или отзыв токена прекращает доступ внешнего сервиса.
Перед публикацией
Проверьте сайт разработчика, рабочий HTTPS Redirect URI, тексты на русском и английском языках, минимальный набор разрешений, сценарий отзыва доступа и пользовательскую документацию. После этого отправьте приложение на модерацию из раздела публикации.