Мастер-Тур(15): Интеграция с amoCRM (15 версия) — различия между версиями

Материал из Megatec
Перейти к: навигация, поиск
[непроверенная версия][досмотренная версия]
(Настройка)
м (Интеграция amoCRM с roistat)
 
(не показано 30 промежуточных версий 3 участников)
Строка 1: Строка 1:
Версия статьи от {{REVISIONDAY}}-{{REVISIONMONTH}}-{{REVISIONYEAR}}.
+
Версия статьи от {{REVISIONDAY}}-{{REVISIONMONTH}}-{{REVISIONYEAR}}.
 +
 
 +
<table style="background-color:#ffffcc;color:black" border="1" cellpadding="10" cellspacing="0"><tr><td>
 +
Поддерживаемые версии ПК «Мастер-Тур»:<br>
 +
Начиная с 15.8 версии<br>
 +
</td></tr></table><br>
 +
 
 
== Введение ==
 
== Введение ==
'''Данный модуль позволяет настроить интеграцию программного комплекса Мастер–Тур с CRM системой amoCRM''', для оперативного обмена данными и обработки заявок, в режиме реального времени. С его помощью вы сможете повысить эффективность связки amoCRM и Мастер–Тур, и сократить время обработки заявки оператором.  
+
Модуль повышает эффективность использования 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 все необходимые данные из путевки для дальнейшего статистического учета: даты тура, стоимость, данные о покупателе и т.п.
  
'''Работает модуль следующим образом''' — при бронировании путевки из онлайна или оформления клиентов, все необходимые данные передаются в amoCRM, для дальнейшей работы с клиентом и статистического учета (даты тура, стоимость, данные о покупателе и т.п.).
+
[[Файл: mb_030.png|left|Предупреждение]] <BR>
 +
  В amoCRM передается только информация по новым заявкам. Изменения по заявкам – не передаются.
 +
<br /><br />
  
 
== Настройка ==
 
== Настройка ==
Описание настроек необходимых для корректного обмена данными.
 
  
 
===Подключение amoCRM===
 
===Подключение amoCRM===
Для того чтобы подключить amoCRM '''необходимо проделать следующие действия:'''
+
Для того чтобы подключить amoCRM необходимо проделать следующие действия:</BR>
* Авторизоваться в amoCRM по адресу https://{Ваш домен}.amocrm.ru/leads/list/;
+
 
[[Файл:RR 37.png|x400px]]<BR>
+
Авторизоваться в CRM у клиента по адресу https://{0}.amocrm.ru, где {0} - это клиентский поддомен.</BR>
* Перейти на страницу https://{Ваш домен}.amocrm.ru/amo-market;
+
[[Файл:RR 37.png|x400px]]</BR>
[[Файл:Rr 39.png|x400px]]<BR>
+
 
* В правом верхнем углу экрана https://{Ваш домен}.amocrm.ru/amo-market '''нажать на кнопку "...", затем нажать кнопку "Создать интеграцию"''';
+
Перейти на страницу https://{0}.amocrm.ru/leads, где {0} - это клиентский поддомен.</BR>
[[Файл:RR 40.png|x70px]]<BR>
+
[[Файл:Ea_415.png|x800px]]</BR>
* В появившемся окне '''выбираем "Внешняя интеграция"''';
+
 
[[Файл:RR 41.png|x400px]]<BR>
+
Нажать на кнопку '''"..."''', в правом верхнем углу экрана https://{0}.amocrm.ru/amo-market, где {0} - это клиентский поддомен.</BR>
* В окне создания интеграции '''заполняем следующие поля:'''
+
[[Файл:RR 40.png|x70px]]</BR>
# В первом поле указываем адрес службы TourSearchOwin;
+
 
# Второе поле заполнять не нужно;
+
В появившемся окне нажимаем кнопку '''Создать интеграцию'''.</BR>
# В третьем поле выбираем "Предоставить доступ: Все";
+
[[Файл:RR 55.png|x70px]]</BR>
# В следующем поле ставим чекбоксы в настройках: Контроль дублей и Множественные источники;
+
 
# В поле "Язык" указываем: Русский;
+
В появившемся окне выбираем '''Внешняя интеграция'''.</BR>
# Заполняем поля "Название" и "Описание" (в названии пишем - Мастер-Тур, в описании - интеграция с Мастер-Тур);
+
[[Файл:RR 41.png|x400px]]</BR>
# '''Нажимаем кнопку "Сохранить"''', чтобы сохранить изменения;
 
