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

Материал из Megatec
Перейти к: навигация, поиск

Версия статьи от 15-04-2016.

Поддерживаемые версии:
Начиная с 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} - это клиентский поддомен.
  • Указать свойства сделок.

Перейти на страницу "Сделки" нажать на кнопку "Добавить сделку". Далее нажать на кнопку "Еще" и выбрать в выпадающем списке "Свойства сделок".
KE 156.png
Будет открыто окно, в котором заводятся необходимые свойства сделок при нажатии кнопки "Добавить поле". (Пример: Название заявки, roistatID, Дата заезда, Дата выезда и т.д.)
KE 157.png

KE 158.png

  • Выполнить GET-запрос к клиентскому amocrm.

Заходим на сервис https://developers.amocrm.ru/console.php. Выбираем GET-запрос (изображение ниже)
KE 160.png
Выбираем вкладку Template, в строке subdomen прописываем поддомен клиентского amoCRM.
KE 162.png
В фильтре Authentication выбираем Custom Token.
KE 163.png
Отобразится окно Custom Token, в котором необходимо ввести логин и хеш-пароль пользователя в клиентской amoCRM.
KE 164.png
Хеш-пароль можно посмотреть в редактировании профиля в строке "ВАШ API" https://{0}.amocrm.ru/settings/profile/, где {0} - поддомен.
Далее нажать на кнопку Send.
KE 165.png
После отправки запроса, возвращается ответ. Данные из которого необходимо прописать в web.config ПК Мастер-Web.
KE 166.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_statuse;
  • idOrderNumber - id поля "Номер заказа" из раздела custom_fields->leads;
  • idRoistat - id поля "roistatID" из раздела custom_fields->leads;
  • idCheckIn - id поля "Дата заезда" из раздела custom_fields->leads;
  • idCheckOut id=id поля "Дата выезда"
  • idDuration id=id поля "Длительность"
  • idCountry id=id поля "Страна"
  • idPurchaser id=id поля "Покупатель"
  • idTourName id=id поля "Название тура"
  • idTouristsCount id=id поля "Кол-во людей"
  • 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"