Мастер-Web:Дополнительный модуль Интеграция с amoCRM (15 версия) (не поддерживается)

Версия статьи от 24-10-2023.

Поддерживаемые версии ПК «Мастер-Тур»: Начиная с 15.3 версии

Введение

Модуль повышает эффективность использования CRM системы amoCRM в паре с ПК Мастер-Тур. Модуль позволяет при бронировании путевки из онлайна или из оформления клиентов передать в amoCRM все необходимые данные из путевки для дальнейшего статистического учета: даты тура, стоимость, данные о покупателе и т.п. Модуль был разработан при поддержке интернет-агентства FreshCube.»

Настройка

Подключение amoCRM

Для того чтобы подключить amoCRM необходимо проделать следующие действия:

• Авторизоваться в CRM у клиента https://{0}.amocrm.ru/leads/list/, где {0} - это клиентский поддомен.
• Указать свойства сделок.

Перейти на страницу "Сделки" нажать на кнопку "+НОВАЯ СДЕЛКА". Далее перейти на вкладку "Настроить".

Будет открыто окно, в котором заводятся необходимые свойства сделок при нажатии кнопки "+Добавить поле". (Пример: Название заявки, roistatID, Дата заезда, Дата выезда и т.д.)

После добавления поля можно посмотреть его ID в окне Настройка свойств полей и групп

Также ID полей можно просмотреть на странице https://www.amocrm.ru/developers/console/, выполнив GET-запрос (предварительно авторизовавшись и выбрав аккаунт)

Настройки в панеле администрирования

В панеле администрирования в разделе "Настройки интеграции с amoCRM" необходимо прописать данные, полученные в ответе на GET-запрос или из экрана Настройка свойств полей и групп.

В amoCRM есть обязательные неизменяемые поля и индивидуальные поля, которые создает пользователь в разделе leads/list->custom_fields

• Включение отправки заявок (по умолчанию выключен)
• Признак филиалов для отправки заявок (по умолчанию не указан). При выборе определенного признака – в amoCRM будут отправляться только те заявки, у филиала или у фирмы-владельца которых выбран данный признак. Признаки подтягиваются из справочника Партнеры.

• Обязательные поля для интеграции:
  • Логин пользователя для отправки запросов в систему amoСRМ
  • Хеш-пароль – API ключ (указан в профиле клиентского amoСRМ)
  • Subdomain (поддомен клиентского модуля amoСRМ из раздела account/current)
  • Статус (id статуса, под которым будут приходить сделки в amoСRМ из раздела leads/list)

• Индивидуальные поля из раздела leads/list->custom_fields. Должны иметь только указанный тип поля, в противном случае данные не будут переданы
  • Номер путевки (id поля Номер путевки МТ из раздела leads/list->custom_fields), тип поля – текстовый
  • Roistat (id поля из раздела leads/list->custom_fields), тип поля – текстовый
  • Дата заезда (id поля Точная дата вылета из раздела leads/list->custom_fields), тип поля – дата
  • Дата выезда (id поля Точная дата возврата из раздела leads/list->custom_fields), тип поля – дата
  • Продолжительность (id поля Продолжительность тура из раздела leads/list->custom_fields), тип поля – текстовый
  • Страна (id поля из раздела leads/list->custom_fields), тип поля – мультисписок
  • Город вылета (id поля из раздела leads/list->custom_fields), тип поля – мультисписок
    • Городом вылета считается город вылета по первой услуге авиаперелета в путевке.
    • В том случае, если нет маршрутной услуги или включен признак Наземное обслуживание, то в личном кабинете amoCRM в поле Город вылета будет отображаться значение Без перелета.
    • В том случае, если город вылета будет не найден, то в личном кабинете amoCRM поле Город вылета не будет заполнено, а данное значение будет отображаться в поле Другой город вылета (тип поля – текстовый).
  • Имя туристов (id поля из раздела leads/list->custom_fields), тип поля – текстовый
  • Курорт (id поля из раздела leads/list->custom_fields), тип поля – текстовый
  • Количество туристов (дети, взрослые) (id поля из раздела leads/list->custom_fields), тип поля – текстовый
  • Email контакта (id поля из раздела custom_fields->contacts), тип поля – текстовый
    • По этому полю происходит проверка на дублирование частных лиц. В том случае, если в личном кабинете amoCRM уже присутствует контакт с таким e-mail, то новый контакт не создается.
  • Enum (любой enum для поля Email контакта из раздела contacts/list->custom_fields), тип поля – текстовый
  • Телефон контакта (id поля из раздела contacts/list->custom_fields), тип поля – текстовый
  • Enum (любой enum для поля Телефон контакта из раздела contacts/list->custom_fields), тип поля – текстовый
  • Email компании (id поля из раздела custom_fields->company), тип поля – текстовый
  • Enum (любой enum для поля Email компании из раздела company/list->custom_fields), тип поля – текстовый
  • Телефон компании (id поля из раздела company/list->custom_fields), тип поля – текстовый
  • Enum (любой enum для поля Телефон компании из раздела company/list->custom_fields), тип поля – текстовый
  • ИНН компании (id поля из раздела custom_fields->company), тип поля – текстовый
    • По этому полю происходит проверка на дублирование партнеров. В том случае, если в личном кабинете amoCRM уже присутствует компания с таким ИНН, то новая компания не создается.

В amoCRM передается только информация по новым заявкам. Изменения по заявкам – не передаются.

Интеграция amoCRM с roistat

Существует возможность интеграции amoCRM с roistat. Для корректной интеграции необходимо получить скрипт для отображения кода счетчика (roistatID). Для каждой компании он индивидуальный, располагается в личном кабинете roistat, в Настройках – Код счетчика. Счетчик должен быть расположен на каждой странице сайта внутри HTML тега <body></body>. Как минимум, он должен быть добавлен в разметку корзины (\TourSearchClient\Views\Basket\_Order.cshtml).
Ниже представлен образец размещения скрипта.