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

Материал из Megatec
Перейти к: навигация, поиск
[непроверенная версия][непроверенная версия]
(Новая страница: «Версия статьи от {{REVISIONDAY}}-{{REVISIONMONTH}}-{{REVISIONYEAR}}. <table style="background-color:#ffffcc;color:black" border="1" cellpadding="10…»)
 
Строка 15: Строка 15:
  
 
  <script>
 
  <script>
  (function(w, d, s, h, id) {
+
(function(w, d, s, h, id) {
  w.roistatProjectId = id; w.roistatHost = h;
+
  w.roistatProjectId = id; w.roistatHost = h;
  var p = d.location.protocol == "https:" ? "https://" : "http://";
+
  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 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);
+
  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');
+
  })(window, document, 'script', 'cloud.roistat.com', '3030');
 
  </script>
 
  </script>
 +
 
<BR>
 
<BR>
 
[[Файл:ep_216.png|x400px]]<BR>
 
[[Файл:ep_216.png|x400px]]<BR>
Строка 32: Строка 33:
 
Перейти на страницу "Сделки" нажать на кнопку "+НОВАЯ СДЕЛКА". Далее передти на вкладку "Настроить".
 
Перейти на страницу "Сделки" нажать на кнопку "+НОВАЯ СДЕЛКА". Далее передти на вкладку "Настроить".
 
<BR>
 
<BR>
[[Файл:ep_217_156.png|x400px]]<BR>
+
[[Файл:ep_217.png|x400px]]<BR>
 
Будет открыто окно, в  котором заводятся необходимые свойства сделок при нажатии кнопки "+Добавить поле". (Пример: Название заявки, roistatID, Дата заезда, Дата выезда и т.д.)
 
Будет открыто окно, в  котором заводятся необходимые свойства сделок при нажатии кнопки "+Добавить поле". (Пример: Название заявки, roistatID, Дата заезда, Дата выезда и т.д.)
 
<BR>
 
<BR>
Строка 38: Строка 39:
 
<BR>
 
<BR>
  
* Выполнить GET-запрос к клиентскому amocrm.
+
После добавления поля можно посмотреть его ID в окне '''Настройка свойств полей и групп''' <BR>
Заходим на сервис https://www.amocrm.ru/developers/console/. Выбираем GET-запрос (изображение ниже)
+
[[Файл:ep_220.png|x400px]]<BR>
<BR>
 
[[Файл:KE_160.pnazg|x400px]]<BR>
 
Выбираем вкладку Template, в  строке subdomen прописываем поддомен клиентского amoCRM.
 
<BR>
 
[[Файл:KE_162.png|x400px]]<BR>
 
В фильтре Authentication выбираем Custom Token.
 
<BR>
 
[[Файл:KE_163.png|x400px]]<BR>
 
Отобразится окно Custom Token, в  котором необходимо ввести логин и хеш-пароль пользователя в клиентской amoCRM.
 
<BR>
 
[[Файл:KE_164.png|x400px]]<BR>
 
Хеш-пароль можно посмотреть в редактировании профиля в строке "ВАШ API"  [https://{0}.amocrm.ru/settings/profile/ https://{0}.amocrm.ru/settings/profile/], где {0} - поддомен.<BR>
 
Далее нажать на кнопку Send.
 
<BR>
 
[[Файл:KE_165.png|x200px]]<BR>
 
После отправки запроса, возвращается ответ. Данные из которого необходимо прописать в web.config ПК Мастер-Web.
 
<BR>
 
[[Файл:KE_166.png|x400px]]<BR>
 
 
 
===Настройки в панеле администрирования===
 
  
В панеле администрирования в разделе "Настройки интеграции с amoCRM" необходимо прописать данные, полученные в ответе на GET-запрос.
+
Также ID полей можно просмотреть на странице https://www.amocrm.ru/developers/console/, выполнив GET-запрос (предварительно авторизовавшись и выбрав аккаунт)
 +
[[Файл:ep_221.png|x400px]]<BR>
  
  
 +
===Настройки в панеле администрирования===
  
====================================================
+
В панеле администрирования в разделе "Настройки интеграции с amoCRM" необходимо прописать данные, полученные в ответе на GET-запрос или из экрана '''Настройка свойств полей и групп'''.
В web.config ПК Мастер-Web в раздел ''<sectionGroup name="megatec.web">'' добавить секцию amoCrmSettings:
 
  <sectionGroup name="megatec.web">
 
    <section name="amoCrmSettings" type="Megatec.Configuration.AmoCrmConfigSection, Megatec.Configuration"/>
 
  
Затем добавить секцию в раздел ''<megatec.web>''. Куда прописываются данные полученные в ответе на GET-запрос. Пример ниже:
 
  <megatec.web>
 
    <amoCrmSettings subdomain="..." userLogin="..." userHash="..." statusId="...">
 
      <idOrderNumber id="…"/>
 
      <idRoistat id="…"/>
 
      <idCheckIn id="…"/>
 
      <idCheckOut id="…"/>
 
      <idDuration id="…"/>
 
      <idCountry id="…"/>
 
      <idPurchaser id="…"/>
 
      <idTourName id="…"/>
 
      <idTouristsCount id="…"/>
 
      <idAgencyOrPersonEmail id="…" enum="…"/>
 
      <idAgencyOrPersonPhone id="…" enum="…"/>
 
    </amoCrmSettings>
 
где
 
 
* subdomain - поддомен клиентского модуля CRM;
 
* subdomain - поддомен клиентского модуля CRM;
 
* userLogin - логин пользователя для отсылки запросов в систему;
 
* userLogin - логин пользователя для отсылки запросов в систему;

Версия 15:49, 4 июля 2018

Версия статьи от 4-07-2018.

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


Введение

Данный модуль позволяет туроператору полноценно использовать все возможности amoCRM: «управлять» своими клиентами, планировать CRM-политики для разных категорий клиентов, анализировать эффективность разных каналов продаж, и в конечном итоге – повысить объем продаж и лояльность своих клиентов.
Модуль позволяет при бронировании путевки через ПК Мастер-Web передать в amoCRM все необходимые данные для дальнейшего статистического учета: даты тура, стоимость, данные о покупателе и т.п. Модуль был разработан при поддержке интернет-агентства 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>


Ep 216.png

Настройка

Подключение 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-запрос или из экрана Настройка свойств полей и групп.

  • subdomain - поддомен клиентского модуля CRM;
  • userLogin - логин пользователя для отсылки запросов в систему;
  • userHash - соответствующий хеш-пароль, который указан в профиле клиентского CRM;
  • statusId - id статуса, под которым будут приходить сделки в CRM, берется из раздела custom_fields->leads_statuses;
  • idOrderNumber - id поля "Номер заказа" из раздела custom_fields->leads;
  • idRoistat - id поля "roistatID" из раздела custom_fields->leads;
  • idCheckIn - id поля "Дата заезда" из раздела custom_fields->leads;
  • idCheckOut id=id поля "Дата выезда" из раздела custom_fields->leads;
  • idDuration id=id поля "Длительность" из раздела custom_fields->leads;
  • idCountry id=id поля "Страна" из раздела custom_fields->leads;
  • idPurchaser id=id поля "Покупатель" из раздела custom_fields->leads;
  • idTourName id=id поля "Название тура" из раздела custom_fields->leads;
  • idTouristsCount id=id поля "Кол-во людей" из раздела custom_fields->leads;
  • idAgencyOrPersonEmail id=id поля "Телефон" из раздела custom_fields->contacts
  • idAgencyOrPersonEmail enum= любой enum для поля "Телефон" из раздела custom_fields->contacts, например "OTHER"
  • idAgencyOrPersonPhone id= id поля "Email" из раздела custom_fields->contacts
  • idAgencyOrPersonPhone enum= любой enum для поля "Email" из раздела custom_fields->contacts, например "OTHER"