Каталог и подключение

Обзор и подключение

База подключается к внешним сервисам через интеграции: мессенджеры, склады, платёжные системы, доставка и аналитика. Интеграциями управляют владелец и админ из панели маркетплейса.

#Каталог интеграций

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

Мессенджеры — Telegram, WhatsApp, VK Messenger, Max.
Склад — МойСклад (живая интеграция).
Учёт и 1С — 1С:Предприятие (живая интеграция, есть тестовый режим «только чтение»).
Платежи — ЮKassa (живая интеграция, есть тестовый магазин), Т-Банк, Сбербанк, Альфа-Банк, CloudPayments.
Доставка — СДЭК, Boxberry, Почта России, Деловые Линии.
Телефония — Mango Office, Ростелеком/МГТС.
Маркетинг — Яндекс.Директ, VK Реклама, myTarget.
Аналитика — Яндекс.Метрика, DataLens, Roistat.
ЭДО — Контур.Диадок, СБИС (Тензор).
Разработчикам — CSV-импорт, API и вебхуки.

#Общая схема подключения

Подключить интеграцию

Откройте «Интеграции» → вкладка «Каталог»
Каталог показывает все доступные провайдеры по категориям.
Выберите сервис
Нажмите на карточку провайдера — откроется форма подключения.
Укажите учётные данные
Токен бота, API-ключ или логин с паролем — зависит от провайдера. Данные хранятся в зашифрованном виде.
Сохраните подключение
Система сразу проверит доступ к сервису и покажет статус.

Одно рабочее пространство может иметь одно активное подключение каждого провайдера. Чтобы переподключить — удалите старое подключение и создайте новое.

#Статусы подключений

Подключено — всё работает, последняя проверка прошла успешно.
Ошибка — проверка не пройдена (неверный токен, истёк доступ, сервис недоступен). Текст ошибки показывается рядом со статусом.
Скоро — провайдер находится в разработке, подключение пока недоступно.

#Тестовые подключения

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

ЮKassa — тестовый магазин: платежи проходят по-настоящему, но деньги не списываются, оплачивать нужно тестовыми картами.
1С — режим «только чтение»: данные загружаются из базы, но CRM ничего в неё не записывает, а в журнале видно, что было бы отправлено.

#Безопасность

Учётные данные (токены, ключи, пароли) хранятся в зашифрованном виде. API никогда не возвращает их открытым текстом — только флаг hasCredentials (есть/нет). Доступ к управлению интеграциями — только у владельца и админа рабочего пространства.

#Провайдеры в разработке

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