[[Файл:RR 42 .png|x400px]]<BR>
 
* Переходим в https://{Ваш домен}.amocrm.ru/amo-market и проверяем создание интеграции.
 
[[Файл:RR 43.png|x400px]]<BR>
 
  
''После установки интеграции, будет установлен статус "Отключено", статус изменится на "Установлено", в течение 10-30 минут, после создания''
+
В окне создания интеграции заполняем следующие поля:</BR>
 +
* В первом поле указываем адрес службы TourSearchOwin;
 +
* Второе поле заполнять не нужно;
 +
* В третьем поле выбираем '''Предоставить доступ: Все''';
 +
* В следующем поле ставим чекбоксы в настройках: '''Контроль дублей и Множественные источники''';
 +
* В поле "Язык" указываем: Русский;
 +
* Заполняем поля '''Название''' и '''Описание''' (в названии пишем - Мастер-Тур, в описании - интеграция с Мастер-Тур);
 +
* Нажимаем кнопку '''Сохранить''', чтобы сохранить изменения.
 +
 
 +
[[Файл:RR 42 .png|x600px]]</BR>
 +
Проверяем создание интеграции по адресу https://{0}.amocrm.ru/amo-market, где {0} - это клиентский поддомен.</BR>
 +
[[Файл:RR 43.png|x400px]]</BR>
 +
 
 +
После установки интеграции, будет установлен статус '''Отключено'''. Cтатус изменится на '''Установлено''', в течение 10-30 минут, после создания.
  
 
===Подключение в Программах Тура===
 
===Подключение в Программах Тура===
Для настроки интеграции amoCRM на стороне Тур программ необходимо проделать следующие действия:
+
Для настроки интеграции amoCRM на стороне Тур программ необходимо проделать следующие действия:</BR>
 +
 
 +
Авторизоваться в CRM у клиента https://{0}.amocrm.ru, где {0} - это клиентский поддомен.</BR>
 +
[[Файл:RR 37.png|x400px]]</BR>
 +
 
 +
Перейти на страницу Сделки по адресу https://{0}.amocrm.ru/leads, где {0} - это клиентский поддомен.</BR>
 +
[[Файл:Ea_416.png|x800px]]</BR>
  
* '''Авторизоваться в amoCRM''' по адресу  https://{Ваш домен}.amocrm.ru/leads/list/
+
Нажать на кнопку '''+НОВАЯ СДЕЛКА'''.</BR>
[[Файл:RR 37.png|x400px]]<BR>
+
[[Файл:ep_217.png|x400px]]</BR>
  
* '''Перейти в раздел "Сделки",''' в меню, в левой части экрана amoCRM
+
Перейти на вкладку '''Настроить'''.</BR>
[[Файл:RR 44.png|x400px]]<BR>
+
[[Файл:Ea_420.png|x400px]]</BR>
  
* Перейти на страницу "Сделки" нажать на кнопку "+НОВАЯ СДЕЛКА". Далее перейти на вкладку "Настроить".
+
Нажать на кнопку '''+'''.</BR>
<BR>
+
[[Файл:RR 86.png|x400px]]</BR>
[[Файл:ep_217.png|x400px]]<BR>
+
 
* Будет открыто окно, в  котором заводятся необходимые свойства сделок при нажатии кнопки "+Добавить поле". (Пример: Название заявки, roistatID, Дата заезда, Дата выезда и т.д.)
+
В появившемся окне выбираем группу полей, называем её "Мастер–Тур", и нажимаем '''Добавить'''.</BR>
<BR>
+
[[Файл:RR 58.png|x400px]]</BR>
[[Файл:ep_218.png|x400px]]<BR>
+
Выбираем созданную на предыдущем шаге группу полей кликнув по ней, и нажимаем кнопку '''Добавить поле''' (список полей и их формат указан ниже).</BR>
<BR>
+
[[Файл:RR 59.png|x400px]]</BR>
 +
Откроется форма выбора типа данных и названия поля.</BR>
 +
[[Файл:Ea_421.png|x400px]]</BR>
 +
 
 +
Добавленные поля будут выглядеть следующим образом.</BR>
 +
[[Файл:RR 98.png|x400px]]</BR>
 +
 
 +
