amoCRM
Renta выгружает в ваше хранилище данных семь объектов amoCRM: сделки, контакты, компании, постоянных покупателей, воронки продаж с этапами, пользователей аккаунта и журнал изменений Events, где видно, какой пользователь изменил поле и каким было значение до и после.
Поля каждого объекта вы выбираете сами. Renta загружает их вместе с кастомными полями, тегами и идентификаторами связанных сущностей, а сделки, контакты и события обновляет инкрементально на Google BigQuery и ClickHouse.
Аутентификация
Renta подключается к amoCRM через OAuth. Вы входите в amoCRM, выбираете, какой аккаунт подключить, и разрешаете доступ. Копировать API-ключи из настроек amoCRM не нужно.
Подключение источника amoCRM
Выполните эти шаги, чтобы добавить amoCRM как источник в Renta, авторизовав доступ к вашему аккаунту amoCRM.
- Откройте раздел Connections > Catalog в левой панели.
- Откройте категорию CRM и нажмите на карточку AmoCRM.
Нажмите Log in to your amoCRM account. Renta перенаправит вас на страницу согласия amoCRM.
- Если вы управляете несколькими аккаунтами amoCRM, выберите нужный в выпадающем списке аккаунтов.
- Нажмите Разрешить.
amoCRM установит виджет Renta в выбранном аккаунте. Отозвать выданный доступ можно в любой момент в настройках интеграции на стороне amoCRM.
- В поле Source name укажите название источника данных. Оно используется только в интерфейсе Renta.
- Нажмите Save.
Карточка Access granted показывает подключённый аккаунт. Кнопка Re-authorize рядом повторяет процедуру OAuth, если позже понадобится сменить аккаунт.
Новый источник появится в списке Sources со статусом Active. Теперь его можно использовать в пайплайнах.
Создание пайплайна
Когда источник подключён, создайте пайплайн, чтобы синхронизировать данные amoCRM с назначением.
Создание пайплайна amoCRM
Свяжите источник amoCRM с назначением и настройте пайплайн.
В левой панели нажмите New pipeline. На шаге Source выберите AmoCRM в разделе Already connected и нажмите Next step.
Выберите созданное ранее подключение amoCRM и нажмите Next step. На карточке показан субдомен подключённого аккаунта.
На шаге Destination выберите назначение (например, Google BigQuery) и нажмите Next step.
Выберите подключение назначения, в которое нужно загружать данные, и нажмите Next step.
Настройка пайплайна
На последнем шаге выберите отчёт, его поля и расписание.
Тип отчёта
Выберите, какой объект amoCRM выгружает пайплайн. Один пайплайн загружает один тип отчёта.
| Тип отчёта | Описание |
|---|---|
| Leads (сделки) | Записи сделок: бюджет, идентификаторы статуса и воронки, даты создания, обновления и закрытия, причина отказа, кастомные поля, теги и идентификаторы связанных контактов и компаний. |
| Contacts (контакты) | Записи контактов: полное имя, разложенное на имя и фамилию, кастомные поля, теги и идентификаторы связанных сделок, компаний и покупателей. |
| Companies (компании) | Записи компаний: атрибуты, кастомные поля, теги и идентификаторы связанных контактов и сделок. |
| Customers (покупатели) | Записи постоянных покупателей: ожидаемые дата и сумма следующей покупки, LTV, количество покупок, средний чек и периодичность. |
| Pipelines (воронки) | Воронки продаж аккаунта вместе с их этапами: идентификаторы этапов, названия, порядок и тип. |
| Users (пользователи) | Пользователи аккаунта: имя, email, язык интерфейса и права доступа к сделкам, контактам, компаниям и задачам. |
| Events (события) | Журнал изменений аккаунта: сущность, к которой относится событие, тип события, пользователь, который его вызвал, и значение до и после изменения. |
Параметры
Выберите поля amoCRM, которые попадут в таблицу назн ачения.
Найдите параметр по названию через поле поиска или нажмите Select All. Вкладка Selected показывает всё выбранное, а список Selected Parameters под выбором позволяет удалить параметр.
В каждом отчёте есть пара полей, без которых пайплайн не работает. В отчётах Leads и Contacts это ID и Updated At, в отчёте Events это ID и Created At. Они выбраны заранее и показаны в списке неактивными.
Каждому типу отчёта доступны такие параметры.
| Тип отчёта | Параметры |
|---|---|
| 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, Created Date 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, Created Date 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] |
| Events | ID, Entity ID, Entity Type, Type, Created By, Created At, Created Date At, Account ID, Responsible User ID, Group ID, Value After, Value Before |
Структурные параметры загружаются вложенными записями. Custom fields values хранит по одной записи на кастомное поле с его идентификатором, названием, кодом, типом и значением. Так же устроены Tags, Statuses, списки связанных сущностей (Contacts, Companies, Leads, Customers) и объекты с правами доступа в отчёте Users. В отчёте Events поля Value Before и Value After приходят в формате JSON, потому что их структура зависит от типа события.
Параметры с датами, такие как Created At, Updated At, Closed At и Next Date, приходят в формате Unix Timestamp. Created Date At содержит тот же момент, что и Created At, но записанный календарной датой.
Название таблицы
Задайте названия пайплайна и таблицы в назначении.
- Integration name.
Название пайплайна. Используется только в интерфейсе Renta. - Table name.
Название таблицы в назначении. Можно оставить сгенерированное название или ввести своё.
Расписание
Выберите, как часто запускается пайплайн.
| Тип расписания | Описание |
|---|---|
| Manual | Пайплайн запускается только вручную через интерфейс или по API. |
| Daily | Пайплайн запускается раз в день в указанное время обновлен ия. |
| Interval | Пайплайн запускается через заданные интервалы времени. |
| Cron Expression | Пайплайн запускается по расписанию, заданному cron-выражением. |
Для расписания Daily укажите Update time (точное время начала каждого запуска) и нажмите Create pipeline.
Новый пайплайн появится в разделе Pipelines на вкладке ETL, где видны его запуски, прогресс и название таблицы в назначении.
Стратегия синхронизации
Способ синхронизации отчёта amoCRM зависит от типа отчёта и от того, поддерживает ли назначение merge.
| Стратегия | Поддерживаемые типы отчётов | Описание |
|---|---|---|
| Инкрементальная (merge) | Leads, Contacts, Events (на Google BigQuery и ClickHouse) | Renta запрашивает только записи, изменившиеся с прошлого запуска: Leads и Contacts фильтруются по дате обновления, Events по дате создания. Каждый запуск дополнительно перечитывает трёхдневное перекрытие, поэтому Renta подхватит и то изменение, которое дошло до amoCRM с задержкой. Записи обновляются в назначении по id. Для Leads и Contacts Renta дополнительно собирает записи, удалённые в amoCRM за то же окно. |
| Полная перезагрузка | Companies, Customers, Pipelines, Users (на любом назначении), а также Leads, Contacts, Events (на остальных назначениях) | При каждом запуске Renta загружает полный список записей и заменяет содержимое таблицы в назначении, поэтому таблица отражает состояние аккаунта amoCRM на момент запуска. |
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.