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

Материал из Megatec
Перейти к: навигация, поиск
[досмотренная версия][досмотренная версия]
 
Строка 36: Строка 36:
 
* Авторизоваться в CRM у клиента https://{0}.amocrm.ru/leads/list/, где {0} - это клиентский поддомен.
 
* Авторизоваться в CRM у клиента https://{0}.amocrm.ru/leads/list/, где {0} - это клиентский поддомен.
 
* Указать свойства сделок.  
 
* Указать свойства сделок.  
Перейти на страницу "Сделки" нажать на кнопку "Добавить сделку". Далее нажать на кнопку "Еще" и выбрать в  выпадающем списке "Свойства сделок".
+
Перейти на страницу "Сделки" нажать на кнопку "+НОВАЯ СДЕЛКА". Далее передти на вкладку "Настроить".
 
<BR>
 
<BR>
[[Файл:KE_156.png|x400px]]<BR>
+
[[Файл:ep_217.png|x400px]]<BR>
Будет открыто окно, в  котором заводятся необходимые свойства сделок при нажатии кнопки "Добавить поле". (Пример: Название заявки, roistatID, Дата заезда, Дата выезда и т.д.)
+
Будет открыто окно, в  котором заводятся необходимые свойства сделок при нажатии кнопки "+Добавить поле". (Пример: Название заявки, roistatID, Дата заезда, Дата выезда и т.д.)
 
<BR>
 
<BR>
[[Файл:KE_157.png|x400px]]<BR>
+
[[Файл:ep_218.png|x400px]]<BR>
 
<BR>
 
<BR>
[[Файл:KE_158.png|x400px]]<BR>
+
 
* Выполнить GET-запрос к клиентскому amocrm.
+
После добавления поля можно посмотреть его ID в окне '''Настройка свойств полей и групп''' <BR>
Заходим на сервис https://developers.amocrm.ru/console.php. Выбираем GET-запрос (изображение ниже)
+
[[Файл:ep_220.png|x400px]]<BR>
<BR>
+
 
[[Файл:KE_160.png|x400px]]<BR>
+
Также ID полей можно просмотреть на странице https://www.amocrm.ru/developers/console/, выполнив GET-запрос (предварительно авторизовавшись и выбрав аккаунт)
Выбираем вкладку Template, в строке subdomen прописываем поддомен клиентского amoCRM.
+
[[Файл:ep_221.png|x400px]]<BR>
<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>
 
 
===Настройки в файле WEB.CONFIG===
 
===Настройки в файле WEB.CONFIG===
 
В web.config ПК Мастер-Web в раздел ''<sectionGroup name="megatec.web">'' добавить секцию amoCrmSettings:
 
В web.config ПК Мастер-Web в раздел ''<sectionGroup name="megatec.web">'' добавить секцию amoCrmSettings:

Текущая версия на 19:10, 4 июля 2018

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

Поддерживаемые версии:
Начиная с 2009.2.20.31


Введение

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

Установка

Для установки дополнительного модуля «Интеграция с amoCRM» нужно выложить распакованные файлы из архива mw-AmoCRMIntegration-9.2.XX.XXXХX.zip в каталог ПК Мастер-Web. Далее добавить в разметку корзины (Basket.aspx/SimpleBasket.aspx) скрипт, который будет получать 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>


KE 167.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

Настройки в файле WEB.CONFIG

В 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;
  • 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"