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

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

Версия 19:42, 29 сентября 2023

Версия статьи от 29-09-2023.

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


Введение

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

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


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



Настройка

Описание настроек необходимых для корректного обмена данными.

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

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

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

RR 37.png

RR 52.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

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

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

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

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

RR 37.png

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

RR 52.png

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

Ep 217.png

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

RR 56.png

  • Нажимаем на кнопку "+";

RR 57.jpg

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

RR 58.png

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

RR 59.png

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

Ep 220.png

  • Переходим в Турпрограммы → Администрирование → Настройки → Настройки интеграции с amoCRM и заполняем следующие поля:

Обязательные поля для интеграции:

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

RR 50.png

Индивидуальные поля из раздела leads/list->custom_fields. Должны иметь только указанный тип поля, в противном случае данные не будут переданы

  • Номер путевки (id поля Номер путевки МТ из раздела leads/list->custom_fields), тип поля – текстовый;
  • Roistat (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), тип поля – мультисписок;
  • Город вылета (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 минут).
Источник — «http://wiki.megatec.ru/index.php?title=Мастер-Тур(15):_Интеграция_с_amoCRM_(15_версия)&oldid=29838»