Статьи по теме: Подключения

Подключение и возможности интеграции с Hollihop

Hollihop — это CRM-система для учебных центров.


Albato поможет настроить интеграцию Hollihop с сервисом, который вам нужен, автоматизировать процессы и сделать управление учебным центром эффективнее. Например, вы сможете:


  • Передавать из Hollihop данные о новых заявках на обучение и новых платежах в вашу CRM.

  • Вовремя получать информацию о новых лидах и изменению их статусов.

  • Создавать в Hollihop новых учеников и лиды, автоматически менять их статусы.

  • Добавлять учеников в учебные единицы, создавать пробные занятия.

  • Создавать и обновлять данные о платежах и поступлениях на личных счетах учеников.


Инструкция по подключению


  1. Переходим в аккаунт Albato. Выбираем пункт «Подключения» => «Добавить подключение» => из списка выбираем Hollihop.



  1. В новом окне выбираем название для подключения. В поле «Домен» копируем url-адрес нашего учебного центра без «https» и API токен.



Чтобы найти url-адрес, заходим в свой аккаунт и копируем его из адресной строки браузера. API-токен копируем в разделе «Настройки» => «Интеграции» => «API». Для интеграции используем «Общий API-ключ».



  1. Нажимаем «Далее». В новом окне видим справочники из нашей CRM. Информация в них будет пополняться по мере использования этих справочников в учебных единицах. Нажимаем «Обновить», чтобы синхронизировать с Albato новые значения.



Описание доступных событий и действий


Триггеры, которые можно использовать



1. Новый лид


Позволяет получать и передавать новые лиды из Hollihop в другие сервисы.


Информация о лидах, которую может передавать этот триггер:


  • ID — ID лида

  • Created — Дата создания лида

  • FirstName — Имя

  • LastName — Фамилия

  • MiddleName — Отчество

  • AddressDate — Дата обращения

  • AdSource — Источник

  • Status — Статус

  • Birthday — Дата рождения

  • Phone — Телефон

  • Mobile — Мобильный телефон участника

  • UseMobileBySystem — Пользуется ли мобильным телефоном

  • EMail — Email

  • UseEMailBySystem — Пользуется почтой

  • LearningType — Тип обучения лида

  • Maturity — Возрастная категория

  • Discipline — Дисциплина

  • Level — Уровень

  • AgentName — Контактное лицо

  • AgentLastName — Фамилия контактного лица

  • AgentMiddleName — Отчество контактного лица

  • AgentWhoIs — Кем приходится контактное лицо

  • AgentEMail — Email контактного лица

  • agentUseEMailBySystem — Контактное лицо — пользуется email

  • AgentPhone — Телефон контактного лица

  • AgentMobile — Контактное лицо — мобильный

  • agentUseMobileBySystem — Контактное лицо — Пользуется мобильным

  • OfficesAndCompaniesID — ID Филиала

  • OfficesAndCompaniesName — Наименование филиала

  • AssigneesID — ID ответственного

  • AssigneeName — Имя ответственного

  • StudentClientId — Клиент—ученик, к которому прикреплен лид


2. Новая заявка на обучение


Позволяет получать из Hollihop и передавать в другие сервисы новые заявки на обучение.


Информация о заявках, которую может передавать этот триггер:


  • ID — ID заявки

  • Created — Дата создания

  • Status — Статус

  • Location — Локация

  • Office — Филиал

  • Name — Имя

  • EMail — Электронный адрес

  • Phone — Телефон

  • Birthday — Дата рождения

  • AgentName — Имя контактного лица

  • AgentEMail — Email контактного лица

  • AgentPhone — Телефон контактного лица

  • Discipline — Дисциплина

  • Level — Уровень

  • Maturity — Возрастная категория

  • Teacher — Преподаватель

  • BeginDate — Дата начала

  • EndDate — Дата окончания

  • Weekdays — Желаемые дни недели

  • BeginTime — Желаемое время начала занятий

  • EndTime — Желаемое время окончания занятий

  • Type — Тип занятий

  • Description — Описание

  • ExtraData — Дополнительные данные

  • Source — utm_source

  • Medium — utm_medium

  • Campaign — utm_campaign

  • Term — utm_term

  • Content — utm_content

  • Referrer — Referrer

  • Comment — Комментарий

  • LeadId — ID Лида

  • StudentClientId — Идентификатор клиента—ученика, подтвержденного по заявке


