Skip to content
  1. Компоненты
  2. amoCRM
  3. Установка и настройка

Установка и базовая настройка

Системные настройки

НазваниеОписание
amocrm_accountАккаунт. Поддомен домена amocrm.ru
amocrm_client_idID интеграции, можно получить в виджете интеграции
amocrm_client_secretСекрет интеграции, можно получить в виджете интеграции
amocrm_client_codeКод авторизации, можно получить в виджете интеграции
amocrm_form_pipeline_idЗаполняется для отправки из форм. Номер воронки в которую планируете отправлять заявки из форм. Можно взять из адресной строки URL
amocrm_form_status_newЗаполняется для отправки из форм. ID статуса указанной выше воронки. Можно посмотреть в инспекторе кода, выделив колонку статуса.
amocrm_pipeline_idЗаполняется для отправки заказов minishop2. Номер воронки в которую планируете отправлять заявки из форм. Можно взять из адресной строки URL.
amocrm_new_order_status_idЗаполняется для отправки заказов minishop2. ID статуса указанной выше воронки. Можно посмотреть в инспекторе кода, выделив колонку статуса.

Пошаговая инструкция для работы с новой системой авторизации

Здесь я буду частично цитировать пошаговую инструкцию по настройке CRM от самих AMO, так что можно и там почитать.

Откройте профиль пользователя, ключ указан в секции "Ваш API"

Шаг 1 — Регистрация приложения

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

Регистрация приложения - 1

После нажатия на кнопку Создать Интеграцию, в появившейся форме, вам необходимо указать Название интеграции, выбрать требуемые доступы и указать описание. Также необходимо указать Redirect URI – url страницы получения токенов. Здесь указываем адрес главной страницы сайта. Тот адрес что доступен у вас при написании [[++site_url]] — Обязательно сделать это один в один, включая слэш в конце адреса

В статье написано что обязательно наличие SSL, но пока что это не строго. И без https соединения все работает.

Кроме этих пунктов администраторам аккаунта, в котором создана интеграция, будут доступны: id интеграции, секретный ключ интеграции, код авторизации (после включения интеграции).

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

Обратите внимание, что Secret key и Integration ID привязаны к интеграции и будут показаны только в вашем аккаунте разработчика.

Должна получиться следующая картина

Регистрация приложения - 2

Ну и заполняем эти данные в системных настройках обновленного компонента AmoCRM

Осторожно

Код авторизации действует только 20 минут

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

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

Шаг 2 — Первоначальная авторизация

Это единственное место в котором мы используем Код авторизации полученный в личном кабинете. Далее он не понадобится.

Как это работает.

При первом запросе в amoCrm (например заказ или отправка контактной формы) компонент пытается авторизоваться. Он отправляет код доступа и если он еще актуален (прошло не более 20 минут с момента получения) мы получаем постоянный код авторизации действующий сутки.

Постоянный код авторизации записывается в кэш и хранится там в течение всего времени жизни сайта. По истечение отведенного срока он автоматически обновляется.

Если вы не успели получить постоянный код за 20 минут — нужно обновить виджет интеграции в AMO и попробовать снова.

Основные - Системные настройки

НазваниеЗначение по умолчаниюОписание
amocrm_use_simple_queueНетВключить использование очередей simpleQueue
amocrm_form_as_leadНетСоздавать сделки из данных форм
amocrm_save_user_in_mgrНетВключить создание/обновление контактов при сохранении пользователя в админке сайта
amocrm_save_user_by_profileНетВключить создание/обновление контактов при сохранении профиля пользователя

Пояснения

  • amocrm_use_simple_queue Если включена данная настройка и установлен компонент simpleQueue, вместо отправки данных в реальном времени будет создано задание на отправку и помещено в очередь. Для отправки необходимо настроить запуск скрипта core/components/amocrm/cron/secondlyrunner.php ежеминутно.

Пример записи в планировщике cron на хостинге MODHOST: * * * * * php ~/www/core/components/amocrm/cron/secondlyrunner.php

  • amocrm_save_user_by_profile При включении данной настройки отправка данных в amoCRM будет происходить при вызове события OnUserProfileSave при сохранении профиля $profile_save(). Поскольку при использовании процессоров или сохранении в админке передача данных происходит на событии OnUserFormSave, в большинстве случаев включение данной настройки не требуется. Если же ее включить, во многих случаях при одном сохранении пользователя отправка данных может осуществляться дважды.

    Не рекомендуется включать, если нет осознанной необходимости

Воронки и статусы

НазваниеЗначение по умолчаниюОписание
amocrm_new_order_status_id1ID статуса нового заказа minishop2
amocrm_pipeline_idID воронки для новой сделка из заказа. Заполняется автоматически при первом заказе
amocrm_form_pipeline_idID воронки для новой сделки из формы, заполняется автоматически при первом создании сделки
amocrm_form_status_newID статуса для новой сделки из формы. Статус должен существовать в воронке, указанной в настройке amocrm_form_pipeline_id
amocrm_auto_update_pipelinesНетАвтоматически обновлять воронки и статусы для сделок из заказов

Поля контактов и сделок

НазваниеЗначение по умолчаниюОписание
amocrm_form_filled_fieldsСписок обязательно заполненных полей для форм. Если какое-либо поле не заполнено, сделка не будет создана
amocrm_order_fieldsweight, delivery_cost, goodsСписок полей заказа, передаваемых при создании сделки. Список товаров сохраняется в полей goods
amocrm_order_address_fieldsphone, city, street, building, room, commentID воронки для нового заказа, заполняется автоматически при первом заказе
amocrm_categories_pipelines{}Массив для указания особых параметров для воронки, статуса, ответственного на основании категорий товаров в заказе
amocrm_responsible_id_priority_categoryДаВключить принудительное применение ответственного и воронки, найденные по категории товаров в заказе
amocrm_order_properties_elementamoCRMFieldsНазвание массива в свойствах заказа (properties), элементы которого заменят значения по умолчанию
amocrm_user_fieldsСписок полей пользователя, передаваемых при создании/обновлении контакта
amocrm_user_enum_fields{"phone": "WORK", "email": "WORK", "телефон": "WORK"}JSON массив с указанием ENUM полей и их типов
amocrm_user_readonly_fieldsnameСписок полей контактов, защищенных от изменения при передаче данных с сайта
amocrm_skip_empty_fieldsДаПропускать поля с пустыми значениями при подготовке данных для передачи в amoCRM
amocrm_default_responsible_user_idID пользователя, назначаемого ответственным по умолчанию. Не совпадает с ID пользователя MODX и ID какого-либо контакта
amocrm_auto_create_orders_fieldsДаАвтоматически создавать отсутствующие в amoCRM поля для сделок (не работает на базовом тарифе)
amocrm_auto_create_users_fieldsДаАвтоматически создавать отсутствующие в amoCRM поля для контактов (не работает на базовом тарифе)

Дополнительная информация

amocrm_categories_pipelines - JSON-массив для указания ответственного, воронки и статуса на основании категорий товаров, входящих в заказ.

Формат:

json
{
  "40": {
    "pipeline_id": 23456,
    "status_id": 567890,
    "responsible_user_id": 123453
  },
  "39": {
    "pipeline_id": 34567,
    "status_id": 87654
  }
}

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

  • amocrm_responsible_id_priority_category Если настройка включена, то при передаче данных ID ответственного, сохраненного в свойствах заказа, заменяется на ID ответственного, найденного по категориям товаров. Если выключена, указанный в свойствах заказа ответственный будет сохранен.