Плагины и интеграции
Настройки CRM → Плагины — список доступных интеграций и их персональные страницы настройки. Это фиксированный список готовых интеграций платформы — установка сторонних плагинов из файла здесь не предусмотрена. Все действия на страницах плагинов требуют права «Настройки» (manageSettings).
Поиск, карточки плагинов со статусом подключения
Список плагинов
Поиск сверху, сетка карточек: иконка, бейдж статуса (Подключён / Настроен / Не подключён), название, описание, ссылка «📄 Документация» (если у плагина есть внешняя ссылка на документацию источника — например, на SDK Wialon), кнопка «Подключить»/«Отключить».
Сейчас платформа поставляется с пятью встроенными плагинами: 1С:Предприятие, Wialon, Яндекс.Карты, Оригинальное качество изображений и Своё S3-хранилище. Полный разбор каждого — ниже.
Страница плагина
Подключение, метрики синхронизации, журнал событий
Шапка — иконка, название, статус, счётчик ошибок, кнопка «Подключить»/«Отключить». Для интеграций с синхронизацией данных (1С, Wialon) — метрики (Объектов / Создано / Обновлено / Последний синк) и кнопки «🔌 Тест соединения» / «↻ Синхронизировать». Карточка «Подключение» — поля настройки из манифеста конкретного плагина (см. по каждому плагину ниже), плюс для 1С — выбор направления синхронизации (Импорт / Экспорт / Оба). Карточка «Журнал событий» — последние 15 событий синхронизации/ошибок.
1С:Предприятие
Двусторонняя синхронизация справочников и документов с 1С:Предприятие 8.x через HTTP-сервис.
Поля подключения:
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
| URL 1C HTTP-сервиса | URL | да | Адрес опубликованного HTTP-сервиса обмена в вашей информационной базе 1С |
| Пользователь | текст | да | Логин пользователя 1С, от имени которого выполняется обмен |
| Пароль | пароль | — | Хранится отдельно, не отображается после ввода |
| База данных | текст | да | Имя информационной базы на стороне 1С |
| Автосинк, мин (0 — выкл) | число | — | Как часто выполнять фоновую синхронизацию; 0 — синхронизация только вручную кнопкой «↻ Синхронизировать» |
Направление синхронизации — Импорт (из 1С в CRM), Экспорт (из CRM в 1С) или Оба — выбирается отдельным переключателем на странице плагина. Перед первым запуском рекомендуется нажать «🔌 Тест соединения», чтобы убедиться, что HTTP-сервис 1С доступен и учётные данные верны.
Документация 1С
Ссылка «📄 Документация» на карточке плагина ведёт на официальную документацию платформы 1С:Предприятие (its.1c.ru) — настройка самого HTTP-сервиса на стороне 1С выполняется по этой документации силами вашего специалиста по 1С.
Wialon
Плагин мониторинга транспорта (GPS/телематика). У Wialon — два независимых механизма импорта данных, оба доступны с отдельных карточек на странице плагина: регулярная синхронизация сущностей и разовые/повторяемые подключённые отчёты.
Поля подключения:
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
| Wialon API URL | URL | — | Адрес сервера Wialon Hosting или Wialon Local; для официального Wialon Hosting можно оставить по умолчанию |
| Токен доступа | пароль | да | Токен доступа Wialon (создаётся в личном кабинете Wialon → Токены доступа) |
| Автосинк, мин (0 — выкл) | число | — | Периодичность автоматического запуска синхронизации сущностей и подключённых отчётов; 0 — только вручную |
Сущности и маппинг полей
Карточка «Сущности и маппинг полей» — регулярная синхронизация справочников Wialon в таблицы CRM. Поддерживаются 4 независимых типа сущностей, каждый настраивается и включается отдельно:
| Тип сущности | Что это | Ключевые внешние поля |
|---|---|---|
| Объекты (транспорт) | Единицы мониторинга (avl_unit) — машины, техника с трекером | ID в Wialon, Название, Уникальный ID (IMEI), поле «card» (кастомное поле объекта), ID ресурса (аккаунт), Широта, Долгота, Скорость км/ч, Время позиции |
| Ресурсы | Аккаунты/ресурсы Wialon, к которым привязаны объекты | ID в Wialon, Название |
| Водители | Справочник водителей Wialon | ID в Wialon, Имя, Телефон, Описание, Код, ID ресурса |
| Группы транспорта | Группы объектов, заданные в Wialon | ID в Wialon, Название, ID объектов (через запятую) |
Для каждого типа сущности:
- Разверните блок сущности (стрелка ▸/▾) — рядом бейдж «Настроено N полей» или «Не настроено».
- Выберите целевую таблицу CRM (или «Не импортировать», если синхронизировать эту сущность не нужно).
- Выберите ключевое поле — поле CRM, по которому запись из Wialon сопоставляется с уже существующей записью в таблице (обычно это поле, куда мапится «ID в Wialon», чтобы одна и та же единица техники не создавалась заново при каждом синке).
- Для каждого внешнего поля Wialon (левая колонка) выберите поле CRM, в которое его записывать (правая колонка) — или «Не импортировать» для полей, которые не нужны.
Синхронизация запускается кнопкой «↻ Синхронизировать» на странице плагина или автоматически, с интервалом «Автосинк, мин». Результат (создано/обновлено записей) отражается в метриках и журнале событий плагина.
Обратная совместимость
Если синхронизация объектов транспорта была настроена ещё до появления остальных трёх типов сущностей, старая конфигурация (целевая таблица/ключевое поле/маппинг для «Объектов») продолжает работать без каких-либо действий — она автоматически подхватывается новым интерфейсом.
Подключённые отчёты
Второй, независимый механизм — превращение уже готового отчёта Wialon в записи CRM (разовая или повторяемая загрузка, без постоянной live-синхронизации, как у сущностей). Полное описание мастера подключения, всех интервалов, режимов и — в частности — селектора «Строки» для отчётов с группировкой (все строки / только итоги по группе / только детализация) — на отдельной странице Подключённые отчёты Wialon.
Яндекс.Карты
Переключает движок вида «Карта» с OpenStreetMap на Яндекс.Карты — полезно, если у вас более точные или актуальные карты нужны именно от Яндекса (например, для России и СНГ).
Единственное поле подключения — API-ключ Яндекс.Карт (текст, обязательное): JavaScript API-ключ, который выдаётся в кабинете разработчика Яндекса при регистрации приложения на использование Яндекс.Карт. После подключения плагина и указания ключа вид «Карта» во всех таблицах CRM автоматически начинает использовать Яндекс.Карты вместо OpenStreetMap — никаких дополнительных настроек по каждой таблице не требуется.
У этого плагина нет синхронизации данных — нет ни метрик, ни журнала событий, ни кнопок теста соединения: подключение сводится к вводу ключа и нажатию «Подключить».
Оригинальное качество изображений
По умолчанию все загружаемые изображения — вложения, значения полей типа «Изображение», логотип CRM — автоматически сжимаются при загрузке, чтобы экономить место в хранилище файлов. Этот плагин отключает сжатие: изображения после подключения сохраняются в исходном качестве и исходном размере.
У плагина нет никаких настраиваемых полей — подключение состоит из одной кнопки «Подключить». Имеет смысл включать его, если для вашего бизнеса критична максимальная детализация фотографий (например, фотофиксация дефектов, актов осмотра, юридически значимых снимков), и вы готовы к тому, что хранилище файлов будет расходоваться быстрее.
Действует только на новые загрузки
Отключение сжатия не переобрабатывает уже загруженные ранее изображения — оно влияет только на файлы, загруженные после подключения плагина.
Своё S3-хранилище
Позволяет хранить вложения записей, логотип CRM, шаблоны документов и автобэкапы этого тенанта в вашем собственном S3-совместимом хранилище вместо общего платформенного бакета. Подходит для Timeweb S3, Amazon S3 и совместимых сервисов.
Поля подключения:
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
| Endpoint URL | URL | да | Адрес вашего S3-совместимого сервиса, например https://s3.timeweb.com |
| Регион | текст | — | Например, ru-1 |
| Bucket | текст | да | Имя бакета |
| Access Key | текст | да | Ключ доступа |
| Secret Key | пароль | да | Хранится отдельно, не отображается после ввода |
Перед подключением рекомендуется нажать «🔌 Тест соединения» — плагин реально записывает и сразу удаляет маленький тестовый файл в указанном бакете, поэтому успешная проверка означает, что доступ на чтение и запись действительно есть, а не только что поля заполнены в правильном формате.
Переносит только новые файлы
Подключение плагина не переносит уже существующие файлы тенанта из общего платформенного бакета — оно влияет только на файлы, загруженные (или пересгенерированные, как автобэкапы) после подключения. Для каждого файла в системе хранится только его ключ (путь), а не бакет — поэтому ссылки на файлы, загруженные ДО подключения своего хранилища, после подключения перестанут открываться, пока эти файлы не будут вручную скопированы в новый бакет по тому же пути (tenants/{id}/...). Если у тенанта уже накоплены файлы, есть смысл сначала синхронизировать их между бакетами (например, rclone/aws s3 sync) и только потом включать плагин.