3. Новый платеж


Позволяет получать из Hollihop и передавать в другие сервисы все новые платежи.


Информация о платежах, которую может передавать этот триггер:


  • id — ID платежа

  • types — Тип платежа

  • paidDateFrom — Начальная дата установки для платежа статуса «Оплачено»

  • paidDateTo — Конечная дата установки для платежа статуса «Оплачено»

  • dateFrom — Начальная дата платежа

  • dateTo — Конечная дата платежа

  • dateFrom — Начальная дата платежа

  • officeOrCompanyId — Идентификатор филиала/компании, к которому прикреплен платёж

  • state — Битовая маска состояния платежа

  • clientId — Идентификатор клиента—плательщика

  • Created — Дата и время создания платежа

  • Type — Тип обучения

  • Date — Дата платежа

  • PaidDate — Дата оплаты платежа

  • RequiredPaidDate — Требуемая дата оплаты (срок оплаты)

  • OfficeOrCompanyName — Наименование филиала/компании, к которому прикреплен платёж

  • ClientName — Имя клиента—плательщика

  • Value — Сумма платежа

  • ValueQuantity — Значение суммы числом

  • ValueCurrency — Валюта платежа

  • PaymentMethodId — Идентификатор способа оплаты

  • PaymentMethodName — Наименование способа оплаты

  • Description — Комментарий к платежу


4. Статус лида изменен


Позволяет отслеживать и передавать в другие сервисы лиды, у которых изменился статус.


Информация о лидах, которую может передавать этот триггер:


  • LeadId — ID Лида

  • DateTime — Дата и время смены статуса в UTC

  • BeforeId — ID предыдущего статуса лида

  • BeforeName — Название предыдущего статуса

  • AfterId — ID текущего статуса

  • AfterName — Название текущего статуса


Максимальный интервал для запросов новой информации — 5 минут.


Все поля, которые передаются триггером, можно использовать в фильтре.


Например, если в фильтре триггера «Новый лид» для параметра «Discipline» вы зададите значение «Английский», то получите только новые лиды с дисциплиной «Английский», а не все новые лиды.


Действия, которые можно использовать



Действия помогут создавать, обновлять или изменять разные сущности и объекты в Hollihop.


1. Добавить нового ученика


Позволяет передавать данные об учениках из других сервисов в Hollihop, и создавать новых.


Информация об учениках, которую можно передавать:


  • firstName — Имя

  • middleName — Отчество

  • lastName — Фамилия

  • gender — Пол

  • birthday — Дата рождения

  • age — Возраст

  • status — Статус

  • discipline — Дисциплина

  • level — Уровень

  • maturity — Наименование возрастной категории

  • learningType — Наименование типа обучения

  • comment — Комментарий

  • studyRequestId — Идентификатор заявки для созданного ученика

  • ClientId — Client Id

  • officeOrCompanyId — ID филиала


2. Создать лид


Позволяет передавать данные из других сервисов в Hollihop, и создавать новые лиды.


Информация о лидах, которую можно передавать:


  • firstName — Имя

  • middleName — Отчество

  • lastName — Фамилия

  • gender — Пол

  • birthday — Дата рождения

  • age — Возраст

  • officeOrCompanyId — Идентификатор филиала или компании

  • status — Наименование статуса лида

  • discipline — Наименование дисциплины

  • level — Уровень

  • maturity — Наименование возрастной категории

  • learningType — Наименование типа обучения

  • comment — Комментарий к лиду

  • studyRequestId — Идентификатор заявки для лида

  • LeadId — ID лида


3. Добавить платеж (приход на ЛС)


Позволяет передавать информацию о новых платежах из других сервисов в Hollihop.


