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

Быстрый старт

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

• Установите модуль из Маркетплейса в админке сайта. Перед установкой он сам проверит PHP, версию главного модуля и нужные модули — если чего-то не хватает, установка не начнётся и скажет, чего именно.
  
• Откройте «Начало работы» — кнопка на последнем шаге установки или пункт меню «Сервисы → Интеграция с amoCRM». Страница показывает три шага до первой заявки и отмечает уже сделанные; пока они не пройдены, о них напоминают и страницы подключений и профилей.
  
• Нажмите «Подключить amoCRM», выберите аккаунт и разрешите доступ. amoCRM сама создаст интеграцию «Сайт <домен> — rover.amocrm» и передаст ключи сайту — создавать её вручную и копировать ключи не нужно.
  
• Создайте профиль: выберите веб-форму, инфоблок или почтовое событие. Имя, телефон и email модуль сопоставит с контактом сам. Нажмите «Отправить тестовую заявку» — в ответ придут ссылки на сделку и контакт в amoCRM.
  

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

Если кнопка подключения не подходит

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

Если на одном ядре работает несколько сайтов, в настройках модуля выбирается сайт для уведомлений: на него amoCRM присылает вебхуки, поэтому у этого сайта в настройках Битрикса должно быть заполнено поле «URL сервера».

Отложенная обработка и агенты

По умолчанию событие отправляется в amoCRM сразу — в момент отправки формы, сохранения элемента или оформления заказа. Это надёжно, но к отклику страницы добавляется время запроса к amoCRM.

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

• агенты переведены на cron — иначе галочки заблокированы, а в заголовке раздела написано «необходимо перевести на cron»;
  
• лицензия не демонстрационная.
  

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

Права доступа

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

Установка на кастомизированный сайт

Работоспособность модуля гарантируется на стандартном коробочном Битриксе с главным модулем версии 20.5.0 и выше.

При установке на модифицированные сайты (логика работы которых отличается от коробочной логики 1С-Битрикс) может потребоваться дополнительная настройка или доработка. Такая услуга не входит в поддержку модуля и выполняется на платной основе.

Требования

Без этого модуль не установится или не будет работать:

• amoCRM с не истёкшей подпиской либо с действующим демо-периодом;
  
• «Главный модуль» Битрикса 20.5.0 и выше;
  
• модуль «Highload-блоки» — в нём хранятся подключения, профили и очередь событий. Он входит во все актуальные редакции «Управления сайтом», включая «Старт»;
  
• PHP 8.1 и выше;
  
• MySQL или PostgreSQL;
  
• работа сайта по https;
  
• расширения php-curl и php iconv.
  

Проверки PHP, версии главного модуля, cURL и iconv выполняются при установке и прерывают её с понятным сообщением; обновление заранее проверяет PHP, версию главного модуля, «Highload-блоки», cURL и права на запись и без них не начинается. Работа по https проверяется в процессе работы, её видно на вкладке «Диагностика».

Дальше — по тому, какие события вы собираетесь передавать:

• почтовые события работают в любой редакции: они часть главного модуля;
  
• веб-формы требуют модуль «Веб-формы». Он есть начиная с редакции «Стандарт» — в «Старте» веб-форм нет;
  
• инфоблоки требуют модуль «Информационные блоки» — есть во всех редакциях;
  
• заказы (синхронизация статусов, товары, дополнительные поля почтовых событий заказа) требуют модули «Интернет-магазин», «Валюты» и «Торговый каталог» — они доступны начиная с редакции «Малый бизнес».
  

Если что-то пошло не так

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

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

Если причина не нашлась — меню «Поддержка» → «Задать вопрос» есть на каждой странице модуля. Скачайте диагностический отчёт и приложите его к обращению: в нём настройки, подключения и последние ошибки, а паролей, токенов и ключей нет. Разберёмся.