IDETA: Интеграция с amoCRM — заказы, веб-формы, инфоблоки

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

Модуль автоматически передаёт лиды с сайта в amoCRM (API v4) из трёх источников.

Заказы интернет-магазина. При оформлении нового заказа в amoCRM создаётся сделка. Бюджет сделки равен сумме заказа. Контактные данные (имя, телефон, e-mail) формируются из свойств заказа. В примечание записывается полный состав заказа, его свойства и комментарий покупателя.

Веб-формы. Заявки из форм модуля «Веб-формы» преобразуются в сделки. Список обрабатываемых форм можно ограничить по ID. Поля контакта определяются по символьным кодам вопросов. Все ответы сохраняются в тексте примечания.

Инфоблоки-заявки. Если формы сайта сохраняют заявки в инфоблок, то при добавлении элемента (в том числе через API) создается сделка. Поля контакта определяются по кодам свойств, а все свойства элемента записываются в примечание.

Надёжная доставка. Каждое событие фиксируется в очереди (outbox) и отправляется мгновенно. Если amoCRM недоступен, агент повторяет отправку каждые 5 минут; лимит попыток настраивается. Журнал отправки с ID созданных сделок и текстами ошибок доступен в настройках модуля. Сбой интеграции не влияет на процесс оформления заказа или отправку формы.

Модуль позволяет создавать сделку и контакт единым запросом. При включённой проверке дублей в amoCRM система автоматически объединяет контакты по номеру телефона или адресу электронной почты. Поддерживается авторизация через долгосрочный токен (рекомендуется) или OAuth 2.0 с автоматическим обновлением токенов. Можно выбирать воронку, этап и ответственного сотрудника для создаваемых сделок. Для каждого источника настраиваются индивидуальные теги сделок. Реализована возможность переопределения валюты в примечании, что необходимо для магазинов, где код валюты сайта не совпадает с фактической валютой цен. Интерфейс локализован на русском и английском языках. Код написан на чистом D7, используется собственная таблица через ORM без изменений ядра. Требуется главный модуль версии 20.00.00 и выше, PHP 8.2 и новее. Модули «Интернет-магазин», «Веб-формы» и «Информационные блоки» устанавливаются опционально в зависимости от используемых источников. Необходим аккаунт amoCRM с доступом к API. Установка выполняется через Маркетплейс или загрузку обновления в разделе «Установленные решения». Настройка производится в разделе «Настройки» → «Настройки продукта» → «Настройки модулей» → «IDETA: Интеграция с amoCRM — заказы, веб-формы, инфоблоки», где указывается домен аккаунта.

Настройка авторизации выполняется одним из двух способов. Первый вариант — использование долгосрочного токена: в интерфейсе amoCRM перейдите в раздел настроек интеграций, создайте новую интеграцию, сгенерируйте токен и вставьте его в соответствующее поле модуля. Второй вариант — протокол OAuth 2.0: введите идентификатор интеграции, секретный ключ, адрес перенаправления (Redirect URI) и одноразовый код авторизации, доступный в карточке интеграции. Код действителен в течение 20 минут; модуль самостоятельно обменяет его на токены и обеспечит их автоматическое обновление. По желанию можно указать идентификатор воронки, этап сделки и ответственного сотрудника. Для проверки работоспособности активируйте опцию проверки подключения при сохранении и нажмите кнопку сохранения; при успешном соединении отобразится название аккаунта.

Настройка источников данных осуществляется через отдельные вкладки. В разделе «Заказы» включите передачу данных и при необходимости задайте тег и валюту для примечания. В разделе «Веб-формы» активируйте отправку, укажите идентификаторы форм (оставьте поле пустым для обработки всех форм) и коды вопросов, соответствующие полям имени, телефона и электронной почты. В разделе «Инфоблоки» включите передачу, обязательно укажите идентификаторы инфоблоков и коды свойств для полей контактов.

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

В версии 1.0.1 на вкладке «Заказы» появилась настройка «Валюта в примечании». Она позволяет задать отображаемую валюту (например, UZS), когда код валюты сайта отличается от фактической валюты цен.

General iT поможет установить модуль, настроить его и проверить работу на твоём сайте.