Подключение и возможности интеграции с Hollihop
Hollihop — это CRM-система для учебных центров.
Albato поможет настроить интеграцию Hollihop с сервисом, который вам нужен, автоматизировать процессы и сделать управление учебным центром эффективнее. Например, вы сможете:
Передавать из Hollihop данные о новых заявках на обучение и новых платежах в вашу CRM.
Вовремя получать информацию о новых лидах и изменению их статусов.
Создавать в Hollihop новых учеников и лиды, автоматически менять их статусы.
Добавлять учеников в учебные единицы, создавать пробные занятия.
Создавать и обновлять данные о платежах и поступлениях на личных счетах учеников.
Переходим в аккаунт Albato. Выбираем пункт «Подключения» => «Добавить подключение» => из списка выбираем Hollihop**.**
В новом окне выбираем название для подключения. В поле «Домен» копируем url-адрес нашего учебного центра без «https» и API токен.
Чтобы найти url-адрес, заходим в свой аккаунт и копируем его из адресной строки браузера. API-токен копируем в разделе «Настройки» => «Интеграции» => «API». Для интеграции используем «Общий API-ключ».
Нажимаем «Далее». В новом окне видим справочники из нашей 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. Данные попадают туда по мере того, как вы используете их в учебных единицах и добавляете информацию. Если список устарел, нажмите на кнопку «Обновить».
Albato поможет настроить интеграцию Hollihop с сервисом, который вам нужен, автоматизировать процессы и сделать управление учебным центром эффективнее. Например, вы сможете:
Передавать из Hollihop данные о новых заявках на обучение и новых платежах в вашу CRM.
Вовремя получать информацию о новых лидах и изменению их статусов.
Создавать в Hollihop новых учеников и лиды, автоматически менять их статусы.
Добавлять учеников в учебные единицы, создавать пробные занятия.
Создавать и обновлять данные о платежах и поступлениях на личных счетах учеников.
Инструкция по подключению
Переходим в аккаунт Albato. Выбираем пункт «Подключения» => «Добавить подключение» => из списка выбираем Hollihop**.**
В новом окне выбираем название для подключения. В поле «Домен» копируем url-адрес нашего учебного центра без «https» и API токен.
Чтобы найти url-адрес, заходим в свой аккаунт и копируем его из адресной строки браузера. API-токен копируем в разделе «Настройки» => «Интеграции» => «API». Для интеграции используем «Общий API-ключ».
Нажимаем «Далее». В новом окне видим справочники из нашей 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
Спасибо!