AmoCRM Source

Renta поддерживает экспорт данных из AmoCRM в следующие пункты назначения:

  • Google BigQuery
  • Clickhouse
  • SQL Server
  • Google Spreadsheets

Создание интеграции в хранилище данных (DWH)

  1. Перейдите в каталог интеграций;
  2. Выберите AmoCRM;
  3. Добавьте аккаунт AmoCRM, в котором находятся необходимые данные;
  4. Выберите добавленный аккаунт AmoCRM;
  5. Укажите место назначения, в которое вы хотите импортировать данные;
  6. Перейдите на экран настроек и установите необходимую конфигурацию:

Report type

Тип отчета — состоит из уникального набора параметров и метрик, доступных для выгрузки в DWH. Каждый тип отчета соответствует одноименному методу API AmoCRM. 

NameDescription
LeadsThe method allows you to get a list of leads in the account.
ContactsThe method allows you to get a list of contacts in the account.
CompaniesThe method allows you to get a list of companies in the account.
СustomersThe method allows you to get a list of customers in the account.
TasksThe method allows you to get a list of tasks in the account.
PipelinesThe method allows you to get a list of pipelines in the account.

Parameters

Параметры — содержат список параметров и метрик, доступных для экспорта. Укажите необходимые для выгрузки параметры.

В результате Renta создаст таблицу, которая будет содержать данные выбранных параметров. Порядок выбранных параметров в интерфейсе будет соответствовать порядку столбцов таблицы.

Date range type

Диапазон дат — укажите период, за который необходимо экспортировать данные. Вы можете указать любой исторический временной интервал.

Чтобы выбрать необходимое время, введите дату, с которой вы хотите начать выгрузку данных, в поле «From», затем введите дату окончания в поле «To».

Если вы хотите, чтобы данные в таблице обновлялись ежедневно и дополнялись новыми днями, тогда в поле «To» укажите «Yesterday».
Подробная инструкция по работе с диапазоном дат

Integration name

Имя интеграции — при создании интеграции автоматически генерируется её имя. В этом поле вы можете переименовать название интеграции. Разрешены как кириллица, так и латиница, но не более 100 символов.

Название интеграции отображается на странице Integration List.

Table name

Имя таблицы — при создании интеграции автоматически генерируется имя таблицы, которая будет создана в DWH. В этом поле вы можете переименовать её.

Разрешена только латиница, цифры и символ «_».

Update time

Время обновления — вы можете указать любое время обновления, которое вам нужно. Рента обновляет интеграции ежедневно в интервале выбранного часа. 

Обычно наши пользователи выбирают время обновления интеграций рано утром, например, в 5 утра. В этом случае ваша интеграция будет обновляться в период с 5 утра до 6 утра. 

Обновление интеграций происходит по часовому поясу, выбранном в настройках вашего профайла. 

Создание интеграции в Google Spreadsheets

Воспользуйтесь бесплатным расширением, доступным в Google Workspace Marketplace. Для этого:

  1. Установите расширение Renta Spreadsheets Add-on.
  2. Затем зайдите в Google Sheets, и во вкладке Tools выберите Renta, после чего нажмите кнопку Run. 

После чего в правом сайдбаре откроется рабочая область с настройками интеграций. Подробная инструкция по созданию интеграции доступна по данной ссылке. Обратите внимание, что все созданные интеграции в Google Spreadsheets также доступны для управления в веб-версии Renta. 

Структура данных

