Какой аккаунт Kommo использует подключение?

Тот, который вы выбрали на экране согласия Kommo при авторизации. Подключение привязано к субдомену этого аккаунта, субдомен показан на карточке подключения при создании пайплайна.

Почему в настройках пайплайна нет диапазона дат?

Отчёты Kommo передают текущее состояние записей CRM, а не статистику по датам. При каждом запуске Renta загружает полный список записей, поэтому исторический период настраивать не нужно.

Что происходит с записями, удалёнными в Kommo?

Таблица в назначении заменяется при каждом запуске и отражает то, что API Kommo возвращает в этот момент. В отчётах Leads , Contacts и Customers также доступен параметр Is Deleted .

Почему отчёт Customers загружает ноль строк?

В аккаунте Kommo должна быть включена функция покупателей. Если она выключена, API Kommo не возвращает данные по этому объекту, и запуск завершается с пустой таблицей.

Kommo

CRM-система Kommo живёт на субдомене вашего аккаунта, например yourcompany.kommo.com. Её API отдаёт основные объекты CRM: сделки, контакты, компании, постоянных покупателей, воронки продаж с их этапами и пользователей аккаунта.

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

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

Renta подключается к Kommo через OAuth. Вы входите в Kommo, выбираете, какой аккаунт подключить, и разрешаете доступ. Копировать API-ключи из настроек Kommo не нужно.

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

Перейдите в каталогStep 1

Откройте раздел Connections > Catalog в левой панели.
Откройте категорию CRM и нажмите на карточку Kommo.

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

Начните авторизациюStep 2

Нажмите Log in to your Kommo account. Renta перенаправит вас на страницу согласия Kommo.

Страница добавления подключения Kommo с кнопкой Log in to your Kommo account

Выдайте доступ в KommoStep 3

Если у вас несколько аккаунтов Kommo, выберите нужный в выпадающем списке.
Нажмите Allow.

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

Экран согласия Kommo с выбором аккаунта и кнопкой Allow

Назовите подключение и сохранитеStep 4

В поле Source name укажите имя источника данных. Оно используется только в интерфейсе Renta.
Нажмите Save.

Карточка Access granted показывает подключённый аккаунт. Кнопка Re-authorize рядом повторяет OAuth-процесс, если позже понадобится сменить аккаунт.

Настройка подключения Kommo с полем имени источника и кнопкой Save

Источник созданStep 5

Новый источник появится в списке Sources со статусом Active. Теперь его можно использовать в пайплайнах.

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

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

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

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

В левой панели нажмите New pipeline. На шаге Source выберите Kommo в списке Already connected и нажмите Next step.

Шаг выбора источника с Kommo в списке Already connected

Выберите подключение KommoStep 2

Выберите созданное ранее подключение Kommo и нажмите Next step. На карточке показан субдомен подключённого аккаунта.

Шаг выбора подключения Kommo с субдоменом аккаунта на карточке

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

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

Шаг выбора назначения с Google BigQuery в списке Already connected

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

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

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

На последнем шаге выберите отчёт, его поля и расписание.

Тип отчёта

Выберите, какой объект Kommo выгружает пайплайн. Один пайплайн загружает один тип отчёта.

Настройки пайплайна Kommo с выпадающим списком Report Types и выбранным Leads

Тип отчёта	Описание
Leads (сделки)	Записи сделок: бюджет, идентификаторы статуса и воронки, даты создания, обновления и закрытия, кастомные поля, теги, идентификаторы связанных контактов и компаний.
Contacts (контакты)	Записи контактов: имена, кастомные поля, теги, идентификаторы связанных сделок, компаний и покупателей.
Companies (компании)	Записи компаний: атрибуты, кастомные поля, теги, идентификаторы связанных контактов и сделок.
Customers (покупатели)	Записи постоянных покупателей: дата и сумма следующей покупки, LTV, число покупок и средний чек.
Pipelines (воронки)	Воронки продаж аккаунта вместе с этапами: идентификаторы, названия и порядок этапов.
Users (пользователи)	Пользователи аккаунта: имя, email, язык и права доступа к сделкам, контактам, компаниям и задачам.

