Где подключить сервис?

В разделе «Интеграции» в боковой панели, вкладка «Сервисы». Найдите сервис поиском, откройте его и нажмите «Подключить». Окно подключения само подскажет, где в кабинете сервиса взять ключ.

Как подключить второй магазин или второй аккаунт того же сервиса?

Откройте уже подключённый сервис и нажмите «Добавить ещё». Каждое подключение живёт отдельно, и в запросе можно назвать, с каким кабинетом работать.

Как запретить агенту что-либо менять в сервисе?

В карточке подключения в строке «Изменения» выберите «Только чтение». Агент будет только читать данные, даже если его попросить что-то изменить.

Я нажал «Отключить». Доступ в самом сервисе закрыт?

Нет. «Отключить» удаляет подключение у нас, и агенты перестают получать данные. Ключ или разрешение приложения в кабинете сервиса остаются, пока вы не удалите их там.

Агент пишет, что доступа нет. Что делать?

Посмотрите статус подключения в разделе «Интеграции»: под ним написано, что сделать. Если всё «Подключено», назовите сервис в запросе через @ и укажите нужный кабинет.

Нужного сервиса нет в каталоге. Как попросить?

Напишите в чате: «передай команде, что нужна интеграция с …». Агент подготовит карточку «Обращение команде», вы проверите текст и нажмёте «Отправить команде». Пока интеграции нет, сервис с API можно подключить на вкладке «Свой API».

Подключение сервисов

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

Какие сервисы можно подключить

Полный список с описанием каждого сервиса лежит в публичном каталоге интеграций, там же отбор по категории, например маркетплейсы или банки. Список в справке не повторяется: каталог собирается из тех же описаний, что окно подключения.

Категория	Страница справки
Маркетплейсы и Авито	Маркетплейсы
1С	1С
МойСклад	МойСклад
CRM	CRM
Почта и календари	Почта и календари
Банки и приём платежей	Банки
ЭДО, отчётность и маркировка	ЭДО и маркировка
Google Sheets и базы данных	Таблицы и базы данных
Телефония	Телефония
Доставка и перевозки	Логистика
Реклама и рассылки	Реклама
Сервис со своим API или MCP-сервер	Свой API и MCP

Оборудование (станки, контроллеры, датчики) подключается через шлюз, об этом отдельный раздел «Оборудование».

Как подключить сервис

Откройте каталог

В боковой панели нажмите «Интеграции», вкладка «Сервисы». Найдите нужный сервис поиском или по категории.

Нажмите «Подключить»

Откроется окно подключения с шагами для этого сервиса: где в его кабинете выдаётся доступ и какие права отметить. Если у сервиса есть второй способ входа, он показан строкой под кнопкой: «Другой способ подключения».

Выдайте доступ

В зависимости от сервиса вы входите в него и разрешаете доступ, вводите код подтверждения или вставляете ключ API в поля формы. Виды описаны ниже.

Проверьте карточку

После проверки сервис появится среди подключённых со статусом «Подключено». Если статус другой, под ним написано, что сделать.

Если вместо «Подключить» на сервисе стоит «Запросить доступ», подключение в организации решает администратор: напишите, зачем нужен доступ, и нажмите «Отправить». Запрос уйдёт администратору.

Когда сервис подключают в организации, окно спрашивает «Открыть организации» или «Оставить личной». Кому из коллег видно подключение, описано на странице «Кому что видно».

Какие бывают виды подключения

Вид	Что вы делаете	Примеры
Вход через сервис	Нажимаете кнопку подключения, входите в кабинет сервиса и нажимаете «Разрешить»	Ozon, Т-Банк, Saby
Код подтверждения	Нажимаете «Скопировать код и открыть», вводите код на странице сервиса и возвращаетесь: подключение подхватится само	Яндекс Маркет, Яндекс Почта
Ключ API	Выпускаете ключ или токен в кабинете сервиса и вставляете его в поля формы	Wildberries, Авито, МойСклад
Вебхук	Сервис сам присылает события: новое сообщение, заказ, отзыв	Авито, Ozon, Яндекс Маркет

Вебхук включается вместе с подключением. Многие сервисы регистрируют его сами, и вставлять ничего не нужно. Если сервис просит вставить адрес вручную, он есть в карточке подключения, раздел «Вебхук», поле «Адрес вебхука»: скопируйте его целиком и вставьте в кабинет сервиса без изменений. Кнопка «Сменить адрес» выдаёт новый адрес, прежний принимает события ещё 24 ч, чтобы вы успели заменить его в кабинете сервиса.

Если события сервиса уже получает другая интеграция (например, CRM), мы чужой адрес не трогаем. Забрать события себе можно кнопкой «Заменить адрес»; после этого та интеграция перестанет их получать. Как запустить задачу по событию, описано в разделе «Задачи».

Несколько кабинетов одного сервиса

