AmoCRM — интеграция с интернет-магазинами

Маппинг статусов: группа «Флаги первой оплаты» — «Оплачен [установлен]» и «Оплачен [снят]». Этап сделки меняется по оплате заказа, а оплата — по этапу сделки; в профиле заказов для этого появилась галка «Изменение флага первой оплаты»

Верхнее меню страниц упрощено: убраны ссылки «Подключения» и «Список профилей», «Настройки модуля» стали «Настройками» и стоят последними, «Другие модули» — в меню «Поддержка»

Ссылка «Как работает контроль дублей» стоит рядом с заголовком вкладки, а в сообщениях об ошибке связи с amoCRM есть ссылка «Обновить страницу»

Исправлено: в окне настройки поля вместо подписи «Форматировать» отображалось «undefined»

Исправлены найденные уязвимости

Подключение к amoCRM одной кнопкой — интеграцию в amoCRM больше не нужно создавать вручную и копировать ключи:

Кнопка «Подключить amoCRM»: amoCRM сама создаёт интеграцию «Сайт <домен> — rover.amosale» и передаёт её ключи сайту. Ручной ввод ключей остаётся для закрытых стендов и сайтов без https

Если ключи от amoCRM не дошли до сайта, страница возврата называет причину и файл, который нужно пропустить через защиту от ботов

Если адрес сайта сменился, страница подключения и диагностика предупреждают, что интеграция в amoCRM привязана к прежнему адресу, и предлагают создать новую

Подключение больше не зависит от сессии: ошибка «не удалось понять, к какому подключению относится ответ» при админке на другом адресе сайта ушла

Карточка подключения: на первой вкладке — кнопка подключения со статусом и вебхук, ключи интеграции — на отдельной вкладке «Ключи»; сохранённый секретный ключ больше не передаётся в браузер. Кнопка подключения в списке больше не пропадает после удаления или сортировки, а у подключения без ключей там сразу «Подключить amoCRM»

Обратная связь из amoCRM — смена этапа сделки надёжно доходит до заказа:

Сайт отвечает на вебхук amoCRM сразу, а изменения сделки обрабатывает после ответа — amoCRM больше не отключает вебхук из-за медленного ответа

Раз в 6 часов модуль проверяет вебхук: заново включает отключённый, дополняет набор событий, регистрирует недостающий; администратору сайта приходит оповещение через rover.notifier, если вебхук отключён или не найден

На странице подключения видно состояние вебхука и время последнего полученного, есть кнопка «Проверить и починить»; старые вебхуки этого сайта на прежние адреса можно удалить

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

Первый заказ в amoCRM, диагностика и помощь — модуль ведёт по шагам и сам показывает, что не работает:

Страница «Начало работы»: три шага до первого заказа в amoCRM — подключение, профиль, первая отправка — с отметкой, что уже сделано. На неё ведут меню модуля, кнопка после установки и кнопка в настройках, а пока шаги не пройдены, о них напоминает строка на страницах подключений и профилей

Вкладка «Диагностика» в настройках: очередь, агенты, отправка на хитах, оповещения, лог, окружение, лицензия, подключения и срок ключа доступа, вебхуки, профили заказов, корзин и товаров, справочники, файлы и обработчики событий — с подсказкой, что сделать

Кнопка «Починить» в диагностике возвращает недостающие справочники и поля, обработчики событий, агенты, страницы и файлы модуля — без переустановки и без потери настроек. Так восстанавливается и справочник профилей корзин, которого нет на сайтах, обновлённых с версии 3.0.1

Диагностический отчёт одним файлом для техподдержки: настройки, подключения, профили, последние ошибки. Паролей, токенов и ключей интеграции в нём нет, e-mail и телефоны в текстах ошибок скрыты

Меню «Поддержка» на страницах модуля; «Задать вопрос» предлагает сначала скачать отчёт и приложить его к обращению — поддержке не нужно переспрашивать о настройках

Обновление само восстанавливает то, что модуль потерял на сайте, и заранее проверяет PHP, нужные модули и права на запись: если чего-то не хватает, обновление не начинается и сайт остаётся на прежней версии

Профили:

Профиль открывается быстрее и стал легче: воронки и этапы загружаются одним запросом, список плейсхолдеров выводится один раз на таблицу, форма больше не собирается дважды

