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

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

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

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

Здесь я буду частично цитировать пошаговую инструкцию по настройке 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, вместо отправки данных в реальном времени будет создано задание на отправку и помещено в очередь. Для отправки необходимо настроить запуск скрипта 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_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 ответственного, найденного по категориям товаров.
  Если выключена, указанный в свойствах заказа ответственный будет сохранен.