Renta / Документация / Источники / Intercom

Intercom

Renta выгружает в ваше хранилище данных восемь объектов Intercom: контакты, компании, диалоги, администраторов, команды, сегменты, теги и атрибуты данных.

Для каждого объекта вы можете гибко настроить список выгружаемых полей. Интеграция автоматически обрабатывает сложные структуры данных:

  1. Вложенные объекты (например, геолокация) разворачиваются в плоские колонки.
  2. Списки (например, теги и участники) сохраняются в виде вложенных записей.
  3. Даты преобразуются из формата Unix timestamp в стандартный формат даты и времени в часовом поясе UTC.

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

Renta подключается к Intercom с помощью протокола OAuth. Это безопасный способ авторизации, при котором вам не нужно копировать API-ключи или токены вручную.

Ваши учётные данные шифруются при передаче и хранении и никогда не сохраняются в базе данных приложения Renta. Вы контролируете доступ и можете отозвать его в настройках аккаунта Intercom в любой момент.

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

Выполните эти шаги, чтобы добавить Intercom в Renta в качестве источника данных и предоставить доступ к вашему воркспейсу.

Выберите Intercom в каталогеStep 1
  1. В левом меню перейдите в раздел Connections > Catalog.
  2. Откройте категорию Customer support и выберите карточку Intercom с пометкой Source.

Примечание: карточка с пометкой Destination используется для обратной выгрузки данных из хранилища в Intercom.

Карточка Intercom Source в категории Customer support каталога Renta
Начните процесс авторизацииStep 2

Нажмите Log in to your Intercom account. Вы будете перенаправлены на страницу авторизации Intercom.

Страница добавления подключения Intercom с кнопкой Log in to your Intercom account
Предоставьте доступStep 3
  1. Ознакомьтесь со списком запрашиваемых прав. Renta запрашивает доступ только к тем объектам, которые необходимы для экспорта (контакты, компании, диалоги и т.д.).
  2. Проверьте поле Data host region внизу страницы и выберите регион, в котором физически размещен ваш воркспейс.
  3. Нажмите Authorize access.

Вы можете отозвать доступ в любой момент в настройках авторизованных приложений вашего аккаунта Intercom.

Страница согласия Intercom со списком прав, кнопкой Authorize access и выбором Data host region
Укажите имя подключения и сохранитеStep 4
  1. В поле Source name введите понятное имя для источника (оно будет отображаться только в интерфейсе Renta).
  2. Нажмите Save.

В блоке Access granted отобразится аккаунт Intercom, предоставивший доступ. Если в будущем потребуется сменить воркспейс, используйте кнопку Re-authorize.

Настройка подключения Intercom с полем Source name и кнопкой Save
Проверьте статус подключенияStep 5

Убедитесь, что новый источник появился в списке Sources со статусом Active. Теперь он готов к использованию в пайплайнах.

Список Sources с новым источником Intercom в статусе Active

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

После успешного подключения источника создайте пайплайн для настройки регулярной выгрузки данных в ваше хранилище.

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

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

Выберите источникStep 1

В левом навигационном меню нажмите New pipeline. На этапе Source выберите Intercom в разделе Already connected и нажмите Next step.

Шаг выбора источника с Intercom в блоке Already connected
Выберите подключение IntercomStep 2

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

Шаг выбора подключения Intercom с аккаунтом на карточке подключения
Выберите тип назначенияStep 3

На этапе Destination выберите целевое хранилище данных (например, Google BigQuery) и нажмите Next step.

Шаг выбора назначения с Google BigQuery в блоке Already connected
Выберите подключение назначенияStep 4

Выберите конкретное подключение к вашему хранилищу и нажмите Next step.

Шаг выбора подключения Google BigQuery

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

На финальном этапе настройки вам необходимо выбрать объект выгрузки, поля, задать имя таблицы и настроить расписание.

Выбор объекта

Один пайплайн экспортирует данные одного объекта Intercom в одну таблицу базы данных. Выберите нужный объект из выпадающего списка.

