Что это
Marketing Events API работает с мероприятиями, например вебинарами: сведениями о событии и состояниями участия контактов. Это основа для интеграции вебинарной платформы с CRM.
Различайте внутренний objectId HubSpot и внешние идентификаторы приложения. Также не смешивайте число действий регистрации с текущим состоянием участников: такие показатели могут расходиться без ошибки в данных.
Ключевые параметры
- Категория: Инструменты разработчика
- Сложность: Для разработчика
- Запуск: Около 30 минут
- Open-source: Нет
- Данные: Не известно
- Чувствительные данные: Только с настройками
Сильные стороны
- Связывает мероприятие и участие контактов с CRM.
- Дает доступ по внутреннему ID и внешним идентификаторам при соответствующих условиях.
- Позволяет получать данные участников и сводные показатели для отчетов.
Ограничения
- Внешние ID зависят от приложения, которое создало событие.
- Повторная регистрация и текущее состояние дают разные виды счетчиков.
- Даты, статусы участия и права записи требуют отдельной проверки интеграции.
Как использовать
1. Подготовка. Выберите учебное мероприятие в HubSpot и сохраните его внутренний Record ID. Для первого теста не отправляйте приглашения и не меняйте участников.
2. Настройка. Разрешите приложению crm.objects.marketing_events.read, сохраните токен и используйте Bearer-авторизацию.
3. Первый результат. Выполните GET https://api.hubapi.com/marketing/v3/marketing-events/{objectId}, подставив внутренний ID, и получите описание события.
4. Проверка. Сверьте название и даты с CRM. При подготовке отчета подпишите, считаете ли действия или текущее состояние участников. Перед записью отдельно проверьте внешние ID, временные зоны и повторную обработку события.
Доступ и оплата
- Модель оплаты: Не уточнено
- Работа в РФ: Нужно проверять
- VPN: Не известно
- Русский интерфейс: Не известно
- Русский язык: Не известно
Проверьте доступ конкретного аккаунта и лимиты нужного метода. Наличие API не делает платный продукт бесплатным. Секреты храните на сервере, а не в браузерном коде.
Когда не подходит
- Считать регистрацию фактическим посещением
- Автоматически рассылать сообщения без согласия
- Подменять внешний ID внутренним ID HubSpot
Альтернативы
Zoom API получает данные своей платформы вебинаров; HubSpot CRM API работает с другими объектами; Google Sheets API дает простую таблицу отчета. Ни один из этих вариантов сам по себе не заменяет синхронизацию Marketing Events.
