Какой доступ запрашивает Renta?

Renta запрашивает доступ только на чтение к объектам CRM — контактам, компаниям, сделкам, тикетам, активностям (звонки, встречи, заметки, задачи) и владельцам. Вы подтверждаете доступ на шаге авторизации в HubSpot и можете отозвать его в любой момент.

Синхронизируются ли пользовательские свойства?

Да, автоматически. Renta находит пользовательские свойства вашего портала в начале каждого запуска и записывает их в колонку **custom_fields_values**. Свойства, добавленные в HubSpot после настройки, появятся при следующей синхронизации без дополнительной настройки.

Можно ли синхронизировать только часть объектов?

Да. Выберите тип интеграции **Custom report** и укажите один тип отчёта на пайплайн, либо используйте вариант **Pre-built templates**, чтобы загрузить все объекты сразу.

HubSpot

Извлекайте данные CRM из HubSpot и загружайте их напрямую в ваше хранилище данных с помощью Renta. Объедините контакты, компании, сделки, тикеты, активности и владельцев для отчётности по воронке продаж, атрибуции и продвинутой аналитики — без единой строки кода.

Аутентификация

Renta использует OAuth для аутентификации в HubSpot. Это обеспечивает безопасный доступ без передачи вашего пароля напрямую. Вы будете перенаправлены в HubSpot, чтобы предоставить Renta ограниченный доступ к вашему аккаунту.

Ваши учётные данные шифруются при передаче и хранении и находятся в отдельном защищённом хранилище, изолированном от ваших данных. Renta обновляет доступ автоматически, поэтому подключение работает без повторной авторизации. Контроль остаётся за вами: вы можете отозвать доступ в HubSpot в любой момент.

Подключение источника HubSpot

Выполните следующие шаги, чтобы добавить HubSpot в качестве источника в Renta с помощью аутентификации OAuth.

Перейдите в SourcesStep 1

Перейдите в раздел Connections > Sources в левом боковом меню.
Нажмите + Add source в правом верхнем углу.

Список источников Renta с кнопкой Add source

Выберите HubSpotStep 2

Откройте категорию CRM и нажмите карточку HubSpot, чтобы открыть форму подключения.

Карточка HubSpot в категории CRM каталога Renta

Авторизуйте подключениеStep 3

Нажмите Log in to your HubSpot account. Вы будете перенаправлены в HubSpot для авторизации подключения.

Страница авторизации подключения HubSpot в Renta

Выберите аккаунт HubSpotStep 4

На экране авторизации HubSpot выберите аккаунт, который хотите подключить, и нажмите Choose Account. После подтверждения доступа вы вернётесь в Renta.

Укажите имя подключения и сохранитеStep 5

Завершите настройку:

Source name.
Укажите имя источника данных. Оно используется исключительно в интерфейсе Renta.
Access granted.
Убедитесь, что аккаунт успешно подключён.

Нажмите Save, чтобы завершить. Новый источник появится в списке источников.

Настройка подключения HubSpot с именем источника и предоставленным доступом

Создание пайплайна

После подключения источника создайте пайплайн, чтобы синхронизировать данные HubSpot в ваше назначение.

Создание пайплайна HubSpot

Свяжите источник HubSpot с назначением и настройте пайплайн.

Начните новый пайплайнStep 1

В левом боковом меню нажмите New pipeline.

Выберите HubSpot в качестве источникаStep 2

На шаге Source выберите HubSpot в разделе Already connected и нажмите Next step.

Шаг выбора источника с HubSpot в разделе Already connected

Выберите подключение HubSpotStep 3

Выберите подключение HubSpot, созданное ранее, и нажмите Next step.

Выберите назначениеStep 4

На шаге Destination выберите назначение (например, Google BigQuery) и нажмите Next step.

Выберите подключение назначенияStep 5

Выберите подключение назначения, в которое нужно загрузить данные, и нажмите Next step.

Настройка пайплайна

На последнем шаге настройте, как Renta извлекает и загружает данные HubSpot.

Тип интеграции

Выберите, как настроить ваш пайплайн данных.

Тип	Описание
Custom report	Настройте набор данных вручную. Рекомендуется опытным пользователям, которым нужен полный контроль над типом отчёта и полями.
Pre-built templates	Используйте готовые модели данных для настройки интеграции с минимальной конфигурацией.

Шаблон HubSpot — all objects создаёт по одной интеграции на каждый тип отчёта со всеми доступными полями — быстрый способ реплицировать всю CRM за один шаг.

Типы отчётов

Выберите объект HubSpot, который хотите выгрузить. Каждый тип отчёта соответствует одной таблице в назначении.

