Как настроить синхронизацию с внешним сервисом
Синхронизация подтягивает закрепления из внешней системы — CRM или сервиса банка: платформа периодически забирает выгрузку, сверяет её со своими данными и обновляет закрепления с типом ввода «CRM». Настраивается на странице «Интеграции» сегмента.
Доступы
Поля и переключатели доступны при праве «Управление внешними системами» (manage_crms).
Включить сервис синхронизации
- Откройте настройки сегмента → «Интеграции» → «Персональные менеджеры». Отображается карточка «Сервис синхронизации» с текущим состоянием: «Включено» или «Выключено».
- Заполните параметры:
| Поле | Описание |
|---|---|
| Версия API | V1 (по умолчанию) или V2 — формат выгрузки внешнего сервиса |
| Адрес сервиса | URL выгрузки, например https://synchronize.me |
| Требуется аутентификация | Включает проверку логина и пароля |
| Создавать несуществующих клиентов | Создавать в базе клиентов из выгрузки, которых ещё нет |
| Логин / Пароль | Учётные данные для Basic-аутентификации; поля активны при включённой аутентификации |
| Таймаут синхронизации (в секундах) | Максимальное время ожидания ответа сервиса; по умолчанию 60 |
- Нажмите «Сохранить» — кнопка активна, когда заданы адрес и положительный таймаут. Появляется сообщение «Параметры сохранены». Настройки созданы, состояние — «Выключено».
- Откройте меню ⚙ в заголовке карточки → «Включить». Состояние меняется на «Включено» — платформа начинает опрашивать сервис. Тем же меню «Выключить» синхронизация останавливается.
Создание клиентов
Опция «Создавать несуществующих клиентов» срабатывает, только если в сегменте включена интеграция с CRM: новые клиенты заводятся через неё. О настройке CRM см. раздел «Внешние системы» руководства администратора.
Как проходит синхронизация
- Платформа опрашивает адрес сервиса каждые 60 секунд; ответ дожидается до таймаута из настроек.
- При включённой аутентификации запрос идёт с Basic-заголовком из логина и пароля.
- Сервис может отдать заголовок ETag: пока выгрузка не менялась и приходит ответ «не изменено», платформа пропускает обработку и не грузит данные повторно.
- Если выгрузка пришла неполной, полный повтор синхронизации выполняется через 15 минут.
Форматы выгрузки различаются версией API:
| Версия | Что передаётся |
|---|---|
| V1 | Email клиента и список его CRM ID |
| V2 | Email клиента, email ПМ и заместителя, тип ПМ (строкой) |
Что происходит после
- Закрепления из выгрузки появляются в таблице вкладки «Персональные менеджеры» с типом ввода «CRM» — редактировать их вручную нельзя.
- Устаревшие закрепления, которых больше нет в выгрузке, удаляются; дубликаты в самой выгрузке схлопываются — применяется последняя запись.
- Конфликты с ручными закреплениями решает настройка приоритета источников (см. Как настроить приоритет источников ПМ и заместителей).
Результат. Сервис синхронизации включён: закрепления из внешней системы регулярно загружаются в сегмент.