Информация о платежах, которую можно передавать:


  • clientId — Идентификатор клиента (ученика/компании)

  • officeOrCompanyId — Идентификатор филиала/компании

  • date — Дата платежа

  • value — Сумма и валюта платежа

  • paymentMethodId — Идентификатор способа оплаты

  • state — Статус платежа

  • description — Описание

  • requiredPaidDate — Требуемая дата оплаты

  • paidDate — Дата оплаты платежа (приёма средств)

  • paidEmployeeId — Идентификатор принявшего платёж сотрудник

  • notifyClient — Уведомить клиента об успешной оплате или выставлении счёта

  • Id — Id платежа


4. Обновить платеж


Позволяет обновлять данные о платежах и приходах в Hollihop и менять их статус.


Информация о платежах, которую можно передавать:


  • id — Идентификатор платежа

  • state — Статус платежа

  • description — Комментарий

  • cheque Number — Номер добавляемого к платежу чека

  • acquiring — Оплата произведена через эквайринг


5. Добавить оплату за учебную единицу (расхода с ЛС)


Позволяет добавлять оплату за учебные единицы с лицевых счетов учеников.


Информация об оплатах, которую можно передавать:


  • clientId — Идентификатор клиента

  • edUnitId — Идентификатор учебной единицы

  • date — Дата платежа

  • priceId — Идентификатор цены

  • beginDate — Начальная дата диапазона оплачиваемых занятий

  • multiplier — Множитель целой (не частичной) пакетной оплаты.

  • units — Количество единиц для почасовой или частичной пакетной оплаты

  • description — Комментарий к оплате

  • validDate — Дата, после которой оплата считается недействительной

  • studyPaymentId — Идентификатор прихода

  • notifyClient — Уведомить клиента об успешной оплате или выставлении счёта

  • Id — Идентификатор добавленной оплаты

  • Value — Сумма оплаты


6. Создать ученика из лида


Позволяет создавать новых учеников из лидов в Hollihop.


Информация о лидах, которую нужно передавать:


  • leadId — Идентификатор лида

  • ClientId — Client Id


**7. Изменить статус лида

**

Позволяет изменять статусы лидов. Для этого нужно ввести ID статуса или его название в системе Hollihop.


Информация, которую нужно передавать:


  • LeadId — Идентификатор лида

  • statusId — Идентификатор статуса

  • statusName — Наименование статуса


8. Изменить статус ученика/компании (клиента)


Позволяет изменять статусы учеников. Для этого нужно ввести ID статуса или его название в системе Hollihop.


Информация, которую нужно передавать:


  • clientId — Идентификатор клиента (ученика или компании)

  • statusId — Идентификатор статуса

  • statusName — Наименование статуса


9. Добавить пробный урок


Позволяет создавать пробные уроки для учеников и лидов в Hollihope.


Информация, которую нужно передавать:


  • edUnitId — Идентификатор учебной единицы

  • leadId — Идентификатор лида

  • date — Дата пробного урока

  • comment — Комментарий к пробному уроку


10. Добавить пробный урок


Позволяет добавлять ваших учеников в учебные единицы: экзамены, классы, курсы и т.д.


Информация, которую нужно передавать:


  • edUnitId — Идентификатор учебной единицы

  • studentClientId — Идентификатор клиента-ученика

  • begin — Дата начала занятий

  • end — Дата окончания занятий

  • weekdays — Маска дней недели

  • status — Статус связки

  • priceId — Идентификатор цены

  • comment — Комментарий


Чтобы вам было удобно и просто настроить интеграцию и работать, самые важные справочники будут появляться в действиях в виде выпадающего списка. Это поможет не искать их ID и названия в системе Hollihop.


Справочники можно найти в подключении Hollihop в Albato. Данные попадают туда по мере того, как вы используете их в учебных единицах и добавляете информацию. Если список устарел, нажмите на кнопку «Обновить».


Последнее изменение: 18/10/2022

Была ли эта статья полезна?

Поделиться отзывом

Отменить

Спасибо!