NameDescriptionType
idThe unique identifier of the new entity.STRING
nameName of the lead.STRING
responsible_user_idid of the responsible user.STRING
created_byid of the user who created the lead.STRING
created_atThe time and date the lead was created.DATE
updated_atDate and time of the lead change.DATE
account_idid of the account on which the lead was created.STRING
is_deletedDeal deleted or not. Deleted leads can be in “deleted”.BIT
main_contact.idid of the main contact of the lead.STRING
group_idid of the group in which the user is responsible for the lead.STRING
company.idid of the company that is attached to this lead.STRING
company.nameThe name of the company that is attached to the lead.STRING
closed_atThe time and date when this lead was completed.DATE
closest_task_atThe time of the nearest task for this lead.DATE
tags.idid of the tag attached to this trade.ARRAY(STRING)
tags.nameThe name of the tag attached to this lead.ARRAY(STRING)
custom_fields.idid of the custom field.STRING
custom_fields.namename of the custom field.STRING
custom_fields.values.valueThe value of the custom field.ARRAY(STRING)
custom_fields.values.enumEarly identifier of the preset option for the list or multisession.ARRAY(STRING)
custom_fields.values.subtypeThe identifier of the values ​​of the additional field “address”.ARRAY(STRING)
custom_fields.is_systemIs the extra field systemic.BIT
contacts.idid of the contact attached to the lead.ARRAY(STRING)
status_idId of the stage of the digital funnel where this transaction is located.STRING
saleBudget of the lead.INTEGER
pipeline.idid of the digital pipeline in which the lead is located.STRING
idThe unique identifier of the new entity.STRING
nameFull contact name.STRING
first_nameFirst contact Name.STRING
last_nameContact last name.STRING
responsible_user_idid of the responsible user.STRING
created_byId of the user who created the contact.STRING
created_atContact creation time and date.DATE
updated_atUpdated contact time and date.DATE
account_idId of the account on which the contact was created.STRING
updated_byId of the user who updated the contact.STRING
group_idid of the group in which the user is responsible for this contact.STRING
company.idid of the company that is attached to this contact.STRING
company.nameThe name of the company that is attached to this contact.STRING
leads.idid of the lead that is attached to this contact.ARRAY(STRING)
closest_task_atThe nearest task for this contact.INTEGER
tags.idId of the tag attached to this contact.ARRAY(STRING)
tags.nameThe name of the tag attached to this contact.ARRAY(STRING)
custom_fields.idId of additional field.STRING
custom_fields.nameAdditional field name.STRING
custom_fields.values.valueThe value of the custom field.ARRAY(STRING)
custom_fields.values.enumEarly identifier of the preset option for the list or multisession.ARRAY(STRING)
custom_fields.values.subtypeThe identifier of the values ​​of the additional field “address”.ARRAY(STRING)
custom_fields.is_systemIs the extra field systemic.BIT
customers.idId of the customer attached to this contact.ARRAY(STRING)
idUnique identifier of the company.STRING
nameCompany name.STRING
responsible_user_idid of the responsible user.STRING
created_byId of the user who created the company.STRING
created_atTime and Date of Company Creation.DATE
updated_atCompany time and date.DATE
account_idid of the account on which the company is established.STRING
updated_byId of the user who updated the company.STRING
group_idid of the group in which the user is responsible for the given company.STRING
contacts.idId of the contact that is attached to this company.ARRAY(STRING)
leads.idid of the lead that is attached to this company.ARRAY(STRING)
closest_task_atTime of the nearest task for this company.DATE
tags.idId of the tag attached to this company.ARRAY(STRING)
tags.nameThe name of the tag attached to this company.ARRAY(STRING)
custom_fields.idId of additional field.STRING
custom_fields.nameAdditional field name.STRING
custom_fields.values.valueThe value of the additional field.ARRAY(STRING)
custom_fields.values.enumEarly identifier of the preset option for the list or multi-selection.ARRAY(STRING)
custom_fields.values.subtypeThe identifier of the values ​​of the additional field “address”.ARRAY(STRING)
custom_fields.is_systemIs the extra field systemic.BIT
customers.idid of the customer attached to this company.ARRAY(STRING)
idThe unique identifier of the new entity.STRING
nameElement name.STRING
responsible_user_idid of the user responsible for the customer.STRING
created_byid of the user who created the customer.STRING
created_atDate and time the customer was created.DATE
updated_atDate and time of the change of the customer.DATE
account_idid of the account in which the customer was created.STRING
updated_byid of the user who changed the customer.STRING
is_deletedThe customer was deleted or not deleted.BIT
main_contact.idid of the main contact of the customer.STRING
tags.idId tag attached to this customer.ARRAY(STRING)
tags.nameThe name of the tag attached to this customer.ARRAY(STRING)
custom_fields.idId of additional field.STRING
custom_fields.nameAdditional field name.STRING
custom_fields.values.valueAdditional field value.ARRAY(STRING)
custom_fields.values.enumEarly identifier of the preset option for the list or multi-selection.ARRAY(STRING)
custom_fields.values.subtypeThe identifier of the values ​​of the additional field “address”.ARRAY(STRING)
custom_fields.is_systemIs the extra field systemic.BIT
contacts.idid of the contact attached to the lead.ARRAY(STRING)
company.idid of the company that is attached to this lead.STRING
company.namethe name of the company that is attached to the lead.STRING
next_priceExpected Amount.INTEGER
closest_task_atThe time of the nearest task for the given customer.DATE
period_idUnique period identifier, digital pipeline of customers.DATE
periodicityPeriodicity.INTEGER
next_dateNext purchase date.DATE
idThe unique identifier of the task.STRING
element_idUnique identifier of a contact or lead (lead or contact is specified in element_type).STRING
element_typeThe type of the element to be attached (1-contact, 2-lead, 3-company, 12-customer).INTEGER
complete_till_atThe date to which you want to complete the task. If the time is 23:59, then “All day” will be displayed in the system interfaces instead of time.DATE
task_typeTask type.INTEGER
textTask text.STRING
created_atDate this task was created (optional).DATE
updated_atDate of the last change of this task (optional parameter).DATE
responsible_user_idUnique identifier of the responsible user.STRING
is_completedTask completed or not.BIT
created_byUnique identifier of the task creator.STRING
account_idUnique Account ID.STRING
group_idId of the group in which the user is related to the task.STRING
idThe unique pipeline identifier.STRING
nameThe name of pipeline.STRING
sortPipeline number for display.INTEGER
is_mainIs pipeline “main”.BIT
statuses.idThe unique identifier of the step.ARRAY(STRING)
statuses.nameThe name of the phase.ARRAY(STRING)
statuses.colorStage color.ARRAY(STRING)
statuses.sortSequence number of the stage when displayed.ARRAY(INTEGER)
statuses.is_editableIs it possible to change or delete this step.ARRAY(BIT)

Квоты и лимиты

Важное примечание: Renta не предусматривает никакие ограничения, такие как количество учетных записей или временной промежуток выгрузки данных.

Лимиты AmoCRM:

  • Не более 7 запросов в секунду.

Ссылка на официальную документацию AmoCRM .