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

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

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

• Передавать из Hollihop данные о новых заявках на обучение и новых платежах в вашу CRM. 
• Вовремя получать информацию о новых лидах и изменению их статусов.
• Создавать в Hollihop новых учеников и лиды, автоматически менять их статусы. 
• Добавлять учеников в учебные единицы, создавать пробные занятия.
• Создавать и обновлять данные о платежах и поступлениях на личных счетах учеников.

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

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

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

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

3. Нажимаем «Далее». В новом окне видим справочники из нашей 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. Данные попадают туда по мере того, как вы используете их в учебных единицах и добавляете информацию. Если список устарел, нажмите на кнопку «Обновить».