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

Материал из Megatec
Перейти к: навигация, поиск
[досмотренная версия][досмотренная версия]
(→‎Подключение amoCRM)
м (Biryukov переименовал страницу Мастер-Web:Дополнительный модуль Интеграция с amoCRM (15 версия) в [[Мастер-Web:Дополнительный модуль Интеграция с a…)
 
(не показано 14 промежуточных версий 2 участников)
Строка 7: Строка 7:
  
 
==Введение==
 
==Введение==
−
Модуль повышает эффективность использования CRM системы [http://www.amocrm.ru/tour/?utm_source=yandex.direct&utm_medium=cpc&utm_term=578558802|2718280743||amocrm&utm_campaign=sea+bra+key_zaprosy|10435638&utm_content=search|none|premium|1&yclid=1299257120771017663 amoCRM] в паре с ПК Мастер-Тур. Модуль позволяет при бронировании путевки передать в amoCRM все необходимые данные из путевки для дальнейшего статистического учета: даты тура, стоимость, данные о покупателе и т.п. Модуль был разработан при поддержке интернет-агентства [http://www.freshcube.ru/ FreshCube].»
+
Модуль повышает эффективность использования CRM системы [http://www.amocrm.ru/tour/?utm_source=yandex.direct&utm_medium=cpc&utm_term=578558802|2718280743||amocrm&utm_campaign=sea+bra+key_zaprosy|10435638&utm_content=search|none|premium|1&yclid=1299257120771017663 amoCRM] в паре с ПК Мастер-Тур. Модуль позволяет при бронировании путевки из онлайна или из оформления клиентов передать в amoCRM все необходимые данные из путевки для дальнейшего статистического учета: даты тура, стоимость, данные о покупателе и т.п. Модуль был разработан при поддержке интернет-агентства [http://www.freshcube.ru/ FreshCube].»
−
 
 
−
==Установка==
 
−
Для установки дополнительного модуля «Интеграция с amoCRM» нужно добавить в разметку корзины (\TourSearchClient\Views\Basket\_Order.cshtml) скрипт, который будет получать roistatID:
 
−
 
 
−
<script>
 
−
(function(w, d, s, h, id) {
 
−
  w.roistatProjectId = id; w.roistatHost = h;
 
−
  var p = d.location.protocol == "https:" ? "https://" : "http://";
 
−
  var u = /^.*roistat_visit=[^;]+(.*)?$/.test(d.cookie) ? "/dist/module.js" : "/api/site/1.0/"+id+"/init";
 
−
  var js = d.createElement(s); js.async = 1; js.src = p+h+u; var js2 = d.getElementsByTagName(s)[0]; js2.parentNode.insertBefore(js, js2);
 
−
  })(window, document, 'script', 'cloud.roistat.com', '3030');
 
−
</script>
 
−
 
−
<BR>
 
−
[[Файл:ep_216.png|x400px]]<BR>
 
  
 
==Настройка==
 
==Настройка==
Строка 47: Строка 32:
 
В панеле администрирования в разделе "Настройки интеграции с amoCRM" необходимо прописать данные, полученные в ответе на GET-запрос или из экрана '''Настройка свойств полей и групп'''.
 
В панеле администрирования в разделе "Настройки интеграции с amoCRM" необходимо прописать данные, полученные в ответе на GET-запрос или из экрана '''Настройка свойств полей и групп'''.
  
−
[[Файл:ep_225.png|x700px]]<BR>
+
[[Файл:mb_343.png|x700px]]<BR>
 +
 
 +
В 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 уже присутствует компания с таким ИНН, то новая компания не создается.
 +
 
 +
[[Файл: mb_030.png|left|Предупреждение]] <BR>
 +
В amoCRM передается только информация по новым заявкам. Изменения по заявкам – не передаются.
 +
<br /><br />
 +
 
 +
===Интеграция amoCRM с roistat===
 +
 
 +
Существует возможность интеграции amoCRM с roistat. Для корректной интеграции необходимо получить скрипт для отображения ''кода счетчика (roistatID)''. Для каждой компании он индивидуальный, располагается в личном кабинете roistat, в '''Настройках''' – '''Код счетчика'''. Счетчик должен быть расположен на каждой странице сайта внутри HTML тега ''<body></body>''. Как минимум, он должен быть добавлен в разметку корзины (\TourSearchClient\Views\Basket\_Order.cshtml).
 +
<br />
 +
Ниже представлен образец размещения скрипта.
 +
<BR>
 +
[[Файл:ep_216.png|x400px]]<BR>
  
−
*Логин пользователя для отправки запросов в систему amoСRМ
 
−
*Хеш-пароль (указан в профиле клиентского amoСRМ)
 
−
*Subdomain (поддомен клиентского модуля amoСRМ из раздела account/current)
 
−
*Статус (id статуса, под которым будут приходить сделки в amoСRМ из раздела leads/list)
 
−
*Номер путевки (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)
 
−
*Курорт (id поля из раздела leads/list->custom_fields)
 
−
*Количество туристов (дети, взрослые) (id поля из раздела leads/list->custom_fields)
 
−
*Email (id поля из раздела custom_fields->contacts)
 
−
*Enum (любой enum для поля Email из раздела contacts/list->custom_fields)
 
−
*Телефон (id поля из раздела contacts/list->custom_fields)
 
−
*Enum (любой enum для поля Телефон из раздела contacts/list->custom_fields)
 
  
 
[[Category:Мастер-Web_Дополнительные_модули]]
 
[[Category:Мастер-Web_Дополнительные_модули]]

Текущая версия на 14:33, 24 октября 2023

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

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


Введение

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

Настройка

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

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

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

Перейти на страницу "Сделки" нажать на кнопку "+НОВАЯ СДЕЛКА". Далее перейти на вкладку "Настроить".
Ep 217.png
Будет открыто окно, в котором заводятся необходимые свойства сделок при нажатии кнопки "+Добавить поле". (Пример: Название заявки, roistatID, Дата заезда, Дата выезда и т.д.)
Ep 218.png

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

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

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

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

Mb 343.png

В 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).
Ниже представлен образец размещения скрипта.
Ep 216.png

Источник — «http://wiki.megatec.ru/index.php?title=Мастер-Web:Дополнительный_модуль_Интеграция_с_amoCRM_(15_версия)_(не_поддерживается)&oldid=29936»