Установка и базовая настройка
Системные настройки
Название | Значение по умолчанию | Описание |
---|---|---|
amocrm_account | Аккаунт. Поддомен домена amocrm.ru | |
amocrm_hash | Ключ пользователя, можно получить на странице редактирования профиля пользователя | |
amocrm_login | Логин, с которым вы авторизуетесь в amoCRM | |
amocrm_secret_key | Секретный ключ виджета |
Пример заполнения настроек показан ниже:
Как получить значение amocrm_hash
Откройте профиль пользователя, ключ указан в секции "Ваш API"
Как получить значение amocrm_secret_key
Ввод значения секретного ключа необходим только для создания дополнительных полей с помощью модуля. Если Вы планируете создавать поля самостоятельно, ключ вводить не требуется.
Перейдите в раздел API настроек amoCRM (https://YOUR_DOMAIN.amocrm.ru/settings/dev/) и добавьте новый виджет, если не создан ранее.
В окне ввода кода виджета можно ввести что-то осмысленное, но самое главное, чтобы код оказался уникальным в рамках всего amoCRM.
Затем в таблице виджетов скопируйте значение из колонки "Секретный ключ" и введите в системную настройку.
Важно: выделять ключ необходимо двойным кликом, так как он очень длинный и не помещается в отображаемой визуальной части полностью.
Системные настройки
Основные
Название | Значение по умолчанию | Описание |
---|---|---|
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 при сохранении профиля _$profilesave().
Поскольку при использовани процессоров или сохранении в админке передача данных происходит на событии OnUserFormSave, в большинстве случаев включение данной настройки не требуется. Если же ее включить, во многих случаях при одном сохранении пользователя отправка данных может осуществляться дважды.Не рекомендуется включать, если нет осознанной необходимости
Воронки и статусы
Название | Значение по умолчанию | Описание |
---|---|---|
amocrm_new_order_status_id | 1 | ID статуса нового заказа minishop2 |
amocrm_pipeline_id | ID воронки для новой сделка из заказа. Заполняется автоматически при первом заказе | |
amocrm_form_pipeline_id | ID воронки для новой сделки из формы, заполняется автоматически при первом создании сделки | |
amocrm_form_status_new | ID статуса для новой сделки из формы. Статус должен существовать в воронке, указанной в настройке _amocrm_form_pipelineid | |
amocrm_auto_update_pipelines | Нет | Автоматически обновлять воронки и статусы для сделок из заказов |
Поля контактов и сделок
Название | Значение по умолчанию | Описание |
---|---|---|
amocrm_form_filled_fields | Список обязательно заполненных полей для форм. Если какое-либо поле не заполнено, сделка не будет создана | |
amocrm_order_fields | weight,delivery_cost,goods | Список полей заказа, передаваемых при создании сделки. Список товаров сохраняется в полей goods |
amocrm_order_address_fields | phone,city,street,building,room,comment | ID воронки для нового заказа, заполняется автоматически при первом заказе |
amocrm_categories_pipelines | {} | Массив для указания особых параметров для воронки, статуса, ответственного на основании категорий товаров в заказе |
amocrm_responsible_id_priority_category | Да | Включить принудительное применение ответственного и воронки, найденные по категории товаров в заказе |
amocrm_order_properties_element | amoCRMFields | Название массива в свойствах заказа (properties), элементы которого заменят значения по умолчанию |
amocrm_user_fields | Список полей пользователя, передаваемых при создании/обновлении контакта | |
amocrm_user_enum_fields | {"phone":"WORK","email":"WORK","телефон":"WORK"} | JSON массив с указанием ENUM полей и их типов |
amocrm_user_readonly_fields | name | Список полей контактов, защищенных от изменения при передаче данных с сайта |
amocrm_skip_empty_fields | Да | Пропускать поля с пустыми значениями при подготовке данных для передачи в amoCRM |
amocrm_default_responsible_user_id | ID пользователя, назначаемого ответственным по умолчанию. Не совпадает с ID пользователя MODX и ID какого-либо контакта | |
amocrm_auto_create_orders_fields | Да | Автоматически создавать отсутствующие в amoCRM поля для сделок (не работает на базовом тарифе) |
amocrm_auto_create_users_fields | Да | Автоматически создавать отсутствующие в amoCRM поля для контактов (не работает на базовом тарифе) |
Пояснения
-
amocrm_categories_pipelines
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 ответственного, найденного по категориям товаров.
Если выключена, указанный в свойствах заказа ответственный будет сохранен.