🔄 Коннектор amoCRM

Коннектор amoCRM переносит в TSync ваши сделки (лиды), контакты, компании и воронки из amoCRM. Вы подключаетесь один раз (безопасный вход через OAuth), смотрите предпросмотр того, что будет импортировано, затем импортируете — и далее новые изменения могут поступать автоматически через вебхуки.

Откройте его из Интеграции → amoCRM в меню или из Центр настроек → Интеграции → amoCRM.

Коннектор выключен, пока вы его не включите. Ничего не обращается к amoCRM, пока вы не включите его и не подключите аккаунт.

Что нужно из amoCRM

В аккаунте amoCRM создайте приватную интеграцию (Настройки → Интеграции → создать свою). Вы получите:

  • Client ID (ID интеграции),
  • Client secret,
  • и вставите Redirect URI, который даёт TSync.

Держите вкладку amoCRM открытой — несколько значений нужно будет скопировать туда-обратно.

Шаг 1 — откройте Настройки и скопируйте URL обратного вызова

Перейдите в amoCRM → Настройки. Вверху будет ваш URL обратного вызова OAuth — TSync строит его автоматически из адреса вашего экземпляра, поэтому он всегда корректен для вашего домена:

{TSYNC_BASE_URL}/tsync_amocrm/oauth/callback
Пример: https://ваш-erp.example.com/tsync_amocrm/oauth/callback

Нажмите кнопку Копировать рядом с ним и вставьте его как Redirect URI в интеграции amoCRM. Кнопка Проверить callback открывает адрес, чтобы убедиться, что он отвечает — покажется небольшая страница «amoCRM OAuth callback ready» (это нормально, не ошибка).

HTTPS обязателен для live OAuth. amoCRM перенаправляет только на публичный адрес https://. Если ваш экземпляр показывает не-HTTPS URL обратного вызова, TSync выводит предупреждение — такой адрес годится только для локального теста.

Шаг 2 — добавьте подключение

На странице Настройки нажмите Добавить подключение и заполните:

  • Название подключения — любое узнаваемое, напр. «Основной amoCRM».
  • Базовый URL — адрес аккаунта, напр. https://вашакомпания.amocrm.com.
  • Client ID и Client secret — из amoCRM. Секрет хранится зашифрованным и больше не показывается; если оставить маску из точек, сохранённый секрет сохраняется.
  • Режим синхронизации — вручную, по cron или вебхук.
  • Направление — начните с amoCRM → TSync.
  • Опционально: ответственный по умолчанию и источник лида по умолчанию для импортируемых лидов.

Нажмите Сохранить.

Шаг 3 — подключитесь (авторизация)

Нажмите Подключить amoCRM. Вас перенаправит в amoCRM для подтверждения доступа, затем вернёт в TSync. При успехе подключение показывает статус подключено, а токены сохраняются (зашифрованы). В любой момент можно нажать Проверить подключение.

Если токен истечёт, TSync обновит его автоматически. Если не сможет — подключение помечается как degraded, и вы просто снова нажимаете Подключить.

Чтобы отвязать аккаунт, нажмите Отключить у подключения. Это удаляет сохранённый токен из TSync и помечает подключение как disabled — оно перестаёт обращаться к amoCRM, но сохраняет ваши настройки, поэтому позже можно снова нажать Подключить (в amoCRM ничего не удаляется). Чтобы полностью убрать подключение, используйте Удалить в Настройках.

Шаг 4 — предпросмотр импорта

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

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

Как избегаются дубликаты

TSync никогда не создаёт дубликат вслепую. Входящий лид amoCRM сопоставляется с существующим лидом TSync в таком порядке:

  1. предыдущая связь с той же записью amoCRM,
  2. тот же номер телефона (сравнивается в нормализованном виде, поэтому 069 123 456 и +373 69 123 456 считаются одинаковыми),
  3. тот же email,
  4. то же имя при совпадающем телефоне/email → помечается для ручной проверки (никогда не объединяется автоматически).

Телефонные номера нормализуются для Молдовы и Румынии.

Шаг 5 — поддерживайте синхронизацию вебхуками

После первого импорта включите вебхуки, чтобы новые и изменённые лиды поступали автоматически.