Простой режим профиля заказов и корзин: видно только то, что нужно для первого заказа в amoCRM, остальное — по переключателю «Расширенный режим». Изменённые настройки видны всегда

В маппинге сразу видны основные и заполненные поля — название, бюджет, рабочие телефон и email, — остальные по кнопке «Показать все поля»

В контроле дублей появилась глубина поиска: искать дубли только среди созданных в amoCRM за последние 1, 2, 3, 6 или 12 месяцев

В «своё значение» бюджета и числовых полей можно вставлять плейсхолдеры; число вида «1 500» или «1,5» больше не превращается в 0

В меню строки списков подключений и профилей — значки действий

Настройки модуля:

Кнопки «Начало работы», подключений, профилей и журнала отправок, меню «Поддержка»; вкладки «Основное», «Дополнительно», «Диагностика», «Отладка» — метки систем статистики на «Основном», агенты в начале «Дополнительно», статистика очереди и кнопки «обработать события» — в строке «Очередь событий» диагностики

Требования:

Главный модуль версии 20.5.0 или выше

PHP 8.1 или выше

Новая страница «Журнал отправок» в меню модуля: что ушло в amoCRM и что пришло из неё, что не ушло и почему, со ссылками на заказы, корзины, товары, сделки, контакты и компании

Событие с ошибкой можно отправить повторно прямо из журнала; повторно отрабатывают только профили, на которых была ошибка

Результат события сохраняется по каждому профилю

Фильтр журнала по статусу, типу, профилю, дате, ID записи и ID заказа, корзины, товара или сделки; готовые фильтры «С ошибкой», «Пропущенные», «За неделю»

Ошибки объясняются понятным языком: что случилось и что сделать

Для части ошибок есть кнопка «Исправить»: переподключиться к amoCRM, открыть профиль с удалённым полем, открыть настройки поиска дублей, включить https_request (только администратору сайта)

В списках заказов, корзин и товаров добавлена колонка со статусом отправки в amoCRM и ссылкой в журнал

Ссылки из статистики в настройках модуля ведут в журнал с нужным фильтром

Оповещения через rover.notifier приходят с объяснением ошибки и ссылкой на журнал

Если агенты перестали запускаться (не работает крон), новые события отправляются на хитах сайта, а администратор получает оповещение

На вкладке «Отладка» видны последние ошибки из лога; на новых установках логирование включено по умолчанию

Массовая выгрузка и обработка событий показывают сводку ошибок и пропусков с причинами

Страница подключения: статус словами, кнопка подключения, подсказка, где взять ID интеграции и ключ; секретный ключ скрыт как пароль

В списке подключений статус показан текстом; ещё не подключённое подключение больше не помечается как ошибка

Понятные сообщения при отказе в окне amoCRM и при ошибках на странице возврата из amoCRM, со ссылкой назад к списку подключений

Усилена проверка ответа amoCRM при подключении

Кнопки покупки и продления ведут в корзину rover-it.me с нужным товаром

Подсказка переподключиться при отозванном доступе выводится понятным текстом

На одно событие модуля можно повесить несколько обработчиков

Сообщения модуля оформлены в едином стиле

Исправлены тексты и переводы, в том числе ошибки валидации amoCRM, которые выводились как «Array»

Исправлена кнопка перезапуска в сообщении об остановленном агенте

Страница настроек открывается у пользователя с правом только на чтение

Меню модуля больше не сворачивается и не раскрывается вместе с меню модуля rover.amocrm

Исправлена неточность, из-за которой могла не ставиться цена сделки

Исправлена ошибка "Argument 'entityRow' is null or empty (100)", которая могла возникать при создании подключения на новых установках

Исправлены найденные проблемы безопасности

Исправлены прочие мелкие неточности

Добавлена поддержка PostgreSQL

Отключаемая ленивая загрузка шаблонов. Списки и формы модуля подгружаются

отдельным запросом после отрисовки страницы. Если на сайте это приводит к

бесконечной загрузке, поведение отключается галочкой на вкладке «Отладка».

