amoConnector - наследник компонента amoCRM

Представляю вашему вниманию amoConnector — компонент интеграции сайта на MODX 2 с системой amoCRM. Построен на официальном SDK amoCRM и использует OAuth 2.0 авторизацию.
В компоненте постарался решить все известные проблемы предшественника

• Сложная авторизация и обновление ключей
• Поиск ID для воронок и статусов
• Неудобное сравнение полей форм с AMO полями

Ключевые особенности

• Автоматическое создание сделок из заказов miniShop2
• Создание сделок из любых форм через FormIt-хук
• Дедупликация контактов по email и телефону
• Двусторонняя синхронизация статусов заказов через webhook
• Гибкий маппинг полей заказов и форм на поля amoCRM через CMP
• Маппинг статусов ms2 на стадии воронок amoCRM
• Отложенная отправка через Scheduler (опционально)
• Система событий для модификации данных плагинами
• Подробный лог всех операций в панели управления
• Примечания к сделкам с товарами заказа или данными формы

Что изменилось по сравнению с amoCRM на конкретных примерах

Авторизация. В AmoCRM чтобы нормально авторизоваться нужно было выполнить специальный скрипт. AmoConnector имеет визуальный интерфейс авторизации, плюс встроенную проверку соединения при каждом посещении страницы компонента.



Подключение воронки и статуса. В AmoCRM нужно было вписать ID этих сущностей в системные настройки. Искать ID статуса было сложно. Я даже специальную инструкцию делал. AmoConnector решает вопрос через API, показывая готовые списки воронок и статусов. Причем статусы — это зависимый список. Зависит от выбранной воронки.


Маппинг статусов MS2. В AmoCRM кажется толком не было реализовано. AmoConnector предлагает удобный визуальное соотношение, какой статус заказа в ms2 соответствует статусу AmoCRM. Работает в обе стороны. Смена статуса заказа передает данные в AMO, Движение лида по воронке передает вебхук к сайту.


Поля форм и поля заказа. Чтобы компонент AmoCRM понимал какое поле куда ему сажать внутри CRM мы описывали для каждой формы вот такие конструкции

formField1==amoField1||formField2==amoField2

Если поле кастомное, нужно было записывать его ID (попробуй найди еще).

AmoConnector предлагает визуальное решение вопроса, в том числе позволяет сразу на лету создать кастомное поле.



Кроме того все поля форм добавляются один раз в одном месте. Не нужно дублировать одни и те же записи в параметрах вызова formIT для каждой формы. Считаю это существенно сокращает объем работы по настройке и подключению форм.

Отложенные действия. AmoCRM использовал свой собственный компонент SimpleQueue, но мы традиционно уже который год используем Scheduler. AmoConnector не изменяет большинству и тоже завез его поддержку.

Больше технической информации в документации

Вот таким получилось обновление. Компонент только для MODX2. Под MODX3 сделаю отдельную версию с поддержкой MS3 и его визуального стиля на базе VueTools.
Компоненту AmoCRM пора на пенсию — я отключаю его.
На старте продаж стоимость ставлю достаточно символическую. Кроме того предлагаю первым трем покупателям настройку под ключ. Успевайте забронировать мое время. По всем вопросам рад буду ответить в нашем телеграм-чате.