AmoCRM — интеграция с инфоблоками, веб-формами и почтовыми событиями

Что умеет решение

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

Модуль передаёт в amoCRM все события сайта: заполненные веб-формы, создание или изменение элементов инфоблока, а также почтовые события от «Нового заказа» до «Обратного звонка». На стороне amoCRM создаются сделки, контакты, компании или задачи с полями, тегами, рекламными метками и назначенным менеджером.

Модуль разрабатывается с 2017 года и установлен более чем в 1000 проектов. Это не простой коннектор «форма → сделка», а инструмент для настройки процессов: поддержка нескольких профилей для каждой формы или инфоблока, работа с несколькими аккаунтами amoCRM, контроль дубликатов, двусторонняя синхронизация статусов заказов и сделок, а также системные события для кастомизации.

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

Принцип работы

Подключение к amoCRM в один клик

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

Первая заявка — за пять минут

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

Автоматическое создание сделки

При заполнении веб-формы посетителем в AmoCRM создается сделка, связанная с контактом. Название сделки и любые дополнительные поля формируются на основе значений формы с использованием плейсхолдеров. Бюджет рассчитывается путем суммирования, автоматически назначаются теги, метки рекламной кампании и ответственный сотрудник согласно заданному списку. При повторном обращении модуль не создает дубликат контакта, а находит уже существующий.

Профиль интеграции: что, куда и как

Профиль — это правило, определяющее, какое событие на сайте, в какие сущности amoCRM и с каким сопоставлением полей оно должно передаваться. В базовом режиме отображается минимальный набор данных, необходимый для первой заявки. Дополнительные настройки доступны после переключения в режим «Расширенный режим».

Кнопка «Отправить тестовую заявку» позволяет мгновенно проверить корректность профиля. При нажатии в amoCRM создается заявка с тестовыми данными и меткой «тест». В ответ система выдает ссылки на созданную сделку и контакт либо сообщает понятную причину ошибки, если она возникла.

Модуль предотвращает создание дубликатов сделок при повторных обращениях клиентов. При втором сообщении система ищет клиента в amoCRM по номеру телефона, адресу электронной почты или другим указанным полям. Действие определяется настройками: создание новой записи со ссылками на дубликаты, обновление существующей записи или привязка к ней. Глубина поиска ограничена временным интервалом от одного месяца до одного года.

Заказ и сделка синхронизируются. Статус заказа в интернет-магазине и этап сделки в amoCRM связаны двусторонним маппингом: оплата заказа автоматически переводит сделку в статус «Оплачено», а закрытие сделки менеджером в amoCRM помечает заказ на сайте как выполненный. Модуль контролирует вебхук amoCRM: сайт мгновенно подтверждает получение данных, а при отключении вебхук автоматически восстанавливает свою работу.

Модуль самостоятельно сообщает о неполадках. Вкладка «Диагностика» в настройках проверяет очередь событий, работу агентов, состояние подключений, срок действия ключа доступа, вебхуки, профили и файлы модуля, предоставляя пояснения для каждой найденной проблемы. Кнопка «Починить» восстанавливает утраченные справочники, обработчики событий, агенты и файлы без необходимости переустановки и без потери текущих настроек. В журнале отправок каждая ошибка сопровождается понятным описанием причины и ссылкой на место её исправления.

Для технической поддержки предусмотрен диагностический отчёт в одном файле. В нём содержатся настройки, данные подключений, профили и последние ошибки. Пароли, токены и ключи в отчёте отсутствуют, а адреса электронной почты и номера телефонов, упомянутые в текстах ошибок, скрыты. Меню «Поддержка» доступно на каждой странице модуля.

Частые сценарии использования:

- Создание и обновление сделок, контактов и компаний при добавлении или изменении элемента инфоблока.

- Формирование сделки с привязанными товарами в момент оформления заказа в интернет-магазине.

- Автоматическое изменение этапа сделки при смене статуса заказа и обратное действие.

- Создание контакта или компании с пометками рекламных кампаний при заполнении формы регистрации.

- Генерация контакта и задачи при отправке формы обратной связи.

- Создание сделки в статусе «Неразобранное» при заполнении веб-формы.

- Обновление этапа сделки после оплаты заказа.

- Создание компании и привязка к ней контакта со сделкой после заполнения веб-формы.

Возможности работы со сделками:

- Создание и обновление сделок на основе элементов инфоблоков, данных веб-форм и любых почтовых событий.

- Заполнение имени и любых других полей с использованием плейсхолдеров, включая поля «своё значение» для бюджета и числовых полей. Значения в поле бюджета суммируются, а также автоматически проставляются теги.