Оповещения об ошибках синхронизации. Модуль сообщает администратору о слетевшем токене amoCRM, недоступности API и сбоях фоновых агентов и вебхуков — на почту или по SMS. Критичные ошибки отправляются сразу, повторяющиеся группируются в одно сообщение. Требуется бесплатный модуль «Оповещения об ошибках на почту, по СМС и в мессенджеры» (https://marketplace.1c-bitrix.ru/solutions/rover.notifier/): он устанавливается отдельно и на работу интеграции не влияет.

Новая вкладка «Отладка» в настройках. Оповещения и логирование собраны в одном месте. Видно текущее состояние оповещений: включены ли они, как настроена группировка, сколько сообщений ждёт отправки и когда уйдёт ближайшее.

Очистка лога из настроек. Файлы лога очищаются кнопкой, без файлового менеджера.

Обращение в техподдержку с заполненной темой. Форма открывается прямо из настроек модуля, тема подставляется автоматически.

Аккуратная панель кнопок на узких экранах. Кнопки в административной части больше не слипаются при переносе на несколько строк.

— незначительные исправления

— для автоматического режима добавлена настройка глубины выборки забытых корзин от даты отсечки; выгрузку более старых забытых корзин можно сделать вручную из списка

— незначительные правки внешнего вида

— добавлена отдельная страница для синхронизации товаров, теперь можно выгрузить как все товары каталога, так и только выбранные. Также сразу видно название товара в амо и дерево его групп

— кнопка массово экспорта убрана из профиля товаров, т.к. сейчас это происходит из нового списка товаров

— обновлён тулбар на всех страницах модуля, более современный вид

— исправлены найденные незначительные ошибки и неточности

— закончен перевод на английский язык

— исправлены найденные некритичные уязвимости

— в список забытых корзин добавлены поля для ФИО и контактов покупателя, а также применённых скидочных купонов

— небольшие доработки интерфейса

— исправлена ошибка при отображении списка забытых корзин

— исправлены ошибки при экспорте забытых корзин

— исправлены прочие найденные ошибки и неточности

— в профиле товаров добавлена возможность переносить структуру разделов каталога при выгрузке товаров в амоСРМ

— в профиле товаров добавлена возможность указывать группу для выгрузки доставок

— доработан внешний вид страницы настроек

— добавлена возможность указать группу в амо для выгрузки товаров из магазина; группа в маппинге может переопределить эту группу

— исправлены найденные ошибки и неточности

— удалена часть устаревших классов

— добавлена возможность перегенерации эндпоинта для вебхука; со стороны амо адрес эндпоинта также автоматически обновляется

— прочие незначительные доработки

— исправлена ошибка "Argument 'entityRow' is null or empty (100)"

— улучшена безопасность модуля

— прочие незначительные исправления

— добавлена возможность создавать заказы в магазине на основе сделок в амоСРМ

— для лучшей синхронизации с Яндекс Метрикой и Гугл Аналитикой добавлена опция сохранения меток рекламных компаний и аналитики только при первом визите

— удалены устаревшие методы

— улучшен перевод на английский язык

— прочие исправления и улучшения

— незначительные исправления

— исправлены ошибки безопасности

— обновлена библиотека связи с amoCRM

— Для обратной интеграции амоСРМ -> заказ добавлены флаги: оплачен, отгрузка завершена, отменён

— На время получения данных из amoCRM добавлен прелоадер, для визуального ускорения загрузки.

— Улучшена стабильность работы при удалении кастомного поля со стороны АмоСРМ

— Увеличено время ожидания ответа от Амо во избежание ошибки "cURL error 28: Resolving timed out after 5000 milliseconds..."

— добавлено форматирование для стандартных полей для телефона контакта

— добавлена поддержка кастомных полей для забытых корзин (можно, например, подтягивать доп. информацию по fuser_id)

— при передаче флага разрешения отгрузки и самой отгрузки для заказа, он автоматом ставится и у первой доставки заказа

— исправлена ошибка, из-за которой могла не всегда срабатывать обратная синхронизация статусов при работе на агентах

— добавлены новые поля для обновления заказа из сделки: комментарий покупателя и менеджера; id, название и бюджет сделки; id и полное имя контакта; id и название компании

— исправлены ошибки

— добавлен контроль дублей товаров-доставок в Амо

— для товаров добавлена возможность передавать ссылку на публичную часть и админку магазина

— для забытых корзин добавлена возможность передавать телефон и email покупателя, а также дату и время последнего обновления

— исправлена ошибка, из-за которой только что созданная доставка к сделке могла прикрепляться не всегда сразу

— исправлены потенциальные слабые места в безопасности