Коннекторы и сервисы

Коннектор это зарегистрированный внешний сервис, который агент может вызвать от вашего имени: маркетплейс, CRM, банк, служба доставки, мессенджер, аналитическая платформа и так далее. В каталоге 110+ коннекторов в 18 категориях, и каждый вызывается через одни и те же три инструмента: получить каталог, прочитать паспорт сервиса, выполнить вызов.

Как вызываются коннекторы

Достучаться до коннекторов можно двумя способами:

  • Агентом: в чате, в задаче или через API агентов по хэндлу агента; модель сама выбирает нужный коннектор и вызов.
  • По ключу агента, без агента: REST /v1/connectors на платформе разработчика и MCP-сервер с одним телом вызова, для своего кода или внешнего агента. См. Вызов по ключу.

Подключение аккаунта

Прежде чем коннектор вернёт реальные данные, организация подключает к нему кабинет в разделе Интеграции приложения: форма спрашивает ровно те поля, которые объявляет коннектор, сервис с OAuth открывает окно провайдера, сервис с device-code показывает код для подтверждения. Когда вызову агента нужен ещё не подключённый кабинет, агент показывает карточку подключения прямо в чате. Второй кабинет того же сервиса добавляется там же под своим именем и адресуется суффиксом к сервису (ozon:2). Через API кабинеты не подключаются: ключ пользуется подключёнными, а отказ по ключу несёт ссылку для человека, см. Вызов по ключу.

Потоки авторизации

Каждый сервис объявляет один поток авторизации из credentials, device_code, popup_oauth, mcp_oauth. Каталог использует первые три, mcp_oauth есть только у MCP-сервера, который добавил пользователь:

Поток авторизацииОписание
credentialsКлюч API, токен или логин и пароль, которые вставляют в форму подключения. Так подключается большая часть каталога.
device_codeПользователь подтверждает подключение на сайте провайдера коротким кодом, а платформа забирает токен (сервисы Яндекса).
popup_oauthOAuth во всплывающем окне: пользователь разрешает доступ, токен сохраняется и обновляется автоматически (Google, GitHub, HeadHunter, Ozon, Т-Банк, приложение Битрикс24).
mcp_oauthТолько для MCP-сервера, который добавил пользователь: OAuth этого сервера с динамической регистрацией клиента и PKCE во всплывающем окне.

Транспорт (то, как секрет прикрепляется к каждому запросу: bearer-заголовок, basic, query-токен, HMAC конкретного вендора) это отдельная ось, ею занимается сам коннектор.

Хранение учётных данных

Подключённые учётные данные шифруются при хранении. Кабинет принадлежит подключившему: видимость private оставляет его владельцу, org открывает всей организации, и только такие кабинеты видит ключ агента. При вызове коннектора платформа сама подставляет секрет адресуемого кабинета в запрос.

Секреты коннекторов (ключи API, токены, пароли) в окружение песочницы не попадают: код обращается к коннектору через хост, у которого и лежат креды. В os.environ есть только несекретные реквизиты подключения, собственные переменные пользователя и переменные, которые называет Environment.

Кабинетом (видимость, сохранённые поля, адрес вебхука, отключение) управляют на карточке коннектора в разделе Интеграции. Сохранённое значение там видит только тот, кто управляет подключением, и каждый просмотр пишется в аудит.

Каталог

Каждый коннектор ниже адресуется своим key. Тот же каталог публикуется в машиночитаемом JSON для индексации и интеграций.

Машиночитаемый каталог

Полный каталог (key, name, description, category) отдаётся в JSON по адресу /connectors.json и генерируется из бэкенд-манифестов коннекторов.

Маркетплейсы10