Настройки пайплайна Intercom с выпадающим списком Intercom objects со значением Conversations
ОбъектОписание
Admins (Администраторы)Данные о сотрудниках воркспейса: email, имя, статус отсутствия, наличие места в Inbox и идентификаторы команд.
Companies (Компании)Информация о компаниях: название, внешний ID, тарифный план, отрасль, размер, ежемесячная выручка, количество сессий и пользователей, а также кастомные атрибуты, сегменты и теги.
Contacts (Контакты)Данные о пользователях и лидах: email, телефон, роль, ответственный менеджер, даты активности, геолокация, информация о браузере, кастомные атрибуты, теги и заметки.
Conversations (Диалоги)Информация о переписках: исходное сообщение, ответственный сотрудник, статус, приоритет, оценка, SLA, теги, участники. Включает подробную статистику по времени ответа и закрытия диалога.
Segments (Сегменты)Списки сегментов воркспейса: название, тип пользователей, даты создания и обновления.
Tags (Теги)Справочник всех тегов воркспейса (ID и название).
Teams (Команды)Справочник команд и список входящих в них администраторов.
Data Attributes (Атрибуты данных)Описания стандартных и кастомных атрибутов для контактов, компаний и диалогов: лейблы, типы данных, допустимые значения и права на запись (API, Messenger, UI).

Выбор полей

Отметьте поля, которые необходимо выгрузить в целевую таблицу.

Выбор полей Intercom с вкладками Parameters и Selected и кнопкой Select All

Воспользуйтесь строкой поиска, чтобы найти конкретное поле, или нажмите Select all для выбора всех доступных колонок. Вкладка Selected позволяет просмотреть и отредактировать итоговый список полей.

ОбъектДоступные поля
AdminsType, ID, Email, Name, Away Mode Enabled, Away Mode Reassign, Has Inbox Seat, Team IDs
CompaniesType, ID, Company ID, Name, Created At, Updated At, Remote Created At, Last Request At, Monthly Spend, Session Count, User Count, Size, Website, Industry, Plan, Custom Attributes, Segments, Tags
ContactsType, ID, External ID, Email, Phone, Name, Role, Owner ID, Has Hard Bounced, Marked Email As Spam, Unsubscribed From Emails, Created At, Updated At, Signed Up At, Last Seen At, Last Replied At, Last Contacted At, Last Email Opened At, Last Email Clicked At, Custom Attributes, Browser, Browser Version, Browser Language, Operating System, Location City, Location Region, Location Country Name, Location Country Code, Location Continent Code, Tags, Notes, Companies
ConversationsType, ID, Title, Created At, Updated At, Waiting Since, Snoozed Until, Source Type Extracted, Source Body Extracted, Source Subject Extracted, Source Delivered As Extracted, Source Author ID, Source Author Type, Source Author Email, Source Author Name, Contacts, Teammates, Admin Assignee ID, Team Assignee ID, Open, State, Read, Priority, SLA Applied, Conversation Rating, Tags, First Contact Reply Created At, First Contact Reply Type, First Contact Reply URL, Stats Count Assignments, Stats Count Conversation Parts, Stats Count Reopens, Stats First Admin Reply At, Stats First Assignment At, Stats First Close At, Stats First Contact Reply At, Stats Last Admin Reply At, Stats Last Assignment At, Stats Last Close At, Stats Last Closed By ID, Stats Last Contact Reply At, Stats Median Time To Reply, Stats Time To Admin Reply, Stats Time To Assignment, Stats Time To First Close, Stats Time To Last Close, Conversation Parts
SegmentsType, ID, Name, Created At, Updated At, Person Type
TagsType, ID, Name
TeamsType, ID, Name, Admin IDs
Data AttributesType, ID, Model, Name, Full Name, Label, Description, Data Type, Options, API Writable, Messenger Writable, UI Writable, Custom, Archived, Created At, Updated At, Admin ID

