- Проверено Modstore
- Бесплатные будущие обновления
- Работа на тестовом и публичном домене
- 12 месяцев тех. поддержки от автора
Модуль интеграции сайта на MODX Revolution и системы amoCRM
Ключевые возможности:
- Из заказа на сайте создает сделку и контакт (или привязывает существующий)
- В свойствах заказа указывается метод оплаты и список товаров
- При смене статуса заказа изменяет статус сделки и наоборот
- Из любой формы обратной связи создает контакт
- Автоматически создает новую воронку для заказов с сайта и статусы заказов в ней
- Автоматически создает дополнительные поля сделок для списка товаров и метода оплаты
- Автоматически создает и обновляет Контакты при сохранении Пользователей на сайте
- Может создавать неограниченное количество дополнительных полей для контактов (упрощенный режим)
Системные настройки
Как получить значение amocrm_secret_key
Ввод значения секретного ключа необходим только для создания дополнительных полей с помощью модуля. Если Вы планируете создавать поля самостоятельно, ключ вводить не требуется.
Перейдите в раздел API настроек amoCRM (YOUR_DOMAIN.amocrm.ru/settings/dev/) и добавьте новый виджет, если не создан ранее. В окне ввода кода виджета можно ввести что-то осмысленное, но самое главное, чтобы код оказался уникальным в рамках всего amoCRM.
Затем в таблице виджетов скопируйте значение из колонки «Секретный ключ» и введите в системну настройку.
Настройка Webhook
Для получения изменений из amoCRM на сайт в блоке Webhook введите адрес
http://stite.ru/assets/components/amocrm/webhook.php
, заменив http://stite.ru
на URL Вашего сайта. После этого в выпадающем списке справа отметьте галочками события: * Изменить сделку * Смена статуса сделкиДобавление дополнительных полей Контактам
При создании или изменении Контакта с сайта могут передаваться любые данные Пользователя. Единственное условие — должны быть созданы соответствующие дополнительные поля. Если секретный ключ виджета указан, то новые поля можно создать прямо с сайта. Для этого удобнее всего использовать компонент Console и выполнить в нем следующий код:
<code>if (!$amo = $modx->getService('amocrm', 'amoCRM', $modx->getOption('amocrm_core_path', null, $modx->getOption('core_path') . 'components/amocrm/') . 'model/amocrm/', array()) ) { return 'Could not load amoCRM class!'; } $amo->auth(); $amo->addContactsCustomFields(array('username', 'email', 'phone'));</code>
Здесь видно, что перечень полей задается в виде стандартного массива PHP. Важно: поля должны совпадать со свойствами пользователей MODX.
Обсуждение компонента в сообществе MODX.PRO.
1.1.6-beta
- Добавлен скрипт сохранения зависимых от категорий параметров в заказе при работе в контексте отличном от WEB
- Добавлена настройка для списка полей контактов, значения которых в amo не обновляются значениями с сайта
- Улучшено сохранение ID контактов в БД
- Метод updateContact помечен "устаревшим"
1.1.5-beta2
- Добавлен вызов событий при создании сделок из формы
- Исправлена передача данных при добавлении формы
1.1.5-beta
- Добавлена возможность передачи особых параметров $amoCRM в скрипт фоновой отправки данных
- Добавлена возможность принудительной авторизации
- Исправлено создание отдельных экземпляров amoCRM в скрипте фоновой отправки
- Улучшена обработка возвращаемых из плагинов данных
- Добавлена передача ID контактов amoCRM в плагины
- Метод обновления контакта изменен на актуальную версию API
- Добавлен пример плагина для сохранения в amoCRM имеющихся значений ENUM полей
- Добавлена системная настройка для указания ответственного по умолчанию
1.1.4-beta1
- Добавлена передача экземпляра класса (amoCRM и amoCRMWebhook) в вызываемые события
- Добавлена поддержка очередей simpleQueue и отправки данных в отдельном потоке
- Добавлена прозрачная авторизация
- Добавлена системная настройка для пропуска пустых полей при передаче данных
- Добавлены примеры дополнительных скриптов
- Добавлены события отправки пользователей
- Исправлено обновление пользователя из контакта (добавлена передача username в процессор)
1.1.3-beta1
- Исправлена проверка воронки сделки при изменении статуса заказа в MODX
- Возвращено поле товаров в заказе в список передаваемых полей сделки
- Добавлена возможность смены статуса заказа из сайта в AMO в любой воронке
- Исправлено добавление сделки к контакту при отправке формы
- Добавлены методы работы с вебхуками в amoCRM: подписка, отписка, получение
- Добавлены вспомогательные скрипты
1.1.2-beta1
- Добавлены события при отправке сделки и контакта, получении данных при вызове вебхука
1.1.1-rc5
- Добавлена отправка пользователя при сохранении профиля $profile->save()
- Улучшено сохранение сделок для существующих контактов в amoCRM
- Исправлен поиск воронок и статусов по категории товаров - при отсутствии по категории не затираются ранее выставленные значения
- Исправлена передача пользователя при сохранении в админке
- Исправлена смена статуса MS2 для нового заказа при получении данных из amoCRM
- Скорректирован возврат результата работы метода обновления воронки в amoCRM
- Незначительные корректировки отладочного логирования
1.1.1-rc4
- Исправлено обновление контакта при поиске по телефону
- Исправлена обработка полей адреса заказа
- Исключено поле goods из списка обрабатываемых полей заказа (добавляется всегда независимо от списка)
1.1.1-rc3
- Изменен формат полей-перечислений по умолчанию (исключен array_flip)
- Исправлено формирование запроса для поиска существующего контакта в amoCRM
- Улучшено определение ID статуса amoCRM для нового заказа
1.1.1-rc2
- Улучшен механизм обработки списков полей
- Улучшен механизм определения ENUM полей
1.1.1-rc1
- Добавлен возврат результата добавления контакта из формы
- Добавлен метод получения всех сделок по ID
- Добавлен механизм автообновлений воронок и их статусов
- Добавлена возможность включения/отключения автоматического создания несуществующих в amoCRM дополнительных полей контактов и сделок
- Добавлена возможность включения/отключения передачи пользователей из MODX в amoCRM при редактировании в админке
- Добавлена возможность использования любых полей в массиве properties заказа в качестве значения дополнительных полей для сделок
- Добавлена возможность синхронизации контактов из amoCRM
- Добавлена возможность указания воронки, статуса и ответственного для сделки на основании категории одного из товаров
- Добавлена возможность указания параметров подключения к amoCRM для хука FormIt
- Добавлена возможность указания передаваемых дополнительных полей контакта
- Добавлена возможность указания списков полей в 4-х форматах: прежний строковый (f==a||ff==aa), PHP-массив, JSON-массив, перечисление через запятую
- Добавлена поддержка ENUM для полей контактов
- Добавлена работа с компаниями в amoCRM
- Добавлена системная настройка для автообновления воронок
- Добавлена системная настройка для включения/отключения большего приоритета ответственного из свойств категории над указанным в properties заказа
- Добавлено отключение синхронизации пользователя при сохранении в админке или активном приеме данных из amoCRM через Webhook
- Добавлено поле goods в список дополнительных полей заказа для передачи купленных товаров
- Добавлено сохранение ID воронки для объекта amoCRMLead
- Обновлен список стандартных полей контактов и сделок, включая тэги
- Обновлено взаимодействие с API amoCRM по многим запросам
- Улучшена проверка существования контакта в amoCRM
- Улучшена работа с дополнительными полями
- Улучшена работа с полями формы в хуке FormIt
- Улучшено определение воронки и статуса для новой сделки
- Улучшено получение статусов воронки
- Исправлено выставление воронки и ее статуса при изменении статуса заказа в MS2
- Исправлено получение сделок существующего контакта
- Исправлено формирование названия новой сделки из формы
- Иные незначительные исправления и улучшения
1.0.9-pl3
- Добавлена защита дополнения
1.0.8-pl3
- Фикс бага при создании заказа авторизованным пользователем
1.0.7-pl3
- Добавлена поддержка тэгов в качестве полей сделки
1.0.7-pl2
- Исправлена ошибка проверки заполненности обязательных для форм полей
1.0.7-pl
- Добавлена проверка на заполненность обязательных полей формы до создания контакта
1.0.6-pl
- Добавление responsible_user_id в список разрешенных полей для контактов и сделок
- Добавление сниппета-хука amoCRMAddContactGeo для примера взаимодействия с другими компонентами и добавления ответственных в заявки на основе геопозиции
1.0.5-pl2
- Оптимизация работы с cookie
- Корректировка работы с полями по ID
- Устранение излишнего логирования
1.0.5-pl
- Изменение способа хранения cookie
- Корректировка получения имени контакта (username, если пусто fullname)
- Добавление подбора дополнительного поля по ID
1.0.4-beta
- Добавление заявок из форм в качестве сделок
- Устранение предупреждения PHP
1.0.3-pl
- Исправление работы hook'а для FormIt
1.0.2-pl
- Добавлена проверка контекста в плагине перед созданием контакта
1.0.1-pl
- Добавлена передача телефона контакту при создании сделки
- Исправление ошибки в сниппете amoCRMAddContact
1.0.0-pl
- Добавлены списки полей адреса и заказа для передачи в amoCRM при создании сделки
1.0.0-beta2
- Исправлено создание системной настройки для нового заказа amocrm_new_order_status_id
1.0.0-beta
- Первая публичная версия
Последние обсуждения в сообществе MODX.pro