keyСервисОписание
megamarketМегаМаркетТовары, заказы, остатки, цены, FBO-поставки, DBS-доставка, отчёты
yandex_marketЯндекс МаркетКампании, заказы, товары, цены, остатки
yandex_market_api_keyЯндекс Маркет (API-ключ)Подключение по API-ключу из кабинета партнёра, если вход через аккаунт Яндекса не подошёл
avitoAvitoОбъявления, статистика, мессенджер, отзывы и автозагрузка
kaspiKaspi.kzКазахстан: заказы, товары, отзывы, города и точки выдачи
ozon_performanceOzon Performance API (рекламный кабинет)Кампании, статистика, ставки и продвижение
ozonOzon Seller APIТовары, заказы, остатки и аналитика продавца
ozon_api_keyOzon Seller API (API-ключ)Подключение по Client-Id и API-ключу из кабинета продавца, если вход через аккаунт Ozon не подошёл
uzum_marketUzum Market Seller APIТовары, заказы, остатки и финансы продавца
wildberriesWildberries APIТовары, заказы, цены, остатки и аналитика продавца

CRM9

keyСервисОписание
megaplanМегапланСделки, задачи, проекты, контакты, события
megaplan_appМегапланСделки, задачи, проекты, контакты, события
amocrmAmoCRM (Kommo)Сделки, контакты и воронки продаж
bitrix24Bitrix24 CRMСделки, лиды и контакты
bitrix24_appBitrix24 CRMВход через портал Битрикс24: сделки, задачи, чаты, диск и календарь без копирования вебхука
bpmsoftBPMSoft CRMКонтакты, контрагенты, лиды, продажи, бизнес-процессы
retailcrmRetailCRMДля интернет-магазинов: заказы, клиенты, товары, справочники, задачи, аналитика
taxi_crmtaxiCRMДля таксопарков: водители, поездки, выплаты, смены, штрафы, авто, аренда
yclientsYclientsДля салонов красоты: записи, клиенты, услуги и расписание

Банки и платежи10

keyСервисОписание
alfabankАльфа-Банк БизнесСчета, выписки, операции, платежи
modulbankМодульбанкСчета, баланс, история операций, платёжные поручения
sberbankСберБизнесСчета, выписки, платежи, контрагенты, корпоративные карты, зарплата
tinkoffТ-Банк БизнесСчета, выписки, платежи, зарплата, карты
tinkoff_investТ-ИнвестицииИнвестиционный API: портфель, котировки, свечи, заявки, поиск инструментов
tochkaТочка БанкСчета, выписки, платежи, СБП
yookassaЮKassaПриём платежей: платежи, возвраты, чеки, счета, автоплатежи, сделки
adeskAdeskУправленческий учёт: операции, ДДС, ОПиУ, проекты, обязательства, бюджеты
bybitByBitКриптобиржа: тикеры, баланс, ордера, позиции, свечи
robokassaRobokassaПриём платежей: ссылки и счета, статус, холд, повторные списания, возвраты, чеки 54-ФЗ

Документооборот и учёт9

keyСервисОписание
onec1С:ПредприятиеСправочники, документы и регистры 1С; печатные формы и события через расширение конфигурации
diadocКонтур.ДиадокЭДО: отправка, получение и подписание документов
kontur_focusКонтур.ФокусПроверка контрагентов по ИНН/ОГРН: реквизиты, аналитика рисков, мониторинг
kontur_externКонтур.ЭкстернЭлектронная отчётность: черновики, документообороты, организации, сертификаты
moyskladМойСкладТорговля и склад: товары, контрагенты, заказы, остатки, отчёты
parus_exchangeПАРУС 8 (Сервис интеграции)Обмен с ПАРУС 8 через сервер приложений «Сервис интеграции с WEB API»
sbis_service_keyСБИС (Saby, сервисный ключ)Подключение по сервисному ключу своего приложения в Saby, если вход через аккаунт Saby не подошёл
sbisСБИС (Saby)ЭДО: отправка, получение и подписание документов
chestnyznakЧестный ЗНАКМаркировка товаров: коды маркировки, документы, карточки товаров, остатки

Мессенджеры и соцсети16