Параметры

Выберите поля Kommo, которые попадут в таблицу назначения.

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

Тип отчёта

Поиск

Название	Имя в API	Описание
ID int	`id`	ID of the company.
Name text	`name`	Name of the company.
Responsible User ID int	`responsible_user_id`	ID of the user responsible for the company.
Group ID int	`group_id`	ID of the group to which the responsible user belongs.
Created By int	`created_by`	ID of the user who created the company.
Updated By int	`updated_by`	ID of the user who last updated the company.
Created At int	`created_at`	Date of creation of the company, passed in Unix Timestamp.
Updated At int	`updated_at`	Date of update of the company, passed in Unix Timestamp.
Closest Task At int	`closest_task_at`	Date of the nearest task to be performed, passed in Unix Timestamp.
Custom fields values structure	`custom_fields_values`	Array of custom fields with additional information.
Tags structure	`tags`	Array of tags with additional information.
Contacts structure	`contacts`	Array of contact with additional information.
Leads structure	`leads`	Array of company additional information.

Название	Имя в API	Описание
ID int	`id`	ID of the contact.
Name text	`name`	Name of the contact.
First Name text	`first_name`	First name of the contact.
Last Name text	`last_name`	Last name of the contact.
Responsible User ID int	`responsible_user_id`	ID of the user responsible for the contact.
Group ID int	`group_id`	ID of the group to which the responsible user belongs.
Created By int	`created_by`	ID of the user who created the contact.
Updated By int	`updated_by`	ID of the user who last updated the contact.
Created At int	`created_at`	Date of creation of the contact, passed in Unix Timestamp.
Updated At int	`updated_at`	Date of update of the contact, passed in Unix Timestamp.
Is Deleted bool	`is_deleted`	Whether the contact is deleted or not.
Closest Task At int	`closest_task_at`	Date of the nearest task to be performed, passed in Unix Timestamp.
Account ID int	`account_id`	ID of the account in which the contact is located.
Custom fields values structure	`custom_fields_values`	Array of custom fields with additional information.
Tags structure	`tags`	Array of tags with additional information.
Companies structure	`companies`	Array of contact with additional information.
Leads structure	`leads`	Array of company additional information.
Customers structure	`customers`	Array of customers additional information.

Название	Имя в API	Описание
ID int	`id`	ID of the lead.
Name text	`name`	Name of the lead.
Price int	`price`	Budget of the lead.
Responsible User ID int	`responsible_user_id`	ID of the user responsible for the lead.
Group ID int	`group_id`	ID of the group which the responsible user belongs to.
Status ID int	`status_id`	ID of the status the lead is added to, by default – the first stage of the main pipeline.
Pipeline ID int	`pipeline_id`	ID of the pipeline the lead is added to.
Loss Reason ID int	`loss_reason_id`	ID of the reason for lead rejection.
Source ID int	`source_id`	Required GET parameter with. ID of the lead source.
Created By int	`created_by`	ID of the user who created the lead.
Updated By int	`updated_by`	ID of the user who last updated the lead.
Closed At int	`closed_at`	Closure date of the lead, passed in Unix Timestamp.
Created At int	`created_at`	Creation date of the lead, passed in Unix Timestamp.
Updated At int	`updated_at`	Update date of the lead, passed in Unix Timestamp.
Closest Task At int	`closest_task_at`	Date of the nearest task to be performed, passed in Unix Timestamp.
Is Deleted bool	`is_deleted`	Whether the lead is deleted or not.
Score int	`score`	Scoring of the lead.
Account ID int	`account_id`	ID of the account in which the lead is located.
Labor Cost int	`labor_cost`	Labor cost field type shows how much time was spent working on the lead. Time measured in seconds.
Is Price Modified by Robot bool	`is_price_modified_by_robot`	Required GET parameter with. Whether the lead's budget was last modified by a robot.
Custom fields values structure	`custom_fields_values`	Array of custom fields with additional information.
Tags structure	`tags`	Array of tags with additional information.
Contacts structure	`contacts`	Array of contact with additional information.
Companies structure	`companies`	Array of company additional information.