Тип отчёта	Объект HubSpot	Описание
Contacts	contacts	Люди в вашей CRM — со стадией жизненного цикла, владельцем и контактными данными.
Companies	companies	Записи компаний — с отраслью, выручкой, владельцем и доменом.
Deals	deals	Сделки — с суммой, стадией, воронкой и датой закрытия.
Tickets	tickets	Тикеты поддержки — с воронкой, стадией, приоритетом и категорией.
Calls	calls	Звонки — с направлением, длительностью, результатом и владельцем.
Meetings	meetings	Встречи — с названием, временем начала и окончания, результатом.
Notes	notes	Заметки, привязанные к записям CRM.
Tasks	tasks	Задачи — с темой, статусом, приоритетом и типом.
Owners	owners	Пользователи HubSpot — для связи с полем hubspot_owner_id на других объектах.
Deal pipelines	deal_pipelines	Определения воронок и стадий сделок, включая вложенный массив stages.

Параметры

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

Поле id записи и поле даты последнего изменения включаются всегда, даже если вы их не выбрали, поскольку они нужны Renta для инкрементальной загрузки. Пользовательские свойства добавляются автоматически — см. раздел Пользовательские свойства ниже.

Диапазон дат

Укажите исторический период, за который нужно получить данные из HubSpot.

Renta фильтрует записи по дате их изменения, поэтому синхронизация охватывает всё, что создано или обновлено в выбранном окне. Оставьте дату окончания Today, чтобы продолжать получать последние изменения.

Расписание

Выберите, как часто запускается пайплайн.

Настройки диапазона дат и расписания HubSpot

Тип расписания	Описание
Manual	Пайплайн запускается только вручную через интерфейс или по API.
Daily	Пайплайн запускается раз в день в указанное время обновления.
Interval	Пайплайн запускается через заданные интервалы времени.
Cron Expression	Пайплайн запускается по расписанию, заданному cron-выражением.

Для расписания Daily задайте Update time — точное время начала каждого запуска — и нажмите Create pipeline.

Тип расписания и время обновления HubSpot с кнопкой Create pipeline

Renta также поддерживает запуск по API и интеграцию с внешними оркестраторами, такими как Apache Airflow, Dagster и Prefect. Подробности см. в полной документации по планированию.

Стратегия синхронизации

В таблице ниже описано, как Renta синхронизирует каждый тип отчёта HubSpot.

Стратегия	Поддерживаемые типы отчётов	Описание
Инкрементальная (merge)	Contacts, Companies, Deals, Tickets, Calls, Meetings, Notes, Tasks, Owners	Renta получает только записи, изменённые с момента последнего запуска, фильтруя по дате последнего изменения объекта (`hs_lastmodifieddate`, либо `lastmodifieddate` для контактов и `updated_at` для владельцев). Записи добавляются в назначение методом upsert по уникальному `id`, а таблицы партиционируются по дню создания записи.
Полная перезагрузка	Deal pipelines	У определений воронок и стадий нет поля даты изменения, поэтому Renta перезагружает весь набор данных при каждом запуске. Таблица небольшая, поэтому влияние на производительность незначительно.

Инкрементальный upsert требует назначения с поддержкой merge, такого как Google BigQuery или ClickHouse. На других назначениях Renta выполняет полную перезапись выбранного диапазона дат.

Пользовательские свойства

HubSpot позволяет администраторам добавлять пользовательские свойства к контактам, компаниям, сделкам, тикетам и активностям. Renta захватывает все пользовательские свойства автоматически — ручная настройка схемы не требуется.

Значения пользовательских свойств хранятся в колонке custom_fields_values в виде структурированного массива. Каждый элемент массива содержит:

Подполе	Описание
field_name	Внутреннее имя свойства HubSpot, например lead_source_detail.
field_label	Читаемая метка, настроенная в HubSpot, например «Lead source detail».
field_type	Тип данных свойства, заданный в HubSpot: string, number, enumeration, datetime и т. д.
field_value	Значение свойства для этой записи, хранится как строка.

Чтобы запросить пользовательские свойства в BigQuery, разверните массив и отфильтруйте по имени свойства:

SELECT
  id,
  dealname,
  cf.field_label AS custom_label,
  cf.field_value AS custom_value
FROM `project.dataset.deals` d,
UNNEST(custom_fields_values) AS cf
WHERE cf.field_name = 'lead_source_detail';

Часто задаваемые вопросы

Ready to get started?

Build your data pipeline today or get a personalized demo. Start free!

Need help?

Get expert support to ensure your project succeeds. We're here to help!

Feature requests?

Help shape our product! Share your ideas for new features and integrations.