API и вебхуки Hollihop
Подключите внешний сервис к данным CRM или передавайте события из Hollihop в собственную систему. Разработчику доступны описание методов API и отдельная документация вебхуков.
Что умеет интеграция
Чтение и запись данных
В API 2.0 описаны методы получения и изменения данных. Допустимые параметры и результат нужно проверять для каждого метода.
Заявки с сайта
Метод AddStudyRequest позволяет передать заявку в CRM. Для готовых форм и Tilda есть отдельные варианты подключения.
События из CRM
Вебхуки сообщают внешнему обработчику о настроенных событиях лидов и учеников: например, создании, смене статуса или оплате счёта.
Своя логика обмена
Получив событие, внешний сервис может запросить нужные данные через API. Набор действий и обработку ошибок проектирует разработчик.
Подключаемые сервисы
Hollihop API 2.0
Основная документация методов. Авторизация передаётся через authkey; настройки ключей находятся в разделе интеграции API.
Документация APIВебхуки
Документация событий и параметров обработчика: тип события, тип объекта и его идентификатор.
Документация вебхуковЗаявки с сайта
Описание AddStudyRequest: контактные данные, дополнительные поля и UTM-метки заявки.
Документация заявокАльбато
В каталоге Альбато есть Hollihop. Доступные действия и условия конкретного сценария проверяйте в карточке сервиса перед настройкой.
Карточка в каталоге АльбатоИсточники проверены .
Как подключить
Опишите данные и событие
Определите, что передаётся, какая система является источником и когда должен выполняться обмен.
Выберите методы
Сопоставьте задачу с документацией API. Для исходящих событий CRM проверьте подходящий вебхук и параметры обработчика.
Настройте доступ
Создайте нужный ключ и обработчик. Ключи, открывающие конфиденциальные данные, храните на сервере внешнего приложения.
Проверьте обмен
Проверьте результат на тестовых данных, обработку ошибок и повторных событий. После проверки включите сценарий для рабочих данных.
Для обычной формы заявки сначала посмотрите готовые способы подключения сайта. Если нужна собственная логика, подготовьте описание данных и ожидаемого результата для оценки доработки через API.
На каких тарифах работает
Доступность API берётся из таблицы тарифов Hollihop. Разработка и сопровождение собственного подключения оцениваются отдельно. У Альбато действуют собственные условия использования.
| Возможность | Микро | Класс | Плюс | Профи |
|---|---|---|---|---|
| Доступ к API | ✓ | ✓ | ✓ | ✓ |
Частые вопросы
Где взять ключ API?
В настройках интеграции Hollihop, раздел API. В документации каждого метода указаны требования к авторизации.
Можно вызывать API прямо из браузера?
Технически часть методов это допускает, но ключ в клиентском коде будет виден посетителю. Для доступа к конфиденциальным данным используйте серверную сторону; рекомендации есть в документации API.
Что передаёт вебхук автодействия?
Тип события, тип объекта и идентификатор лида или ученика. Если нужны подробные данные, обработчик запрашивает их отдельным вызовом API.
Нужен ли разработчик для подключения Tilda?
В Холлипедии есть готовая инструкция подключения форм Tilda через вебхук. Начните со страницы форм сайта; собственный сценарий API нужен для других требований.
Разберём подключение для вашего центра
Покажите, какими сервисами вы пользуетесь и какую задачу хотите решить. На демо обсудим подходящую схему работы.