Название	Имя в API	Описание
ID int	`id`	ID of the pipeline.
Name text	`name`	Name of the pipeline.
Sort int	`sort`	Sort order of the pipeline.
Is Main bool	`is_main`	Whether the pipeline is the main one.
Is Unsorted On bool	`is_unsorted_on`	Whether the unsorted feature is enabled in the pipeline.
Is Archive bool	`is_archive`	Whether the pipeline is archived.
Account ID int	`account_id`	ID of the account in which the pipeline is located.
Statuses structure	`statuses`	Array of custom statuses fields with additional information.

Название	Имя в API	Описание
ID int	`id`	ID of the customer.
Name text	`name`	Name of the customer.
Next Price int	`next_price`	Expected purchase amount.
Next Date int	`next_date`	Expected date of the next purchase. Data in Unix Timestamp.
Responsible User ID int	`responsible_user_id`	ID of the user responsible for the customer.
Status ID int	`status_id`	ID of the customer's status in the account.
Periodicity int	`periodicity`	Periodicity (data required for customers with enabled periodicity functionality).
Created By int	`created_by`	ID of the user who created the customer.
Updated By int	`updated_by`	ID of the user who last updated the customer.
Created At int	`created_at`	Date of creation of the customer, passed in Unix Timestamp.
Updated At int	`updated_at`	Date of update of the customer, passed in Unix Timestamp.
Closest Task At int	`closest_task_at`	Date of the nearest task to be performed, passed in Unix Timestamp.
Is Deleted bool	`is_deleted`	Whether the customer is deleted or not.
LTV int	`ltv`	Total purchase amount.
Purchases Count int	`purchases_count`	Number of purchases.
Average Check int	`average_check`	Average purchase size.
Account ID int	`account_id`	ID of the account in which the customer is located.
Custom fields values structure	`custom_fields_values`	Array of custom fields with additional information.
Tags structure	`tags`	Array of tags with additional information.
Contacts structure	`contacts`	Array of contact with additional information.
Companies structure	`companies`	Array of company additional information.

Название	Имя в API	Описание
ID int	`id`	ID of the user.
Name text	`name`	Full name of the user.
Email text	`email`	Email address of the user.
Language text	`lang`	Language of the user. One of the options: ru, en, es.
Leads Access Rights [Object] structure	`leads`	Object containing user's access rights to leads.
Contacts Access Rights [Object] structure	`contacts`	Object containing user's access rights to contacts.
Companies Access Rights [Object] structure	`companies`	Object containing user's access rights to companies.
Tasks Access Rights [Object] structure	`tasks`	Object containing user's access rights to tasks.
User Rights [Object] structure	`rights`	Object containing user's system-wide rights and permissions.

Отмечайте параметры по одному или выберите весь список кнопкой Select All.

Структурные параметры загружаются вложенными записями. Custom fields values хранит по одной записи на кастомное поле: идентификатор, имя, код, тип и значение. Так же работают Tags, Statuses, списки связанных сущностей (Contacts, Companies, Leads, Customers) и объекты прав доступа в отчёте Users.

Параметры-даты, такие как Created At, Updated At, Closed At и Next Date, приходят в формате Unix timestamp.

Если кастомное поле содержит несколько значений, в колонку field_value попадает первое из них.

Имя таблицы

Назовите пайплайн и таблицу в назначении.

Поля имени интеграции и имени таблицы Kommo со списком выбранных параметров выше

Integration name.
Имя пайплайна. Используется только в интерфейсе Renta.
Table name.
Имя таблицы в назначении. Можно оставить автоматически сгенерированное имя или задать своё.

Расписание

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

Выбор типа расписания Kommo с отмеченным вариантом Daily

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

Для расписания Daily укажите Update time (точное время запуска), затем нажмите Create pipeline.

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

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

Новый пайплайн появится в разделе Pipelines на вкладке ETL, где можно отслеживать запуски, прогресс и имя таблицы назначения.

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

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

Все типы отчётов 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.