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

Материал из Megatec
Перейти к: навигация, поиск
[досмотренная версия][досмотренная версия]
(→‎Подключение в Программах Тура)
(→‎Подключение в Программах Тура)
(не показаны 4 промежуточные версии этого же участника)
Строка 4: Строка 4:
  
 
'''Работает модуль следующим образом''' — при бронировании путевки из онлайна или оформления клиентов, все необходимые данные  передаются в amoCRM, для дальнейшей работы с клиентом и статистического учета (даты тура, стоимость, данные о покупателе и т.п.).
 
'''Работает модуль следующим образом''' — при бронировании путевки из онлайна или оформления клиентов, все необходимые данные  передаются в amoCRM, для дальнейшей работы с клиентом и статистического учета (даты тура, стоимость, данные о покупателе и т.п.).
 +
[[Файл: mb_030.png|left|Предупреждение]] <BR>
 +
В amoCRM передается только информация по новым заявкам. Изменения по заявкам – не передаются.
 +
<br /><br />
  
 
== Настройка ==
 
== Настройка ==
Строка 10: Строка 13:
 
===Подключение amoCRM===
 
===Подключение amoCRM===
 
Для того чтобы подключить amoCRM '''необходимо проделать следующие действия:'''
 
Для того чтобы подключить amoCRM '''необходимо проделать следующие действия:'''
−
* Авторизоваться в amoCRM по адресу  https://{Ваш домен}.amocrm.ru/leads/list/
+
* Авторизоваться в amoCRM по адресу  https://{Ваш домен}.amocrm.ru/leads/list/;
 
[[Файл:RR 37.png|x400px]]<BR>
 
[[Файл:RR 37.png|x400px]]<BR>
−
* Перейти на страницу https://{Ваш домен}.amocrm.ru/amo-market
+
* Перейти на страницу https://{Ваш домен}.amocrm.ru/amo-market;
 
[[Файл:Rr 39.png|x400px]]<BR>
 
[[Файл:Rr 39.png|x400px]]<BR>
−
* В правом верхнем углу экрана https://{Ваш домен}.amocrm.ru/amo-market '''нажать на кнопку "...", затем нажать кнопку "Создать интеграцию"'''
+
* В правом верхнем углу экрана https://{Ваш домен}.amocrm.ru/amo-market '''нажать на кнопку "...", затем нажать кнопку "Создать интеграцию"''';
 
[[Файл:RR 40.png|x70px]]<BR>
 
[[Файл:RR 40.png|x70px]]<BR>
−
* В появившемся окне '''выбираем "Внешняя интеграция"'''
+
* В появившемся окне '''выбираем "Внешняя интеграция"''';
 
[[Файл:RR 41.png|x400px]]<BR>
 
[[Файл:RR 41.png|x400px]]<BR>
 
* В окне создания интеграции '''заполняем следующие поля:'''
 
* В окне создания интеграции '''заполняем следующие поля:'''
−
# В первом поле указываем адрес службы TourSearchOwin
+
# В первом поле указываем адрес службы TourSearchOwin;
−
# Второе поле заполнять не нужно
+
# Второе поле заполнять не нужно;
−
# В третьем поле выбираем "Предоставить доступ: Все"
+
# В третьем поле выбираем "Предоставить доступ: Все";
−
# В следующем поле ставим чекбоксы в настройках: Контроль дублей и Множественные источники
+
# В следующем поле ставим чекбоксы в настройках: Контроль дублей и Множественные источники;
−
# В поле "Язык" указываем: Русский
+
# В поле "Язык" указываем: Русский;
−
# Заполняем поля "Название" и "Описание" (в названии пишем - Мастер-Тур, в описании - интеграция с Мастер-Тур)
+
# Заполняем поля "Название" и "Описание" (в названии пишем - Мастер-Тур, в описании - интеграция с Мастер-Тур);
−
# '''Нажимаем кнопку "Сохранить"''', чтобы сохранить изменения
+
# '''Нажимаем кнопку "Сохранить"''', чтобы сохранить изменения;
 
[[Файл:RR 42 .png|x400px]]<BR>
 
[[Файл:RR 42 .png|x400px]]<BR>
 
* Переходим в https://{Ваш домен}.amocrm.ru/amo-market и проверяем создание интеграции.
 
