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

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

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

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

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

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

Возможности и особенности:

• Сделка + контакт одним запросом (leads/complex); при включённом контроле дублей amoCRM склеивает контакты по телефону/e-mail
  
• Авторизация: долгосрочный токен (рекомендуется) или OAuth 2.0 с автоматическим обновлением токенов
  
• Выбор воронки, этапа и ответственного для создаваемых сделок
  
• Теги сделок для каждого источника
  
• Переопределение отображаемой валюты в примечании (для магазинов, где код валюты сайта не совпадает с фактической валютой цен)
  
• Локализация: русский и английский
  
• Чистый D7-код, собственная таблица через ORM, без изменений ядра
  

Требования: главный модуль 20.00.00+, PHP 8.2 и выше. Модули «Интернет-магазин», «Веб-формы», «Информационные блоки» — опционально, в зависимости от используемых источников. Аккаунт amoCRM с доступом к API.

1. Установите решение из Маркетплейса (Marketplace → Каталог решений) или загрузите обновление в разделе «Установленные решения».
   
2. Перейдите: Настройки → Настройки продукта → Настройки модулей → «IDETA: Интеграция с amoCRM — заказы, веб-формы, инфоблоки».
   
3. Укажите домен аккаунта: вашаккаунт.amocrm.ru.
   
4. Долгосрочный токен (рекомендуется). В amoCRM откройте amoМаркет → «...» (справа вверху) → «Создать интеграцию» → выберите «Внешняя интеграция», заполните название и сохраните. Затем откройте карточку созданной интеграции → вкладка «Ключи и доступы» → скопируйте долгосрочный токен и вставьте в поле «Токен» в настройках модуля.
   
5. Либо OAuth 2.0. В той же карточке интеграции на вкладке «Ключи и доступы» возьмите ID интеграции, секретный ключ и код авторизации, а Redirect URI задайте при создании интеграции. Укажите всё это в настройках модуля — код действует 20 минут, модуль обменяет его на токены и дальше обновляет их сам.
   
6. При необходимости укажите ID воронки, этапа и ответственного
   
7. Отметьте «Проверить подключение при сохранении» и нажмите «Сохранить» — модуль покажет название аккаунта при успешном соединении.
   

Источники:

• Вкладка «Заказы»: включите отправку; при необходимости задайте тег и валюту для примечания.
  
• Вкладка «Веб-формы»: включите отправку, укажите ID форм (пусто = все) и коды вопросов для имени/телефона/e-mail.
  
• Вкладка «Инфоблоки»: включите отправку, укажите ID инфоблоков (обязательно) и коды свойств для полей контакта.
  

Контроль: вкладка «Очередь» — журнал последних отправок, статусы, ID сделок, тексты ошибок; кнопка возврата ошибочных записей в очередь.

• Новая вкладка «UTM-метки»: источники трафика передаются в поля сделки amoCRM, по ним работают фильтры и отчёты
  
• Метки собираются на сайте автоматически — правки в шаблоне не нужны: utm_source, utm_medium, utm_campaign, utm_content, utm_term, gclid, yclid, fbclid, _ym_uid, реферер и страница входа
  
• Две модели атрибуции на выбор: первый источник (first touch) и последний (last touch); обе всегда дублируются в примечании к сделке
  
• Проверка наличия полей сделки в аккаунте amoCRM и создание недостающих в один клик
  
• Заказы, оформленные менеджером в административной части, метками не размечаются — статистика источников не искажается
  
• Усилено экранирование текста ошибок API на странице настроек модуля