Особенности структуры данных

  1. Вложенные объекты.
    Renta автоматически преобразует сложные объекты Intercom в плоские колонки. Например, для объекта Contacts данные о местоположении разбиваются на отдельные колонки: Location City, Location Region, Location Country Name и т.д. Аналогичным образом в Conversations парсятся исходное сообщение (Source), первый ответ пользователя (First Contact Reply) и статистика (Stats).
  2. Списки (массивы).
    Поля, содержащие массивы (например, Tags, Segments, Contacts, Teammates, Notes), выгружаются как вложенные записи. В них сохраняется идентификатор каждого элемента и его название (если доступно через API).
  3. Кастомные атрибуты.
    Поле Custom Attributes экспортируется в виде единой JSON-колонки, содержащей все пользовательские атрибуты записи. Благодаря этому, при добавлении новых кастомных атрибутов в Intercom, схема таблицы в хранилище не ломается и не требует изменений. Колонки SLA Applied и Conversation Rating также сохраняются в формате JSON.
  4. Форматирование дат и времени.
    Все поля с датами (например, Created At, Updated At, Last Seen At) и временные метки из блока Stats записываются в формате стандартной даты и времени в UTC. Метрики длительности (например, Stats Time To Admin Reply) сохраняются в секундах.

Колонка Conversation Parts для объекта Conversations всегда остается пустой при массовой выгрузке. Архитектура API Intercom позволяет получить историю сообщений только при точечном запросе конкретного диалога по его ID.

Настройка целевой таблицы

Задайте название для пайплайна и таблицы в хранилище.

Поля Integration name и Table name пайплайна Intercom со списком выбранных полей выше
  1. Integration name.
    Имя пайплайна, которое будет отображаться в интерфейсе Renta.
  2. Table name.
    Имя таблицы в вашем хранилище данных. Вы можете использовать сгенерированное по умолчанию имя или указать собственное.

Диапазон выгрузки

Укажите временной период для синхронизации данных.

Блок Date range с полем Date start и списком Date end со значением Today
  1. Date start.
    Начальная дата периода выгрузки.
  2. Date end.
    Конечная дата периода. Рекомендуется оставить значение Today, чтобы дата окончания автоматически сдвигалась при каждом последующем запуске.

API Intercom возвращает текущие срезы объектов, а не исторические изменения по дням. Renta извлекает все доступные записи выбранного объекта при каждом запуске, поэтому настройки дат в данном случае не фильтруют объем выгружаемых данных.

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

Определите, как часто пайплайн должен запускаться для синхронизации данных.

Выбор типа расписания Intercom с отмеченным вариантом Daily
Тип расписанияОписание
ManualЗапуск осуществляется только вручную (через интерфейс) или посредством API.
DailyАвтоматический запуск один раз в сутки в строго заданное время.
IntervalРегулярный запуск с заданной периодичностью (например, каждые 4 часа).
Cron expressionЗапуск по сложному расписанию с использованием стандартного синтаксиса Cron.

Если вы выбрали расписание Daily, укажите время запуска в поле Update time и нажмите Create pipeline.

Выбор времени обновления и кнопка Create pipeline

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

После создания пайплайн появится в разделе Pipelines (вкладка ETL). Здесь вы сможете отслеживать историю запусков, текущий статус и управлять настройками.

Список Pipelines с новой интеграцией Intercom в статусе Completed

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

Синхронизация всех объектов Intercom выполняется по единой логике.

СтратегияПоддерживаемые типы отчётовОписание
Полная перезагрузкаAdmins, Companies, Contacts, Conversations, Segments, Tags, Teams, Data AttributesПри каждом запуске пайплайна Renta запрашивает полный список записей из Intercom и полностью перезаписывает целевую таблицу в хранилище. Таким образом, таблица всегда отражает актуальное состояние воркспейса на момент выгрузки. Если среди выбранных полей присутствует колонка с датой (чаще всего Created At), таблица автоматически партиционируется по этому полю.

Так как данные перезагружаются полностью, в настройках пайплайна отсутствует опция выбора периода инкрементального обновления. Время выполнения и объем выгрузки зависят исключительно от общего количества записей в вашем воркспейсе Intercom.

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

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.