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

[досмотренная версия]

Версия 11:56, 2 октября 2023

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

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

Содержание

1 Введение
2 Настройка
- 2.1 Подключение amoCRM
- 2.2 Подключение в Программах Тура

Введение

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

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

Настройка

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

В появившемся окне выбираем группу полей, называем её "Мастер–Тур", и нажимаем Добавить.

Переходим к разделу "Настройка свойств полей и групп", и нажимаем кнопку Добавить поле (список полей и их формат указан ниже).

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

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

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

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

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

Номер путевки (id поля Номер путевки МТ), тип поля – текстовый;
Roistat (id поля), тип поля – текстовый;
Дата заезда (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 Email контакта (любой enum для поля Email контакта из раздела contacts/list->custom_fields), тип поля – текстовый
Телефон контакта (id поля из раздела contacts/list->custom_fields), тип поля – текстовый
Enum Телефон контакта (любой enum для поля Телефон контакта из раздела contacts/list->custom_fields), тип поля – текстовый
Email компании (id поля из раздела custom_fields->company), тип поля – текстовый
Enum Email компании (любой enum для поля Email компании из раздела company/list->custom_fields), тип поля – текстовый
Телефон компании (id поля из раздела company/list->custom_fields), тип поля – текстовый
Enum Телефон компании (любой enum для поля Телефон компании из раздела company/list->custom_fields), тип поля – текстовый
ИНН компании (id поля из раздела custom_fields->company), тип поля – текстовый
- По этому полю происходит проверка на дублирование партнеров. В том случае, если в личном кабинете amoCRM уже присутствует компания с таким ИНН, то новая компания не создается.
Сохраняем настройки, нажимаем кнопку "Сохранить".
После того как все необходимые настройки будут заполнены — нужно перейти в Службы Windows и перезапустить службу TourSearchOwin (сохраненные настройки применятся в течение 5-10 минут).

@@ Строка 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.3 версии<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 передается только информация по новым заявкам. Изменения по заявкам – не передаются.
@@ Строка 9: / Строка 14: @@
 == Настройка ==
-Описание настроек необходимых для корректного обмена данными.
 ===Подключение 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>
-* '''Авторизоваться в amoCRM''' по адресу  https://{Ваш домен}.amocrm.ru/leads/list/
+Авторизоваться в CRM у клиента https://{0}.amocrm.ru, где {0} - это клиентский поддомен.</BR>
-[[Файл:RR 37.png|x400px]]<BR>
+[[Файл:RR 37.png|x400px]]</BR>
-* '''Перейти в раздел "Сделки",''' в меню, в левой части экрана amoCRM
+Перейти на страницу Сделки по адресу https://{0}.amocrm.ru/leads, где {0} - это клиентский поддомен.</BR>
-[[Файл:RR 44.png|x400px]]<BR>
+[[Файл:Ea_416.png|x800px]]</BR>
-* Перейти на страницу "Сделки" нажать на кнопку "+НОВАЯ СДЕЛКА". Далее перейти на вкладку "Настроить".
+Нажать на кнопку '''+НОВАЯ СДЕЛКА'''.</BR>
-<BR>
+[[Файл:ep_217.png|x400px]]</BR>
-[[Файл:ep_217.png|x400px]]<BR>
-* Будет открыто окно, в  котором заводятся необходимые свойства сделок при нажатии кнопки "+Добавить поле". (Пример: Название заявки, roistatID, Дата заезда, Дата выезда и т.д.)
-<BR>
-[[Файл:ep_218.png|x400px]]<BR>
-<BR>
- После добавления поля можно посмотреть его ID в окне '''Настройка свойств полей и групп'''
+Перейти на вкладку '''Настроить'''.</BR>
-<BR>
+[[Файл:RR 56.png|x400px]]</BR>
-[[Файл:ep_220.png|x400px]]<BR>
-* '''Переходим в Турпрограммы > Администрирование > Настройки > Настройки интеграции с amoCRM''' и заполняем следующие поля:
+Нажать на кнопку '''+'''.</BR>
+[[Файл:RR 57.jpg|x400px]]</BR>
+В появившемся окне выбираем группу полей, называем её "Мастер–Тур", и нажимаем '''Добавить'''.</BR>
+[[Файл:RR 58.png|x400px]]</BR>
-'''Обязательные поля для интеграции:'''
+Переходим к разделу "Настройка свойств полей и групп", и нажимаем кнопку '''Добавить поле''' (список полей и их формат указан ниже).</BR>
-# Включение чекбокса "Включение отправки заявок", если чекбокс не проставлен, то данные по путевке в amoCRM передаваться не будут;
+[[Файл:RR 59.png|x400px]]</BR>
-# Логин пользователя amoCRM для отправки запросов в систему amoСRМ;
+После добавления поля можно посмотреть его ID в окне '''Настройка свойств полей и групп''' (нажав на нужное поле).</BR>
-# Хеш-пароль – API ключ (указан в профиле клиентского amoСRМ);
+[[Файл:ep_220.png|x400px]]<BR>
-# Subdomain (поддомен клиентского модуля amoСRМ, пример: https://amberregion.amocrm.ru/ где amberregion - является поддоменом);
-# ID интеграции;
-# Секрет интеграции;
-# Redirect URI;
-# Код авторизации;
-# '''Авторизация в amoCRM (необходимо нажать, после зазполнения все обязательных полей)''';
-# Статус (id статуса, под которым будут приходить сделки в amoСRМ из раздела leads/list).
+Далее '''Переходим в Турпрограммы → Администрирование → Настройки → Настройки интеграции с amoCRM''' и заполняем необходимые поля.</BR>
+Обязательные поля для интеграции:
+* '''Включение чекбокса "Включение отправки заявок"''', если чекбокс не проставлен, то данные по путевке в amoCRM передаваться не будут;
+* '''Логин''' пользователя amoCRM для отправки запросов в систему amoСRМ;
+* '''Хеш-пароль''' – пароль (пароль от профиля клиентского amoСRМ);
+* '''Subdomain''' (поддомен клиентского модуля amoСRМ, пример: https://{0}.amocrm.ru/leads, где {0} - является поддоменом);
+* '''ID интеграции''';
+* '''Секрет интеграции''';
+* '''Redirect URI''' – адрес службы TourSearchOwin;
+* '''Код авторизации''';
+* '''Статус''' (id статуса, под которым будут приходить сделки в amoСRМ).</BR>
+После заполнения обязательных полей нужно нажать кнопку '''Авторизация в amoCRM'''.</BR>
 [[Файл:RR 50.png|x400px]]<BR>
+[[Файл: mb_030.png|left|Предупреждение]]
-  Индивидуальные поля из раздела leads/list->custom_fields. Должны иметь только указанный тип поля, в противном случае данные не будут переданы
+  Заполняемые далее индивидуальные поля должны иметь только указанный тип поля, в противном случае данные не будут переданы.</BR>
-* '''Номер путевки''' (id поля Номер путевки МТ из раздела leads/list->custom_fields), тип поля – текстовый;
+<BR></BR>
-* '''Roistat''' (id поля из раздела leads/list->custom_fields), тип поля – текстовый;
+* '''Номер путевки''' (id поля Номер путевки МТ), тип поля – текстовый;
+* '''Roistat''' (id поля), тип поля – текстовый;
 * '''Дата заезда''' (id поля Точная дата вылета из раздела leads/list->custom_fields), тип поля – дата;
 * '''Дата выезда''' (id поля Точная дата возврата из раздела leads/list->custom_fields), тип поля – дата;
@@ Строка 84: / Строка 100: @@
 ** В том случае, если нет маршрутной услуги или включен признак ''Наземное обслуживание'', то в личном кабинете amoCRM в поле ''Город вылета'' будет отображаться значение ''Без перелета''.
 ** В том случае, если город вылета будет не найден, то в личном кабинете amoCRM поле ''Город вылета'' не будет заполнено, а данное значение будет отображаться в поле ''Другой город вылета'' (тип поля – текстовый).
 * '''Имя туристов''' (id поля из раздела leads/list->custom_fields), тип поля – текстовый
 * '''Курорт''' (id поля из раздела leads/list->custom_fields), тип поля – текстовый
@@ Строка 99: / Строка 114: @@
 * '''ИНН компании''' (id поля из раздела custom_fields->company), тип поля – текстовый
 ** По этому полю происходит проверка на дублирование партнеров. В том случае, если в личном кабинете amoCRM уже присутствует компания с таким ИНН, то новая компания не создается.
 * '''Сохраняем настройки,''' нажимаем кнопку "Сохранить".
 * После того как все необходимые настройки будут заполнены — нужно '''перейти в Службы Windows и перезапустить службу TourSearchOwin''' (сохраненные настройки применятся в течение 5-10 минут).

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

Версия 11:56, 2 октября 2023

Содержание

Введение

Настройка

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

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

Навигация

Персональные инструменты

Пространства имён

Варианты

Просмотры

Ещё

Поиск

Навигация

Инструменты