На странице Вебхуки для каждого подключения есть URL вебхука. Зарегистрируйте его в amoCRM (Настройки → Интеграции → вебхуки). Когда amoCRM присылает событие, TSync ставит его в очередь, а затем перепроверяет запись напрямую в amoCRM перед применением — поэтому искажённое или поддельное сообщение не сможет изменить ваши данные. На странице также перечислены недавние события вебхуков (время, событие, сущность, статус: обработано / проигнорировано / ошибка). Можно нажать Обработать очередь вебхуков сейчас, чтобы немедленно очистить очередь.

Автоматическая фоновая синхронизация

Для рутинного обслуживания ничего нажимать не нужно — TSync запускает для коннектора два фоновых задания (их видно и можно запустить вручную в Автоматизация → Планировщик):

  • amoCRM — обновление токена (примерно раз в час): обновляет токены OAuth, близкие к истечению, чтобы подключение оставалось подключено без повторного подключения. Если обновление не удаётся, подключение помечается как degraded, чтобы вы это заметили.
  • amoCRM — обработка очереди вебхуков (примерно каждые 5 минут): очищает очередь событий вебхуков тем же безопасным способом, что и кнопка вручную — перезапрашивая каждую запись из amoCRM перед применением.

Оба задания ничего не делают, пока коннектор выключен.

Диагностика и качество данных

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

  • какой процент с телефоном,
  • какой процент с источником,
  • сколько ждут ручной проверки,
  • сколько вебхуков в очереди,
  • ошибки за последние 24 часа,
  • и время последней успешной синхронизации.

Страница Журналы перечисляет каждое действие с отметкой времени — полезно, если что-то выглядит не так.

Несколько аккаунтов и несколько компаний

Можно добавить сколько угодно подключений — например по одному на каждый аккаунт amoCRM или на каждый отдел — каждое со своими учётными данными, режимом синхронизации, URL вебхука и историей импорта. Панель и Настройки показывают их все со статусами.

Каждое подключение принадлежит одной компании. Подключение, настроенное в Компании A, может импортировать только в Компанию A — данные amoCRM никогда не смешиваются между компаниями.

Кто может им пользоваться

Доступ управляется правами сотрудников для amoCRM (Настройка → Роли / Сотрудники):

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

amoCRM — одна из интеграций TSync. Если нужно подключить другой сервис по REST или OAuth API, см. шлюз Внешние подключения.

Что работает сейчас, что впереди

Коннектор честно показывает свой текущий охват — на панели есть блок статус функций:

  • Готово сейчас: подключение OAuth, проверка подключения, импорт лидов (предпросмотр + запуск), приёмник/очередь вебхуков, логи, диагностика.
  • Бета / частично: маппинг полей, маппинг воронок/статусов, связь контактов/компаний.
  • Очистка дублей — уже доступна. Если прерванный импорт создал одну и ту же сделку amo в TSync дважды, коннектор может найти их и объединить: Диагностика показывает, что он считает дублем и почему, Предпросмотр показывает, что именно сделает очистка, до того как что-то произойдёт, а Очистка переносит задачи, напоминания, файлы и предложения дубля на запись, которую вы оставляете, затем удаляет или помечает лишнюю. Всегда сначала смотрите предпросмотр — объединение переносит реальную работу.
  • Запланировано: двусторонняя синхронизация, отправка из TSync обратно в amoCRM и автоконверсия лид→клиент.

Страницы, которые ещё не достроены, прямо об этом сообщают — ни одна кнопка не притворяется, что делает то, чего пока не может.

Решение частых проблем

  • «Callback ready. Missing authorization code» при открытии URL обратного вызова — это ожидаемо; начинайте подключение кнопкой Подключить в TSync, а не открывая URL напрямую.
  • Подключение «degraded» — токен не удалось обновить; откройте Настройки и снова нажмите Подключить.
  • Проверка подключения не проходит — проверьте базовый URL, Client ID и Client secret, затем сохраните заново.
  • Лид не импортировался — проверьте Журналы и Предпросмотр импорта; лиды без телефона/email, совпадающие по имени с существующим, удерживаются для ручной проверки намеренно.

Настройка приложения amoCRM (Client ID/secret) и реальное подтверждение OAuth выполняются на рабочем адресе ERP, потому что amoCRM должен иметь доступ к URL обратного вызова.