keyСервисОписание
beeline_cloudpbxБилайн Облачная АТСОблачная АТС: звонки, переадресация, запись разговоров, чёрные списки, детализация
gravitelГравител Облачная АТСОблачная АТС: звонки, SMS, история, сотрудники, номера, АОН, кампании обзвона
pachcaПачкаКорпоративный мессенджер: агент отвечает в беседах и тредах от имени вашего бота
chat2deskChat2DeskОмниканальная платформа: сообщения, диалоги, каналы (WhatsApp, Telegram и др.)
mango_officeMango OfficeВиртуальная АТС: звонки, callback, SMS, статистика, записи разговоров
max_messengerMAX MessengerКорпоративный мессенджер: чаты, сообщения, файлы
msteamsMicrosoft TeamsКорпоративный мессенджер: агент отвечает в личке, чатах и каналах Teams от имени вашего бота
sipuniSipuniIP-телефония: история и пропущенные звонки, записи разговоров, статусы сотрудников
slackSlackРабочий мессенджер: агент отвечает в личке с ботом и в каналах Slack, куда бота пригласили
telegramTelegram BotСобственный бот: агент отвечает в чатах от имени вашего бота
twitterTwitter (X)Поиск твитов, упоминания, ответы, профили, подписчики, тренды, Spaces
umnicoUmnicoОбращения клиентов, история сообщений и события из подключённых каналов
vkteamsVK TeamsКорпоративный мессенджер ВКонтакте: чаты, сообщения, файлы
wappiWappiWhatsApp, Telegram и MAX личного аккаунта: сообщения, чаты, группы
wazzupWazzup24WhatsApp, Telegram, Instagram: сообщения, каналы, контакты
youtubeYouTubeКаналы, видео, плейлисты, комментарии и аналитика YouTube

Почта6

keyСервисОписание
imap_mailПочта по IMAPЯщик на своём домене или корпоративный сервер по IMAP и SMTP: письма, папки, отправка и пересылка
rambler_mailРамблер ПочтаЭлектронная почта Рамблера: письма, папки, отправка и пересылка
yandex_mailЯндекс ПочтаЭлектронная почта Яндекс 360 для бизнеса
gmailGmailПочта Gmail и Google Workspace по паролю приложения: письма, папки, отправка и пересылка
mailru_mailMail.ru ПочтаЭлектронная почта Mail.ru: письма, папки, отправка и пересылка
outlook_mailOutlook ПочтаПочта Microsoft 365 и Outlook.com: письма, папки, вложения, ответы и отправка

Календари3

keyСервисОписание
yandex_calendarЯндекс КалендарьКалендарь и расписания Яндекс 360
google_calendarGoogle CalendarКалендарь и события Google Workspace
outlook_calendarOutlook КалендарьКалендари Microsoft 365 и Outlook.com: события, участники, занятость

Файлы и документы6

keyСервисОписание
mailru_cloudОблако Mail.ruОблачное хранилище Mail.ru по WebDAV: папки, файлы, загрузка и выгрузка
yandex_wikiЯндекс ВикиКорпоративная база знаний: страницы, разделы, динамические таблицы, вложения
yandex_diskЯндекс ДискОблачное хранилище Яндекс 360
google_docsGoogle DocsСоздание, редактирование и совместная работа над документами
google_sheetsGoogle SheetsЛисты, ячейки, диапазоны
google_slidesGoogle SlidesСоздание, редактирование и совместная работа над презентациями

Аналитика9

keyСервисОписание
scan_interfaxСКАН ИнтерфаксПоиск публикаций по компаниям, медиа-аналитика, риск-факторы, мониторинг СМИ
yandex_webmasterЯндекс ВебмастерПоиск Яндекса для сайта: индексация, поисковые запросы, диагностика, sitemap, ссылки
yandex_wordstatЯндекс ВордстатСтатистика поисковых запросов: топ фраз, динамика, распределение по регионам
yandex_metricaЯндекс МетрикаВеб-аналитика: счётчики, цели, отчёты и логи посещений
yandex_datalensЯндекс DataLensВизуализация данных: дашборды, датасеты, графики, подключения
appmetricaAppMetricaМобильная аналитика Яндекса: установки, сессии, события, краши, выручка, push-кампании
brand_analyticsBrand AnalyticsМониторинг упоминаний в соцсетях и СМИ, анализ тональности, топики, авторы
dadataDaDataПоиск компаний по ИНН/ОГРН, стандартизация адресов, банковские реквизиты, аффилированные компании
mpstatsMPStatsАналитика маркетплейсов Wildberries/Ozon: категории, товары, продажи, тренды

