HubSpot
Renta отправляет строки из вашего хранилища данных в HubSpot как записи CRM: контакты, компании, сделки, тикеты, товары, позиции заказа, квоты, а также активности типа заметок, звонков, задач и встреч.
Один пайплайн пишет в один тип объекта. Строка несёт свойства этой записи, а свойство, по которому идёт сопоставление, решает, обновит HubSpot существующую запись или создаст новую.
Аутентификация
Renta авторизуется через HubSpot OAuth. Авторизация действует на один портал, поэтому выберите тот аккаунт HubSpot, в который будет писать пайплайн.
HubSpot запрашивает чтение и запись по контактам, компаниям, сделкам, позициям заказа и квотам вместе со схемами их свойств, а также доступ к владельцам, спискам, тикетам и данным e-commerce. Схемы Renta читает, чтобы заполнить списки в маппинге, а записи пишет при доставке данных.
Подключение назначения HubSpot
- Перейдите в раздел Connections > Catalog в левом меню и откройте вкладку Destinations.
- Откройте категорию Reverse ETL и нажмите карточку HubSpot.
Нажмите Log in to your HubSpot account. HubSpot откроется в этой же вкладке.
Выберите аккаунт HubSpot для синхронизации и нажмите Choose Account. На следующем экране просмотрите список прав и подтвердите. HubSpot вернёт вас в Renta.
Renta подтвердит выданный доступ и покажет авторизованный аккаунт. Завершите настройку:
- Destination name.
Укажите имя назначения. Оно используется только в интерфейсе Renta.
Нажмите Save.
Новое назначение появится в списке Destinations со статусом Active. Теперь его можно использовать в пайплайнах Reverse ETL.
Подготовка модели данных
Пайплайн Reverse ETL читает данные из модели данных: это SQL-запрос, сохранённый в разделе Data models, который решает, какие строки хранилища синхронизировать и что лежит в каждой строке. Создайте её до пайплайна, потому что списки в маппинге заполняются колонками м одели.
Называйте колонки так же, как свойства HubSpot, которые собираетесь заполнять. Тогда маппер сопоставит их один к одному, а сам пайплайн потом будет проще читать.
-- Контакты, подготовленные для HubSpot. Запрос возвращает строки, таблица не создаётся.
WITH demo_contacts AS (
SELECT
'james.miller@example.com' AS email,
'James' AS firstname,
'Miller' AS lastname,
'+12125550101' AS phone,
'Vertex Analytics' AS company,
'Head of Marketing' AS jobtitle,
'New York' AS city,
'United States' AS country,
'customer' AS lifecyclestage
UNION ALL SELECT 'olivia.johnson@example.com','Olivia','Johnson','+13125550102','Lakeshore Media','CTO','Chicago','United States','lead'
UNION ALL SELECT 'william.davis@example.com','William','Davis','+12145550103','Cedar Supply Co','Analyst','Dallas','United States','customer'
)
SELECT * FROM demo_contactsСоздание модели данных
В левом меню откройте Data models и нажмите New model. Затем:
- Source.
Выберите подключение хранилища, к которому пойдёт запрос. - Write your model query.
Вставьте свой SQL. Тип запроса оставьте SQL query. - Run preview.
Проверьте строки и названия колонок. Когда результат устраивает, нажмите Next step.
Для модели, которая питает пайплайны, выберите Reverse ETL only. Если та же модель должна отвечать и на вопросы агентов, выберите один из вариантов с AI agents.
Просмотрите колонки, которые Renta прочитала из запроса, и отметьте ту, что опознаёт строку. По этому ключу Reverse ETL отличает изменённую строку от новой, поэтому выбирайте колонку, по которой будете сопоставлять и в HubSpot, например адрес электронной почты.
Задайте имя и короткое описание, затем нажмите Create model. Именно это имя вы выберете в списке Data model при создании пайплайна.
Модель появится в списке с областью Reverse ETL и готова к использованию в пайплайне.
Создание пайплайна HubSpot
Назначение и модель данных должны быть готовы до начала.
В левом меню нажмите New pipeline. На шаге Source переключитесь на Reverse ETL и выберите своё хранилище данных, например Google BigQuery.
Выберите подключение хранилища, в котором лежат ваши модели данных, и нажмите Next step.
На шаге Destination выберите HubSpot в блоке Already connected и нажмите Next step.
Выберите подключение HubSpot, созданное ранее, и нажмите Next step.
Настройка пайплайна
На последнем шаге выберите объект HubSpot, данные за ним и способ записи.
Что отправляет Renta
Выберите тип записей, которые пайплайн будет создавать или обновлять. Всё, что ниже, зависит от этого выбора, поэтому начните с него.
| Группа | Объекты |
|---|---|
| Записи CRM | Contacts, Companies, Deals, Tickets |
| Коммерция | Products, Line items, Quotes |
| Активности | Notes, Calls, Tasks, Meetings |
Один пайплайн пишет в один объект. Чтобы поддерживать в актуальном состоянии и контакты, и компании, к которым они относятся, сделайте по пайплайну на каждый объект.
Модель данных и аккаунт
Укажите пайплайну, откуда брать данные и в какой портал их писать.
- Data model.
Выберите модель для синхронизации. Из неё берутся колонки для сопоставления и маппинга ниже. - Account.
Аккаунт HubSpot, в который попадут записи.
Сопоставление записей
Укажите, какое значение опознаёт запись, чтобы строка обновляла именно свою запись, а не добавляла ещё одну.
Левый список предлагает уникальный ключ модели данных. Правый: свойства HubSpot, способные опознать запись, то есть встроенный email для контактов и любые свойства, помеченные в вашем портале как уникальные. Renta отправляет сопоставленное значение с каждой строкой, поэтому повторять его в блоке маппинга ниже не нужно.
Маппинг полей
Свяжите колонки модели данных со свойствами HubSpot. В правом списке только доступные для записи свойства выбранного объекта, поэтому вычисляемые свойства и свойства только для чтения туда не попадают.
| Тип маппинга | Описание |
|---|---|
| Standard | Берёт значение из колонки модели данных. |
| Static | Записывает одно и то же фиксированное значение в каждую запись. |
| Variable | Записывает значение самой синхронизации: например, имя модели данных или время старта запуска. |
Режим синхронизации
Решите, как строка превращается в запись.
| Режим | Описание |
|---|---|
| Upsert | Обновляет запись, с которой сопоставилась строка, и создаёт новую, если совпадения нет. Вариант по умолчанию и подходящий для большинства синхронизаций. |
| Update only | Обновляет только сопоставленные записи, а строки без совпадения отклоняет. Подходит, когда состав записей определяет HubSpot, а хранилище только обогащает их. |
| Create only | Всегда создаёт запись и отклоняет строку, значение которой дублирует существующую. |
| Mirror | Обновляет строки, которые есть в модели, и применяет политику удаления к тем, что из неё пропали. Единственный режим, который обрабатывает удалённые строки. |
Поведение при удалении строки
Задайте, что произойдёт с записью HubSpot, чья строка пропала из модели данных.
| Вариант | Описание |
|---|---|
| Ignore | Запись остаётся как есть. Вариант по умолчанию. |
| Archive | Мягкое удаление. HubSpot хранит запись восстанавливаемой 90 дней. |
| GDPR delete | Удаляет запись безвозвратно, отменить нельзя. HubSpot разрешает это только для контактов. |
| Clear fields | Оставляет запись и очищает свойства, которые пишет этот пайплайн, не трогая остальные. |
Дальше задайте имя пайплайна.
Поле Integration name задаёт имя пайплайна в интерфейсе Renta. Измените его так, как вам удобно.
Расписание
Выберите, как часто запускается пайплайн.
| Тип расписания | Описание |
|---|---|
| Manual | Пайплайн запускается только вручную из интерфейса или через API. |
| Daily | Пайплайн запускается раз в сутки в указанное время обновления. |
| Interval | Пайплайн запускается через заданные интервалы времени. |
| Cron Expression | Пайплайн запускается по расписанию, заданному cron-выражением. |
Для расписания Daily укажите Update time (точное время старта каждого запуска) и нажмите Create pipeline.
Новый пайплайн появится в разделе Pipelines на вкладке Reverse ETL, где видно его запуски и прогресс.
Стратегия синхронизации
Renta синхронизирует данные инкрементально. Запуск сравнивает модель данных с состоянием, записанным на прошлом запуске, и отправляет только то, что изменилось, поэтому ночная синхронизация трогает несколько записей, а не всю модель. Первому запуску сравнивать не с чем, и он отдаёт всё.
| Состояние строки | Что делает Renta |
|---|---|
| Новая | Создаёт запись или обновляет сопоставленную, в зависимости от режима синхронизации. |
| Изменённая | Записывает замапленные свойства заново с новыми значениями. Свойства вне маппинга остаются прежними. |
| Без изменений | Ничего не отправляет. |
| Удалённая | Игнорируется во всех режимах, кроме Mirror, где решает выбранная политика удаления. |
Ограничения
- Для сопоставления нужно уникальное свойство.
HubSpot опознаёт запись по свойству, помеченному в портале как уникальное. Без такого свойства пайплайн умеет только создавать записи. - Отклонённая строка не роняет остальные.
HubSpot отвечает по каждой записи отдельно, поэтому строка, которую он не принял, например с незнакомым значением варианта, отклоняется сама по себе, а остальной пакет доезжает. Причины видны в журнале запуска. - Запуск останавливается при массовых отказах.
Renta прекращает запуск, если отклонено больше 30% пакета или больше 10% строк, отправленных с начала запуска. Уже записанные записи остаются в HubSpot, а следующий запуск продолжит с места остановки. - Варианты свойств не создаются автоматически.
Renta пишет только в те свойства и значения вариантов, которые уже заведены в вашем портале. Сначала добавьте недостающий вариант в HubSpot, потом перезапустите пайплайн.
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.