* Переходим в https://{Ваш домен}.amocrm.ru/amo-market и проверяем создание интеграции.
Строка 56: Строка 59:
  
  
−
* Обязательные поля для интеграции:
+
'''Обязательные поля для интеграции:'''
−
# Логин пользователя для отправки запросов в систему amoСRМ  
+
# Включение чекбокса "Включение отправки заявок", если чекбокс не проставлен, то данные по путевке в amoCRM передаваться не будут;
−
# Хеш-пароль – API ключ (указан в профиле клиентского amoСRМ)  
+
# Логин пользователя amoCRM для отправки запросов в систему amoСRМ;
−
# Subdomain (поддомен клиентского модуля amoСRМ из раздела account/current)  
+
# Хеш-пароль – API ключ (указан в профиле клиентского amoСRМ);
−
# Статус (id статуса, под которым будут приходить сделки в amoСRМ из раздела leads/list)
+
# Subdomain (поддомен клиентского модуля amoСRМ, пример: https://amberregion.amocrm.ru/ где amberregion - является поддоменом);
−
# ID интеграции
+
# ID интеграции;
−
# Секрет интеграции
+
# Секрет интеграции;
−
# Redirect URI
+
# Redirect URI;
−
# Код авторизации
+
# Код авторизации;
 +
# '''Авторизация в amoCRM (необходимо нажать, после зазполнения все обязательных полей)''';
 +
# Статус (id статуса, под которым будут приходить сделки в amoСRМ из раздела leads/list).
  
−
* Индивидуальные поля из раздела leads/list->custom_fields. Должны иметь только указанный тип поля, в противном случае данные не будут переданы
+
[[Файл:RR 50.png|x400px]]<BR>
−
** Номер путевки (id поля Номер путевки МТ из раздела leads/list->custom_fields), тип поля – текстовый
+
 
−
** Roistat (id поля из раздела leads/list->custom_fields), тип поля – текстовый
+
Индивидуальные поля из раздела leads/list->custom_fields. Должны иметь только указанный тип поля, в противном случае данные не будут переданы
−
** Дата заезда (id поля Точная дата вылета из раздела leads/list->custom_fields), тип поля – дата
+
* '''Номер путевки''' (id поля Номер путевки МТ из раздела 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), тип поля – мультисписок
+
* '''Продолжительность''' (id поля Продолжительность тура из раздела leads/list->custom_fields), тип поля – текстовый;
−
*** Городом вылета считается город вылета по первой услуге авиаперелета в путевке.
+
* '''Страна''' (id поля из раздела leads/list->custom_fields), тип поля – мультисписок;
−
*** В том случае, если нет маршрутной услуги или включен признак ''Наземное обслуживание'', то в личном кабинете amoCRM в поле ''Город вылета'' будет отображаться значение ''Без перелета''.
+
* '''Город вылета''' (id поля из раздела leads/list->custom_fields), тип поля – мультисписок;
−
*** В том случае, если город вылета будет не найден, то в личном кабинете amoCRM поле ''Город вылета'' не будет заполнено, а данное значение будет отображаться в поле ''Другой город вылета'' (тип поля – текстовый).
+
** Городом вылета считается город вылета по первой услуге авиаперелета в путевке.
−
** Имя туристов (id поля из раздела leads/list->custom_fields), тип поля – текстовый
+
** В том случае, если нет маршрутной услуги или включен признак ''Наземное обслуживание'', то в личном кабинете amoCRM в поле ''Город вылета'' будет отображаться значение ''Без перелета''.
−
** Курорт (id поля из раздела leads/list->custom_fields), тип поля – текстовый
+
** В том случае, если город вылета будет не найден, то в личном кабинете amoCRM поле ''Город вылета'' не будет заполнено, а данное значение будет отображаться в поле ''Другой город вылета'' (тип поля – текстовый).
−
** Количество туристов (дети, взрослые) (id поля из раздела leads/list->custom_fields), тип поля – текстовый
+
 