Модуль обеспечивает управление ответственными лицами по списку с автоматическим назначением по очереди и проверкой прав доступа в amoCRM. Пользователь может выбирать воронку и этап для новой сделки. Реализована двусторонняя синхронизация статусов сделки и заказа с возможностью настройки, исключающей обновление этапа уже завершённой сделки. Товары, извлечённые из почтовых событий заказа, автоматически обновляют состав заказа, а изменения товаров в сделке отражаются в заказе. Примечания создаются с контролем уникальности и объединяются в одно сообщение. Для полей типа списка поддерживается передача самого значения, его идентификатора или произвольного пользовательского ввода. Система контроля дубликатов ищет совпадения по выбранным полям среди всех сделок или у конкретного контакта с глубиной поиска от одного до двенадцати месяцев. Доступны три стратегии обработки найденных дубликатов. Передаётся идентификатор посетителя visitor_uid для работы с автоворонками.

Контакты и компании

Модуль позволяет создавать и обновлять контакты и компании, включая поле «День рождения». Поддерживаются стандартные и кастомные поля любых типов через маппинг и плейсхолдеры, а также работа с тегами и группированными примечаниями. Для контактов и компаний действует тот же механизм назначения ответственных по списку и контроля дубликатов, что и для сделок.

Задачи и «Неразобранное»

Функционал включает автоматическое создание задач для контакта, компании или сделки с указанием типа, текста, формируемого из полей события, и дедлайна. Контакты, компании и сделки могут отправляться в раздел «Неразобранное» с возможностью выбора воронки и указания названия.

Рекламные метки и сквозная аналитика

Модуль автоматически переносит любые параметры из строки запроса, сессии и файлов cookie в отдельные поля amoCRM. Реализовано сохранение меток при переходе между страницами и настройка фиксации только при первом визите, что обеспечивает корректное совпадение данных с Яндекс Метрикой и Google Analytics. Встроенный фильтр версии для метки Google Analytics преобразует строку GA1.2.1054613344.1468150257 в формат 1054613344.1468150257.

Дополнительные поля

Для почтовых событий заказа передаются телефон, адрес доставки, стоимость, платёжная система, служба доставки и комментарий; эти данные доступны и в текстовом теле письма. Для результатов веб-форм фиксируются название, идентификатор, дата и время создания, идентификатор посетителя, домен, имя и IP-адрес сайта, адрес страницы события, а также файлы в виде ссылок. Решение совместимо с продуктами АСПРО. Новые поля в почтовых событиях можно подключать динамически в процессе работы.

Скорость и надёжность

Обработка событий выполняется асинхронно агентом раз в минуту, поэтому сайт не ожидает ответа от amoCRM. Событие отправляется немедленно или повторяется при возникновении ошибки. Если запланированная задача (cron) на сервере не работает, новые события всё равно передаются постепенно при каждом посещении сайта, сразу после отдачи страницы пользователю.

Модуль обеспечивает интеграцию AmoCRM с инфоблоками, веб-формами и почтовыми событиями. Вебхук настроен так, что сайт мгновенно подтверждает получение данных. Раз в шесть часов модуль проверяет его работоспособность и автоматически включает обратно, если он был отключен. На странице подключения отображается текущее состояние, а также доступна кнопка «Проверить и починить».

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

Администрирование

Разграничение прав доступа реализовано через штатные средства Битрикса: просмотр, профили, подключения и настройки доступны разным группам пользователей отдельно. Встроенная система диагностики включает кнопку «Починить», генерацию отчетов для техподдержки и меню «Поддержка» на каждой странице. Журнал отправок поддерживает фильтрацию по записи и элементу, содержит понятные описания причин ошибок и ссылки на их исправление. Логирование запросов и ответов имеет ограничение по размеру и может быть очищено через настройки. Процесс обновления предварительно проверяет версию PHP, наличие необходимых модулей и права на запись, автоматически восстанавливая утерянные права.

Прочие возможности

Модуль поддерживает создание нескольких профилей интеграции для каждой сущности сайта и работу с несколькими аккаунтами AmoCRM. В профиле доступен фильтр по доменам. Реализована возможность отключения срабатывания при обновлении уже существующего элемента или результата формы.

Модуль обеспечивает экспорт в amoCRM существующих элементов инфоблоков, результатов веб-форм и почтовых событий, включая данные, накопленные до момента установки. Логика работы настраивается через системные события модуля: события before и after для сделок, контактов и компаний. Интерфейс полностью переведен на английский язык. Приложение корректно работает с базами данных MySQL и PostgreSQL. Если требуется дополнительный функционал, список возможностей модуля регулярно расширяется через создание тикетов. Подробная информация по установке, настройке, доработке и примерам использования содержится в полной версии документации. Для синхронизации заказов, товаров, покупателей, покупок и каталогов интернет-магазина разработан отдельный модуль «AmoCRM — интеграция с интернет-магазинами». Также доступен комплект, включающий оба модуля со скидкой, и сравнительная таблица их возможностей.

General iT может подключить «AmoCRM — интеграция с инфоблоками, веб-формами и почтовыми событиями», настроить его и проверить корректность интеграции с текущим сайтом.