Реклама и рассылки7

keyСервисОписание
ord1ОРД (Билайн)Реестр рекламных данных: креативы, контракты, площадки, участники, акты, отчётность
avito_adsАвито Реклама (рекламный кабинет)Кампании, группы, креативы, статистика и балансы
yandex_directЯндекс ДиректКонтекстная реклама: кампании, объявления, ключевые слова, ставки и аналитика
sendsaySendsayEmail-маркетинг: рассылки, подписчики, сегменты, шаблоны, триггеры, A/B-тесты
smsaeroSMS AeroSMS, WhatsApp, Viber и коды в Telegram, контакты, статусы и баланс
unisenderUnisenderEmail/SMS-рассылки: списки контактов, шаблоны, кампании, статистика
vk_adsVK РекламаКампании, объявления, таргетинг, аудитории и статистика

Логистика8

keyСервисОписание
pochta_russiaПочта РоссииПочтовые отправления: заказы, тарифы, трекинг, нормализация адресов, поиск ОПС
pekПЭКГрузоперевозки: расчёт стоимости и сроков, отделения и зоны, статусы грузов, заявки на перевозку
cdekСДЭКДоставка: заказы, расчёт тарифов, отслеживание, ПВЗ, вызов курьера
tk_luchТК «Луч»Грузоперевозки по Уралу: расчёт стоимости, заявки на перевозку, статусы грузов
yandex_deliveryЯндекс ДоставкаКурьерская доставка: расчёт цены, заявки на курьера сегодня, доставка по России, ПВЗ, трекинг
ati_suATI.SUБиржа грузоперевозок: грузы, торги, машины, фирмы, АТИ-Доки, тайм-слоты, индекс ставок
starlineStarLineАвтосигнализация: GPS-координаты, состояние машины, дистанционные команды, OBD
yandex_fleetYandex FleetАвтопарк Яндекс Такси: автомобили, водители и курьеры, заказы, GPS-треки, транзакции

Разработка2

keyСервисОписание
yandex_cloudЯндекс ОблакоОблако клиента: функции, ВМ, Kubernetes, сети, DNS, бакеты, managed-БД, секреты, биллинг
githubGitHubРепозитории, issues, pull requests, коммиты и GitHub Actions

Контент и медиа1

keyСервисОписание
tildaTilda PublishingКонструктор сайтов: проекты, страницы, экспорт, вебхуки

Задачи и проекты3

keyСервисОписание
yandex_trackerЯндекс ТрекерУправление задачами и проектами: создание, отслеживание, спринты и очереди
kaitenKaitenДоски, карточки, спринты, пространства
yougileYouGileДоски, колонки, задачи, чаты, департаменты

HR7

keyСервисОписание
bolid_orionБолид Орион ПроПроходы, пропуска и события охраны
headhunterHeadHunter (hh.ru)Вакансии, отклики и база резюме
hrlinkHRlink КЭДОКадровый ЭДО: документы, заявления, сотрудники
parsecParsec (ParsecNET 3)Табель по проходам, пропуска и группы доступа
perco_webPERCo-WebЖурнал проходов, пропуска и учёт рабочего времени
rusguardRusGuard (RusGuard Soft)Опоздания по графику, пропуска и уровни доступа
sigurSigur (СКУД)Кто на объекте, отказы в проходе, пропуска

Базы данных1

keyСервисОписание
postgresPostgreSQLRead-only SQL по Supabase, Neon, Yandex Managed PostgreSQL, RDS и своей базе

Оборудование18

