Установка и настройка

25 января 2021, 07:00

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

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

Название Значение по умолчанию Описание
amocrm_account Аккаунт. Поддомен домена amocrm.ru
amocrm_client_id ID интеграции, можно получить в виджете интеграции
amocrm_client_secret Секрет интеграции, можно получить в виджете интеграции
amocrm_client_code Код авторизации, можно получить в виджете интеграции

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

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

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

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

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

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

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

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

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

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

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

Ну и заполняем эти данные в системных настройках обновленного компонента 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 при сохранении профиля _$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 ответственного, найденного по категориям товаров.
    Если выключена, указанный в свойствах заказа ответственный будет сохранен.


Предыдущий документ
Возможности и быстрый старт
Следующий документ
Отправка данных из форм