−
** Email контакта (id поля из раздела custom_fields->contacts), тип поля – текстовый
+
* '''Имя туристов''' (id поля из раздела leads/list->custom_fields), тип поля – текстовый
−
*** По этому полю происходит проверка на дублирование частных лиц. В том случае, если в личном кабинете amoCRM уже присутствует контакт с таким e-mail, то новый контакт не создается.
+
* '''Курорт''' (id поля из раздела leads/list->custom_fields), тип поля – текстовый
−
** Enum (любой enum для поля Email контакта из раздела contacts/list->custom_fields), тип поля – текстовый
+
* '''Количество туристов''' (дети, взрослые) (id поля из раздела leads/list->custom_fields), тип поля – текстовый
−
** Телефон контакта (id поля из раздела contacts/list->custom_fields), тип поля – текстовый
+
* '''Email контакта''' (id поля из раздела custom_fields->contacts), тип поля – текстовый
−
** Enum (любой enum для поля Телефон контакта из раздела contacts/list->custom_fields), тип поля – текстовый
+
** По этому полю происходит проверка на дублирование частных лиц. В том случае, если в личном кабинете amoCRM уже присутствует контакт с таким e-mail, то новый контакт не создается.
−
** Email компании (id поля из раздела custom_fields->company), тип поля – текстовый
+
* '''Enum Email контакта''' (любой enum для поля Email контакта из раздела contacts/list->custom_fields), тип поля – текстовый
−
** Enum (любой enum для поля Email компании из раздела company/list->custom_fields), тип поля – текстовый
+
* '''Телефон контакта''' (id поля из раздела contacts/list->custom_fields), тип поля – текстовый
−
** Телефон компании (id поля из раздела company/list->custom_fields), тип поля – текстовый
+
* '''Enum Телефон контакта''' (любой enum для поля Телефон контакта из раздела contacts/list->custom_fields), тип поля – текстовый
−
** Enum (любой enum для поля Телефон компании из раздела company/list->custom_fields), тип поля – текстовый
+
* '''Email компании''' (id поля из раздела custom_fields->company), тип поля – текстовый
−
** ИНН компании (id поля из раздела custom_fields->company), тип поля – текстовый
+
* '''Enum Email компании''' (любой enum для поля Email компании из раздела company/list->custom_fields), тип поля – текстовый
−
*** По этому полю происходит проверка на дублирование партнеров. В том случае, если в личном кабинете amoCRM уже присутствует компания с таким ИНН, то новая компания не создается.
+
* '''Телефон компании''' (id поля из раздела company/list->custom_fields), тип поля – текстовый
 +
* '''Enum Телефон компании''' (любой enum для поля Телефон компании из раздела company/list->custom_fields), тип поля – текстовый
 +
* '''ИНН компании''' (id поля из раздела custom_fields->company), тип поля – текстовый
 +
** По этому полю происходит проверка на дублирование партнеров. В том случае, если в личном кабинете amoCRM уже присутствует компания с таким ИНН, то новая компания не создается.
  
  
 
* '''Сохраняем настройки,''' нажимаем кнопку "Сохранить".
 
* '''Сохраняем настройки,''' нажимаем кнопку "Сохранить".
 
* После того как все необходимые настройки будут заполнены — нужно '''перейти в Службы Windows и перезапустить службу TourSearchOwin''' (сохраненные настройки применятся в течение 5-10 минут).
 
* После того как все необходимые настройки будут заполнены — нужно '''перейти в Службы Windows и перезапустить службу TourSearchOwin''' (сохраненные настройки применятся в течение 5-10 минут).

Версия 15:38, 26 сентября 2023

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

Введение

Данный модуль позволяет настроить интеграцию программного комплекса Мастер–Тур с CRM системой amoCRM, для оперативного обмена данными и обработки заявок, в режиме реального времени. С его помощью вы сможете повысить эффективность связки amoCRM и Мастер–Тур, и сократить время обработки заявки оператором.

Работает модуль следующим образом — при бронировании путевки из онлайна или оформления клиентов, все необходимые данные передаются в amoCRM, для дальнейшей работы с клиентом и статистического учета (даты тура, стоимость, данные о покупателе и т.п.).

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


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



Настройка

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

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

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

  • Авторизоваться в amoCRM по адресу https://{Ваш домен}.amocrm.ru/leads/list/;

RR 37.png

  • Перейти на страницу https://{Ваш домен}.amocrm.ru/amo-market;

Rr 39.png

  • В правом верхнем углу экрана https://{Ваш домен}.amocrm.ru/amo-market нажать на кнопку "...", затем нажать кнопку "Создать интеграцию";

RR 40.png

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

RR 41.png

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

RR 42 .png

  • Переходим в https://{Ваш домен}.amocrm.ru/amo-market и проверяем создание интеграции.

RR 43.png

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

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

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

  • Авторизоваться в amoCRM по адресу https://{Ваш домен}.amocrm.ru/leads/list/

RR 37.png

  • Перейти в раздел "Сделки", в меню, в левой части экрана amoCRM

RR 44.png

  • Перейти на страницу "Сделки" нажать на кнопку "+НОВАЯ СДЕЛКА". Далее перейти на вкладку "Настроить".


Ep 217.png

  • Будет открыто окно, в котором заводятся необходимые свойства сделок при нажатии кнопки "+Добавить поле". (Пример: Название заявки, roistatID, Дата заезда, Дата выезда и т.д.)


Ep 218.png

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


Ep 220.png

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


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

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

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=29801»