keyСервисОписание
bacnet_ipBACnet/IPОбъекты контроллера здания или котельной по BACnet/IP через сервер сбора на объекте, только чтение
ethernet_ipEtherNet/IPТеги ПЛК Rockwell Logix, Micro800, Omron NJ/NX, PLC-5/SLC через сервер сбора, только чтение
focasFANUC FOCASСтойки ЧПУ FANUC по FOCAS2 через сервер сбора на объекте и вашу библиотеку FANUC, только чтение
iec104IEC 60870-5-104Телемеханика подстанций и КП по МЭК 60870-5-104 через сервер сбора на объекте, только чтение
ignitionIgnitionТеги и история Ignition через модуль WebDev и программу сбора данных, только чтение
ezsocketMitsubishi CNCСтойки ЧПУ Mitsubishi M700 и M800 через EZSocket и сервер сбора на Windows, только чтение
slmpMitsubishi SLMPПЛК Mitsubishi MELSEC Q, L, iQ-R, iQ-L и iQ-F по устройствам через сервер сбора, только чтение
modbus_tcpModbus TCP / RTU over TCPРегистры Modbus TCP или RTU поверх TCP через программу сбора данных по карте тегов, только чтение
mqttMQTTТопики брокера MQTT (UNS) через программу сбора данных, только чтение
mtconnectMTConnectМодель и значения агента MTConnect через программу сбора данных, только чтение
finsOmron FINSПЛК Omron CS/CJ/CP и NJ/NX по адресам памяти через сервер сбора на объекте, только чтение
onvifONVIFКадр по запросу и движение IP-камеры ONVIF через программу сбора данных, только чтение
opc_daOPC DAТеги сервера OPC DA (Classic) старых SCADA через программу сбора данных на Windows, только чтение
opcuaOPC UAТеги сервера OPC UA (Kepware, Ignition, SCADA, ПЛК) через программу сбора данных, только чтение
pi_web_apiPI Web APIИсториан AVEVA PI и FactoryTalk Historian SE через PI Web API, архив и текущие значения, чтение
s7Siemens S7ПЛК S7-300/400 по адресам STEP 7 через сервер сбора, только чтение; S7-1200/1500 через OPC UA
snmpSNMPИБП, сеть, серверная и датчики климата по SNMP через программу сбора данных, только чтение
sparkplugSparkplug BМетрики узлов Sparkplug B 3.0 (Ignition, HighByte, Litmus) через сервер сбора, только чтение

Прочее1

keyСервисОписание
polymarketPolymarketРынки предсказаний: события, цены, ордербуки и позиции кошелька, только чтение

Динамические коннекторы

Две позиции каталога динамические и настраиваются под каждого тенанта, а не поставляются как статические сервисы: custom_api (вызов любого REST API, который вы опишете) и mcp_server (подключение внешнего MCP-сервера). Каталог выше их не показывает, потому что у них нет фиксированного набора возможностей; list_services через MCP возвращает оба, а что они могут вызвать, зависит от того, как их настроила организация.

Большинство коннекторов отдают насыщенный структурированный паспорт возможностей; два мессенджер-коннектора (telegram, max_messenger) отдают тонкий паспорт: только summary и transport, без перечня рецептов.

Частые вопросы

Где полный список коннекторов?

На этой странице, по категориям: маркетплейсы, CRM, банки, логистика, мессенджеры, аналитика и другое. Полный список также публикуется в машиночитаемом JSON по адресу /connectors.json.

Есть ли REST-эндпоинт для выполнения коннектора?

Да: POST /v1/connectors/{service}/execute по ключу организации, рядом GET /v1/connectors (каталог) и GET /v1/connectors/{service} (паспорт). Тело и отказы те же, что у connector_execute MCP-сервера. Аккаунты подключаются в приложении, а не через API.

Как коннектор получает доступ к аккаунту?

Сначала организация-владелец подключает аккаунт одним из четырёх потоков авторизации: credentials (ключ API, токен или пароль), popup_oauth, device_code и mcp_oauth (только для MCP-сервера, который добавил пользователь). Учётные данные шифруются при хранении и подставляются на каждый вызов.

Что за коннекторы custom_api и mcp_server?

Две динамические позиции каталога, настраиваемые под каждого тенанта: custom_api вызывает любой REST API, который вы опишете, а mcp_server подключает внешний MCP-сервер. У них нет фиксированного набора возможностей, поэтому каталог на этой странице их не показывает; list_services через MCP возвращает оба.

Была ли страница полезна?