Kommo
CRM-система Kommo живёт на субдомене вашего аккаунта, например yourcompany.kommo.com. Её API отдаёт основные объекты CRM: сделки, контакты, компании, постоянных покупателей, воронки продаж с их этапами и пользователей аккаунта.
Renta выгружает каждый объект в ваше хранилище данных отдельным типом отчёта. Запуск загружает текущее состояние записей, включая кастомные поля, теги и идентификаторы связанных сущностей.
Аутентификация
Renta подключается к Kommo через OAuth. Вы входите в Kommo, выбираете, какой аккаунт подключить, и разрешаете доступ. Копировать API-ключи из настроек Kommo не нужно.
Подключение источника Kommo
Выполните эти шаги, чтобы добавить Kommo как источник в Renta, авторизовав доступ к вашему аккаунту Kommo.
- Откройте раздел Connections > Catalog в левой панели.
- Откройте категорию CRM и нажмите на карточку Kommo.
Нажмите Log in to your Kommo account. Renta перенаправит вас на страницу согласия Kommo.
- Если у вас несколько аккаунтов Kommo, выберите нужный в выпадающем списке.
- Нажмите Allow.
Выданные разрешения можно отозвать в любой момент в профиле Kommo или в настройках интеграции на стороне Kommo.
- В поле Source name укажите имя источника данных. Оно используется только в интерфейсе Renta.
- Нажмите Save.
Карточка Access granted показывает подключённый аккаунт. Кнопка Re-authorize рядом повторяет OAuth-процесс, если позже понадобится сменить аккаунт.
Новый источник появится в списке Sources со статусом Active. Теперь его можно использовать в пайплайнах.
Создание пайплайна
После подключения источника создайте пайплайн, чтобы синхронизировать данные Kommo с вашим назначением.
Создание пайплайна Kommo
Свяжите источник Kommo с назначением и настройте пайплайн.
В левой панели нажмите New pipeline. На шаге Source выберите Kommo в списке Already connected и нажмите Next step.
Выберите созданное ранее подключение Kommo и нажмите Next step. На карточке показан субдомен подключённого аккаунта.
На шаге Destination выберите ваше назначение (например, Google BigQuery) и нажмите Next step.
Выберите подключение назначения, в которое нужно загружать данные, и нажмите Next step.
Настройка пайплайна
На последнем шаге выберите отчёт, его поля и расписание.
Тип отчёта
Выберите, какой объект Kommo выгружает пайплайн. Один пайплайн загружает один тип отчёта.
| Тип отчёта | Описание |
|---|---|
| Leads (сделки) | Записи сделок: бюджет, идентификаторы статуса и воронки, даты создания, обновления и закрытия, кастомные поля, теги, идентификато ры связанных контактов и компаний. |
| Contacts (контакты) | Записи контактов: имена, кастомные поля, теги, идентификаторы связанных сделок, компаний и покупателей. |
| Companies (компании) | Записи компаний: атрибуты, кастомные поля, теги, идентификаторы связанных контактов и сделок. |
| Customers (покупатели) | Записи постоянных покупателей: дата и сумма следующей покупки, LTV, число покупок и средний чек. |
| Pipelines (воронки) | Воронки продаж аккаунта вместе с этапами: идентификаторы, названия и порядок этапов. |
| Users (пользователи) | Пользователи аккаунта: имя, email, язык и права доступа к сделкам, контактам, компаниям и задачам. |
Параметры
Выберите поля Kommo, которые попадут в таблицу назначения.
Используйте поиск, чтобы найти параметр по имени, или нажмите Select All. Вкладка Selected показывает всё выбранное, а список Selected Parameters под ней позволяет убрать параметр.
Каждый тип отчёта содержит следующие параметры.
| Тип отчёта | Параметры |
|---|---|
| Leads | ID, Name, Price, Responsible User ID, Group ID, Status ID, Pipeline ID, Loss Reason ID, Source ID, Created By, Updated By, Closed At, Created At, Updated At, Closest Task At, Is Deleted, Score, Account ID, Labor Cost, Is Price Modified by Robot, Custom fields values, Tags, Contacts, Companies |
| Contacts | ID, Name, First Name, Last Name, Responsible User ID, Group ID, Created By, Updated By, Created At, Updated At, Is Deleted, Closest Task At, Account ID, Custom fields values, Tags, Companies, Leads, Customers |
| Companies | ID, Name, Responsible User ID, Group ID, Created By, Updated By, Created At, Updated At, Closest Task At, Custom fields values, Tags, Contacts, Leads |
| Customers | ID, Name, Next Price, Next Date, Responsible User ID, Status ID, Periodicity, Created By, Updated By, Created At, Updated At, Closest Task At, Is Deleted, LTV, Purchases Count, Average Check, Account ID, Custom fields values, Tags, Contacts, Companies |
| Pipelines | ID, Name, Sort, Is Main, Is Unsorted On, Is Archive, Account ID, Statuses |
| Users | ID, Name, Email, Language, Leads Access Rights [Object], Contacts Access Rights [Object], Companies Access Rights [Object], Tasks Access Rights [Object], User Rights [Object] |
Структурные параметры загружаются вложенными записями. Custom fields values хранит по одной записи на кастомное поле: идентификатор, имя, код, тип и значение. Так же работают Tags, Statuses, списки связанных сущностей (Contacts, Companies, Leads, Customers) и объекты прав доступа в отчёте Users.
Параметры-даты, такие как Created At, Updated At, Closed At и Next Date, приходят в формате Unix timestamp.
Имя таблицы
Назовите пайплайн и таблицу в назначении.
- Integration name.
Имя пайплайна. Используется только в интерфейсе Renta. - Table name.
Имя таблицы в назначении. Можно оставить автоматически сгенерированное имя или задать своё.
Расписание
Выберите, как часто запускается пайплайн.
| Тип расписания | Описание |
|---|---|
| Manual | Пайплайн запускается только вручную через интерфейс или по API. |
| Daily | Пайплайн запускается раз в день в указанное время. |
| Interval | Пайплайн запускается через заданные интервалы времени. |
| Cron Expression | Пайплайн запускается по расписанию, заданному cron-выражением. |
Для расписания Daily укажите Update time (точное время запуска), затем нажмите Create pipeline.
Новый пайплайн появится в разделе Pipelines на вкладке ETL, где можно отслеживать запуски, прогресс и имя таблицы назначения.
Стратегия синхронизации
Все типы отчётов Kommo синхронизируются одинаково.
| Стратегия | Поддерживаемые типы отчётов | Описание |
|---|---|---|
| Полная перезагрузка | Leads, Contacts, Companies, Customers, Pipelines, Users | Объекты Kommo передают текущее состояние CRM, и колонки с датой для партиционирования в них нет. При каждом запуске Renta загружает полный список записей и заменяет содержимое таблицы назначения, поэтому таблица всегда отражает CRM на момент запуска. |
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.