Второй магазин, второе юрлицо или ещё один аккаунт подключаются отдельно: откройте подключённый сервис и нажмите «Добавить ещё». Подключения не мешают друг другу, у каждого свои права и своя строка «Изменения».

Если один ключ видит несколько кабинетов (так бывает у Яндекс Маркета), в карточке есть строка «Кабинет по умолчанию»: агент работает в нём, если в задаче не назван другой.

Называйте сервис через @

Подключение не подсказывает агенту, откуда брать цифры для этой задачи. Напишите @ и выберите сервис прямо в запросе.

Создай отчёт по данным из @mango_office за 1–14 июня по группе «Служба поддержки»: всего входящих, принятых и пропущенных звонков; отдельно: перезвонил сам, перезвонили, не дозвонились, спам.

Открыть в чате

Если кабинетов несколько, скажите, какой именно: «по магазину на Ozon, а не на Wildberries», «по юрлицу, которое работает с розницей».

Только чтение или чтение и изменения

В карточке подключения есть строка «Изменения»:

«Чтение и изменения»: агент читает данные и может их менять;
«Только чтение»: агент только читает и ничего не меняет, даже если попросить.

Если ключ в самом сервисе выдан только на чтение, строка так и показывает, и менять её не нужно: чтобы разрешить изменения, переподключите сервис с полным доступом.

Изменения уходят прямо в ваш сервис. Какие из них агент делает сам, какие присылает карточкой на подтверждение и как формулировать массовые правки, описано в разделе «Как агент меняет данные».

Что значат статусы подключения

Статус	Что случилось	Что делать
Подключено	Всё работает	Ничего
Требуется переподключение	Сервис больше не принимает выданный вход	«Переподключить» и войти заново
Ключи не приняты	Сервис отклонил сохранённый ключ: его удалили, у него истёк срок или сменились права	Выпустить ключ в кабинете сервиса и нажать «Ввести ключи заново»
Не хватает прав	Ключ живой, но сервис отказал в части действий	«Расширить доступ» или выпустить ключ с нужными правами
Приостановлено	Приложение приостановлено в кабинете сервиса	Возобновить его там: переподключение здесь не поможет
Не получает сообщения	Регистрация вебхука не прошла, события не приходят	«Проверить снова»
Занят другим сервисом	События сервиса уходят на адрес другой интеграции	«Заменить адрес», если события нужны здесь
Требуется оплата	Сервис требует оплатить его подписку	Оплатить у сервиса, переподключать не нужно
Сервис временно недоступен	Сервис не ответил при проверке	Ничего: проверки продолжатся сами
Доступ у другого подключения	Этот кабинет подключили заново другим подключением, и сервис передал доступ туда	Пользоваться новым подключением, это удалить

Подсказка под статусом в карточке называет следующий шаг для вашего случая. Если адрес вебхука пишет, что ещё не получал событий, проверьте, что он вставлен в кабинет сервиса целиком.

Что делать, если данных нет

«Не вижу» и «нет доступа»: это про права, а не про внимательность

Если агент отвечает, что доступа нет, значит прав действительно нет. Проверьте статус подключения в разделе «Интеграции» и то, что у выданного ключа есть нужная область данных (например, роль на финансы).

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

В групповом чате с другими людьми агент не берёт данные из ваших подключённых сервисов, даже если вы назвали сервис через @. Подробнее: «Групповые чаты».

Как отключить сервис и закрыть доступ

Отключите подключение у нас

Откройте подключённый сервис и нажмите «Отключить». В окне подтверждения видно, какие агенты потеряют доступ. Удаляется только это подключение, другие подключения того же сервиса остаются. Прошлые чаты и результаты задач сохранятся, но новых данных из сервиса агенты не получат.

Закройте доступ в самом сервисе

«Отключить» не трогает ваш кабинет в сервисе. Чтобы доступ закрылся и там, удалите ключ или отзовите разрешение приложения в кабинете сервиса. Где это сделать, сказано в разделе «Как отозвать доступ» на странице каждой категории.

Если вы удалили ключ только в сервисе, подключение у нас перейдёт в статус «Ключи не приняты» или «Требуется переподключение»: агент не сможет им пользоваться, пока вы не выдадите новый доступ.

Сервер пускает только известные адреса

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

Нужного сервиса нет

Сервис с открытым API или MCP-сервер можно подключить сразу: вкладки «Свой API» и «MCP-серверы» в том же разделе, подробнее на странице «Свой API и MCP».
Почта по POP3 не поддерживается: ящик подключается по IMAP и SMTP, подробнее на странице «Почта и календари».
Попросить интеграцию можно из любого чата: напишите «передай команде, что нужна интеграция с …» и коротко, что вы хотите с ней делать. Агент подготовит карточку «Обращение команде», вы проверите текст и нажмёте «Отправить команде».

Передай команде: нужна интеграция с нашим сервисом доставки, хотим, чтобы агент каждое утро сверял статусы отправлений с заказами в МоёмСкладе.