После добавления поля можно посмотреть его ID в окне '''Настройка свойств полей и групп''' (нажав на нужное поле).</BR>
 +
[[Файл:RR 100.png|x400px]]<BR>
 +
 
 +
Далее '''Переходим в Турпрограммы → Администрирование → Настройки → Настройки интеграции с amoCRM''' и заполняем необходимые поля.</BR>
 +
Обязательные поля для интеграции:
 +
* '''Включение чекбокса "Включение отправки заявок"''', если чекбокс не проставлен, то данные по путевке в amoCRM передаваться не будут;
 +
* '''Логин''' – логин от профиля клиентского amoСRМ;
 +
* '''Хеш-пароль''' – пароль от профиля клиентского amoСRМ;
 +
* '''Subdomain''' – поддомен клиентского amoСRМ (пример: https://{0}.amocrm.ru/leads, где {0} - является поддоменом);
 +
* '''ID интеграции''' – ID интеграции из установленного приложения в amoCrm;
 +
* '''Секрет интеграции''' – Секретный ключ из установленного приложения в amoCrm;
 +
* '''Redirect URI''' – адрес службы TourSearchOwin (обязательно https);
 +
* '''Код авторизации''' – Код авторизации из установленного приложения в amoCrm (действителен 20 минут);</BR>
 +
 
 +
После заполнения обязательных полей нужно нажать кнопку '''Авторизация в amoCRM'''.</BR>
 +
 
 +
'''Если авторизация прошла успешно''' – на экране появится всплывающее окно с сообщением: '''Authorization is OK'''.</BR>
 +
 
 +
[[Файл:RR 80.png|x400px]]<BR>
 +
 
 +
[[Файл: mb_030.png|left|Предупреждение]]
 +
Заполняемые далее индивидуальные поля должны иметь только указанный тип поля, в противном случае данные не будут переданы.</BR>
 +
<BR></BR>
 +
 
 +
====Группа полей "Мастер–Тур" (создаются вручную)====
 +
 
 +
* '''Номер путевки''' –  (id поля Номер путевки МТ), тип поля – текстовый;
 +
* '''Дата заезда''' (id поля Точная дата заезжа), тип поля – дата;
 +
* '''Дата выезда''' (id поля Точная дата выезда), тип поля – дата;
 +
* '''Продолжительность''' (id поля Продолжительность тура), тип поля – текстовый;
 +
* '''Страна''' (id поля Страна), тип поля – мультисписок;
 +
* '''Город вылета''' (id поля Город вылета), тип поля – мультисписок;
 +
** Городом вылета считается город вылета по первой услуге авиаперелета в путевке.
 +
** В том случае, если нет маршрутной услуги или включен признак ''Наземное обслуживание'', то в личном кабинете amoCRM в поле ''Город вылета'' будет отображаться значение ''Без перелета''.
 +
** В том случае, если город вылета будет не найден, то в личном кабинете amoCRM поле ''Город вылета'' не будет заполнено, а данное значение будет отображаться в поле ''Другой город вылета'' (тип поля – текстовый).
 +
* '''Имя туристов''' (id поля Имя туристов), тип поля – текстовый
 +
* '''Курорт''' (id поля Курорт), тип поля – текстовый
 +
* '''Количество туристов''' (дети, взрослые) (id поля Количество туристов), тип поля – текстовый
 +
 
 +
 
 +
====Группа полей "Основное" (получаем id по инструкции)====
 +
 
 +
'''Поля контактов:'''
 +
* '''Email контакта''' – тип поля – текстовый;
 +
По этому полю происходит проверка на дублирование частных лиц. В том случае, если в личном кабинете amoCRM уже присутствует контакт с таким e-mail, то новый контакт не создается.
 +
* '''Телефон контакта''' – тип поля – текстовый;
  
После добавления поля можно посмотреть его ID в окне '''Настройка свойств полей и групп'''
+
Для получения ID "Поля Контактов", необходимо:</BR>
<BR>
+
[https://www.postman.com/ Установить Postman] с оффициального сайта; </BR>
[[Файл:ep_220.png|x400px]]<BR>
+
Создать GET запрос: https://{0}.amocrm.ru/api/v4/contacts/custom_fields?filter[type][0]=multitext,где {0} - является поддоменом </BR>
 +
[[Файл:RR 94.png|x400px]]</BR>
 +
</BR>
 +
В Postman, в поле Authorization добавить AMO_CRM_AccessToken; Type: Bearer Token </BR>
 +
После того, как все поля заполнены, нажимаем кнопку "Send", если всё заполнено верно, то в нижней части экрана отобразятся все доступные ID.</BR>
 +
AMO_CRM_AccessToken можно найти в используемой базе SQL при помощи запроса:</BR>
 +
<syntaxhighlight lang="xml" enclose="div">
 +
SELECT TOP (1000) [SS_ParmName]
 +
      ,[SS_ParmValue]
 +
      ,[SS_UsKey]
 +
      ,[SS_XmlValue]
 +
      ,[SS_Name]
 +
      ,[SS_NameLat]
 +
      ,[SS_Id]
 +
  FROM [Название вашей базы].[dbo].[SystemSettings]
 +
  where [SS_ParmName] like 'AMO%'
 +
</syntaxhighlight>
 +
'''Поля компаний:'''
 +
* '''Email компании''' – тип поля текстовый;
 +
* '''Телефон компании''' – тип поля – текстовый;
 +
* '''ИНН компании''' – тип поля – текстовый;
 +
По этому полю происходит проверка на дублирование партнеров. В том случае, если в личном кабинете amoCRM уже присутствует компания с таким ИНН, то новая компания не создается.
  
* '''Переходим в Турпрограммы > Администрирование > Настройки > Настройки интеграции с amoCRM''' и заполняем следующие поля:
+
Для получения ID "Поля компаний", необходимо:</BR>
 +
[https://www.postman.com/ Установить Postman] с оффициального сайта; </BR>
  
 +
Создать GET запрос: https://{0}.amocrm.ru/api/v4/companies/custom_fields?filter[type][0]=multitext,где {0} - является поддоменом</BR>
 +
В Postman, в поле Authorization добавить AMO_CRM_AccessToken; Type: Bearer Token </BR>
 +
[[Файл:RR 96.png|x400px]]</BR>
 +
После того, как все поля заполнены, нажимаем кнопку "Send", если всё заполнено верно, то в нижней части экрана отобразятся все доступные ID.</BR>
 +
AMO_CRM_AccessToken можно найти в используемой базе SQL при помощи запроса:</BR>
 +
<syntaxhighlight lang="xml" enclose="div">
 +
SELECT TOP (1000) [SS_ParmName]
 +
      ,[SS_ParmValue]
 +
      ,[SS_UsKey]
 +
      ,[SS_XmlValue]
 +
      ,[SS_Name]
 +
      ,[SS_NameLat]
 +
      ,[SS_Id]
 +
  FROM [Название вашей базы].[dbo].[SystemSettings]
 +
  where [SS_ParmName] like 'AMO%'
 +
</syntaxhighlight>
 +
После заполнения всех полей '''Сохраняем настройки,''' нажимаем кнопку "Сохранить".</BR>
 +
После того, как все необходимые настройки будут заполнены — нужно '''перейти в Службы Windows и перезапустить службу TourSearchOwin''' (сохраненные настройки применятся в течение 5-10 минут).</BR>
 +
Также инструкция по получению полей [https://www.amocrm.ru/developers/content/crm_platform/custom-fields '''доступна в документации amoCrm'''].
  
* Обязательные поля для интеграции:
+
===Интеграция amoCRM с roistat===
# Логин пользователя для отправки запросов в систему amoСRМ
 
# Хеш-пароль – API ключ (указан в профиле клиентского amoСRМ)
 
# Subdomain (поддомен клиентского модуля amoСRМ из раздела account/current)
 
# Статус (id статуса, под которым будут приходить сделки в amoСRМ из раздела leads/list)
 
# ID интеграции
 
# Секрет интеграции
 
# Redirect URI
 
# Код авторизации
 
  
* Индивидуальные поля из раздела leads/list->custom_fields. Должны иметь только указанный тип поля, в противном случае данные не будут переданы
+
Существует возможность интеграции amoCRM с roistat. Для корректной интеграции необходимо получить скрипт для отображения ''кода счетчика (roistatID)''. Для каждой компании он индивидуальный, располагается в личном кабинете roistat, в '''Настройках''' '''Код счетчика'''. Счетчик должен быть расположен на каждой странице сайта внутри HTML тега ''<body></body>''. Как минимум, он должен быть добавлен в разметку корзины (\TourSearchClient\Views\Basket\_Order.cshtml).
** Номер путевки (id поля Номер путевки МТ из раздела leads/list->custom_fields), тип поля – текстовый
+
<br />
** Roistat (id поля из раздела leads/list->custom_fields), тип поля – текстовый
+
Ниже представлен образец размещения скрипта.
** Дата заезда (id поля Точная дата вылета из раздела leads/list->custom_fields), тип поля – дата
+
<BR>
** Дата выезда (id поля Точная дата возврата из раздела leads/list->custom_fields), тип поля – дата
+
[[Файл:ep_216.png|x400px]]<BR>
** Продолжительность (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 уже присутствует компания с таким ИНН, то новая компания не создается.
 
  
  
* '''Сохраняем настройки,''' нажимаем кнопку "Сохранить".
+
Также информация по установке Roistat доступна [https://www.amocrm.ru/extensions/roistat на сайте amoCrm].<BR>
* После того как все необходимые настройки будут заполнены — нужно '''перейти в Службы Windows и перезапустить службу TourSearchOwin''' (сохраненные настройки применятся в течение 5-10 минут).
 

Текущая версия на 10:37, 15 ноября 2023

Версия статьи от 15-11-2023.

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


Введение

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

Предупреждение


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



Настройка

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

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

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

Перейти на страницу https://{0}.amocrm.ru/leads, где {0} - это клиентский поддомен.
Ea 415.png

Нажать на кнопку "...", в правом верхнем углу экрана https://{0}.amocrm.ru/amo-market, где {0} - это клиентский поддомен.
RR 40.png

В появившемся окне нажимаем кнопку Создать интеграцию.
RR 55.png

В появившемся окне выбираем Внешняя интеграция.
RR 41.png

В окне создания интеграции заполняем следующие поля:

  • В первом поле указываем адрес службы TourSearchOwin;
  • Второе поле заполнять не нужно;
  • В третьем поле выбираем Предоставить доступ: Все;
  • В следующем поле ставим чекбоксы в настройках: Контроль дублей и Множественные источники;
  • В поле "Язык" указываем: Русский;
  • Заполняем поля Название и Описание (в названии пишем - Мастер-Тур, в описании - интеграция с Мастер-Тур);
  • Нажимаем кнопку Сохранить, чтобы сохранить изменения.

RR 42 .png
Проверяем создание интеграции по адресу https://{0}.amocrm.ru/amo-market, где {0} - это клиентский поддомен.
RR 43.png

После установки интеграции, будет установлен статус Отключено. Cтатус изменится на Установлено, в течение 10-30 минут, после создания.

Подключение в Программах Тура

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

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

Перейти на страницу Сделки по адресу https://{0}.amocrm.ru/leads, где {0} - это клиентский поддомен.
Ea 416.png

Нажать на кнопку +НОВАЯ СДЕЛКА.
Ep 217.png

Перейти на вкладку Настроить.
Ea 420.png

Нажать на кнопку +.
RR 86.png

В появившемся окне выбираем группу полей, называем её "Мастер–Тур", и нажимаем Добавить.
RR 58.png
Выбираем созданную на предыдущем шаге группу полей кликнув по ней, и нажимаем кнопку Добавить поле (список полей и их формат указан ниже).
RR 59.png
Откроется форма выбора типа данных и названия поля.
Ea 421.png

Добавленные поля будут выглядеть следующим образом.
RR 98.png

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

Далее Переходим в Турпрограммы → Администрирование → Настройки → Настройки интеграции с amoCRM и заполняем необходимые поля.
Обязательные поля для интеграции:

  • Включение чекбокса "Включение отправки заявок", если чекбокс не проставлен, то данные по путевке в amoCRM передаваться не будут;
  • Логин – логин от профиля клиентского amoСRМ;
  • Хеш-пароль – пароль от профиля клиентского amoСRМ;
  • Subdomain – поддомен клиентского amoСRМ (пример: https://{0}.amocrm.ru/leads, где {0} - является поддоменом);
  • ID интеграции – ID интеграции из установленного приложения в amoCrm;
  • Секрет интеграции – Секретный ключ из установленного приложения в amoCrm;
  • Redirect URI – адрес службы TourSearchOwin (обязательно https);
  • Код авторизации – Код авторизации из установленного приложения в amoCrm (действителен 20 минут);

После заполнения обязательных полей нужно нажать кнопку Авторизация в amoCRM.

Если авторизация прошла успешно – на экране появится всплывающее окно с сообщением: Authorization is OK.

RR 80.png

Предупреждение
Заполняемые далее индивидуальные поля должны иметь только указанный тип поля, в противном случае данные не будут переданы.



Группа полей "Мастер–Тур" (создаются вручную)

  • Номер путевки – (id поля Номер путевки МТ), тип поля – текстовый;
  • Дата заезда (id поля Точная дата заезжа), тип поля – дата;
  • Дата выезда (id поля Точная дата выезда), тип поля – дата;
  • Продолжительность (id поля Продолжительность тура), тип поля – текстовый;
  • Страна (id поля Страна), тип поля – мультисписок;
  • Город вылета (id поля Город вылета), тип поля – мультисписок;
    • Городом вылета считается город вылета по первой услуге авиаперелета в путевке.
    • В том случае, если нет маршрутной услуги или включен признак Наземное обслуживание, то в личном кабинете amoCRM в поле Город вылета будет отображаться значение Без перелета.
    • В том случае, если город вылета будет не найден, то в личном кабинете amoCRM поле Город вылета не будет заполнено, а данное значение будет отображаться в поле Другой город вылета (тип поля – текстовый).
  • Имя туристов (id поля Имя туристов), тип поля – текстовый
  • Курорт (id поля Курорт), тип поля – текстовый
  • Количество туристов (дети, взрослые) (id поля Количество туристов), тип поля – текстовый


Группа полей "Основное" (получаем id по инструкции)

Поля контактов:

  • Email контакта – тип поля – текстовый;

По этому полю происходит проверка на дублирование частных лиц. В том случае, если в личном кабинете amoCRM уже присутствует контакт с таким e-mail, то новый контакт не создается.

  • Телефон контакта – тип поля – текстовый;

Для получения ID "Поля Контактов", необходимо:
Установить Postman с оффициального сайта;
Создать GET запрос: https://{0}.amocrm.ru/api/v4/contacts/custom_fields?filter[type][0]=multitext,где {0} - является поддоменом
RR 94.png

В Postman, в поле Authorization добавить AMO_CRM_AccessToken; Type: Bearer Token
После того, как все поля заполнены, нажимаем кнопку "Send", если всё заполнено верно, то в нижней части экрана отобразятся все доступные ID.
AMO_CRM_AccessToken можно найти в используемой базе SQL при помощи запроса:

 SELECT TOP (1000) [SS_ParmName]
      ,[SS_ParmValue]
      ,[SS_UsKey]
      ,[SS_XmlValue]
      ,[SS_Name]
      ,[SS_NameLat]
      ,[SS_Id]
  FROM [Название вашей базы].[dbo].[SystemSettings]
  where [SS_ParmName] like 'AMO%'

Поля компаний:

  • Email компании – тип поля текстовый;
  • Телефон компании – тип поля – текстовый;
  • ИНН компании – тип поля – текстовый;

По этому полю происходит проверка на дублирование партнеров. В том случае, если в личном кабинете amoCRM уже присутствует компания с таким ИНН, то новая компания не создается.

Для получения ID "Поля компаний", необходимо:
Установить Postman с оффициального сайта;

Создать GET запрос: https://{0}.amocrm.ru/api/v4/companies/custom_fields?filter[type][0]=multitext,где {0} - является поддоменом
В Postman, в поле Authorization добавить AMO_CRM_AccessToken; Type: Bearer Token
RR 96.png
После того, как все поля заполнены, нажимаем кнопку "Send", если всё заполнено верно, то в нижней части экрана отобразятся все доступные ID.
AMO_CRM_AccessToken можно найти в используемой базе SQL при помощи запроса:

 SELECT TOP (1000) [SS_ParmName]
      ,[SS_ParmValue]
      ,[SS_UsKey]
      ,[SS_XmlValue]
      ,[SS_Name]
      ,[SS_NameLat]
      ,[SS_Id]
  FROM [Название вашей базы].[dbo].[SystemSettings]
  where [SS_ParmName] like 'AMO%'
После заполнения всех полей Сохраняем настройки, нажимаем кнопку "Сохранить".
После того, как все необходимые настройки будут заполнены — нужно перейти в Службы Windows и перезапустить службу TourSearchOwin (сохраненные настройки применятся в течение 5-10 минут).
Также инструкция по получению полей доступна в документации amoCrm.

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

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


Также информация по установке Roistat доступна на сайте amoCrm.