Pipedrive
Renta выгружает в ваше хранилище данных 26 объектов Pipedrive: сделки, лиды, контакты, организации, товары, активности, журнал звонков, заметки, файлы и почтовые цепочки. Вторая группа типов отчётов описывает аккаунт вокруг этих записей: воронки, этапы, команды, пользователей, роли, наборы прав и определения всех системных и кастомных полей.
Поля каждого объек та вы выбираете сами. Значения кастомных полей приходят одной колонкой Custom Fields, где каждое значение лежит под ключом поля Pipedrive, а отчёты с определениями полей возвращают этим ключам названия.
Каждый тип отчёта перезагружается целиком на каждом запуске, поэтому таблица назначения повторяет состояние аккаунта Pipedrive на момент старта запуска.
Аутентификация
Renta подключается к Pipedrive по личному API-ключу. Вы копируете ключ в настройках Pipedrive и вставляете его в форму подключения.
Подключение источника Pipedrive
Выполните эти шаги, чтобы добавить Pipedrive как источник в Renta по личному API-ключу.
- Откройте раздел Connections > Catalog в левой панели.
- Откройте категорию CRM и нажмите на карточку Pipedrive.
В поле API key вставьте свой личный API-ключ Pipedrive.
Чтобы найти его, откройте имя аккаунта в правом верхнем углу Pipedrive, затем Company settings > Personal preferences > API.
- В поле Source name укажите название источника данных. Оно используется только в интерфейсе Renta.
- Нажмите Save.
Перед сохранением подключения Renta проверяет ключ в Pipedrive, поэтому неверный или отозванный ключ не пройдёт этот шаг.
Новый источник появляется в списке Sources со статусом Active. Теперь его можно использовать в пайплайнах.
Создание пайплайна
Когда источник подключён, создайте пайплайн, чтобы синхронизировать данные Pipedrive с вашим назначением.
Создание пайплайна Pipedrive
Свяжите источник Pipedrive с назначением и настройте пайплайн.
В левой панели нажмите New pipeline. На шаге Source выберите Pipedrive в разделе Already connected и нажмите Next step.
Выберите созданное ранее подключение Pipedrive и нажмите Next step. На карточке видно название подключения и дату, когда оно было добавлено.
На шаге Destination выберите ваше назначение (например, Google BigQuery) и нажмите Next step.
Выберите подключение назначения, куда нужно загрузить данные, и нажмите Next step. На карточке видно датасет и проект, в которые попадут данные.
Настройка пайплайна
На последнем шаге выберите отчёт, его поля и расписание.
Тип отчёта
Выберите, какой объект Pipedrive выгружает пайплайн. Один пайплайн загружает один тип отчёта.
| Тип отчёта | Описание |
|---|---|
| Activities | Звонки, встречи и задачи с их типом, сроком, длительностью и признаком выполнения, запись, к которой они относятся, и место встречи, разложенное на улицу, город и страну. |
| Activity Types | Типы активностей, заведённые в аккаунте: название, иконка, цвет и порядок. |
| Call Logs | Журнал звонков: результат, длительность, оба номера телефона, время начала и окончания, а также связанные активность, контакт, организация, сделка или лид. |
| Currencies | Валюты, доступные в аккаунте, с их кодом, символом и точностью. |
| Deal Fields | Определения всех полей сделки, системных и кастомных: ключ, название, тип поля и флаги поведения. |
| Deals | Сделки с их суммой, валютой, этапом, статусом и вероятностью. В строке также есть время выигрыша, проигрыша и закрытия, счётчики связанных активностей, файлов и писем, связанные контакт и организация, а также значения кастомных полей. |
| Files | Файлы, прикреплённые к записям: название, размер, тип, место хранения и запись, к которой они относятся. |
| Filters | Сохранённые фильтры: тип, видимость, владелец и время последнего использования. |
| Goals | Цели компании, команды и пользователя: ожидаемый результат, период, воронка, этап и отчёт о прогрессе. |
| Lead Sources | Источники лидов, доступные в аккаунте. |
| Leads | Лиды с их суммой и валютой, ожидаемой датой закрытия, источником, происхождением и каналом, связанными контактом и организацией, а также признаком архива. |
| Legacy Teams | Команды с их руководителем, составом и количеством активных участников. |
| Mailbox | Почтовые цепочки: тема, фрагмент письма, участники, папки, количество сообщений, признаки прочтения и вложений, а также связанные сделка, лид или проект. |
| Notes | Заметки с их содержимым, автором, признаками закрепления и записью, к которой они относятся. |
| Organization Fields | Определения всех полей организации, системных и кастомных. |
| Organizations | Организации с адресом, разложенным на составляющие, отраслью, годовой выручкой, числом сотрудников, владельцем и счётчиками открытых, выигранных и проигранных сделок. |
| Permission Sets | Наборы прав: тип, приложение и количество назначений. |
| Person Fields | Определения всех полей контакта, системных и кастомных. |
| Persons | Контакты с их телефонами, почтами и мессенджерами, почтовым адресом, должностью, владельцем, связанной организацией, счётчиками сделок и значениями кастомных полей. |
| Pipelines | Воронки: порядок, вероятность сделки по умолчанию и признак активности. |
| Product Fields | Определения всех полей товара, системных и кастомных. |
| Products | Товары с их артикулом, единицей измерения, налогом, категорией, периодичностью выставления счетов и прайс-листом по валютам. |
| Roles | Роли: родительская роль, уровень, описание и количество назначений. |
| Stages | Этапы с воронкой, к которой они относятся, порядком, вероятностью сделки и настройками протухания. |
| User Settings | Настройки аккаунта, которому принадлежит API-ключ: валюта по умолчанию, финансовый год, условия поиска дублей, правила синхронизации почты и настройки уведомлений. |
| Users | Пользователи с их почтой, языком, часовым поясом, ролью, признаками администратора и активности, а также правами доступа по функциям. |
Параметры
Выберите поля Pipedrive, которые попадут в таблицу назначения.
В каждой строке видно название поля, а под ним название колонки, которую поле займёт в таблице назначения. Найдите параметр по названию через поле поиска или нажмите Select All. На вкладке Selected собрано всё, что вы выбрали, а список Selected Parameters под выбором позволяет удалить параметр.
Набор доступных полей зависит от типа отчёта. Два из них стоит добавлять в любой пайплайн: ID, по которому опознаётся запись, и Update Time, по которому Renta партиционирует таблицу назначения.
Вложенные объекты, которые отдаёт Pipedrive, Renta раскладывает по колонкам. Владелец, контакт и организация записи приходят отдельными колонками для идентификатора, имени и почты. Адрес организации и место активности приходят дважды: целой строкой и отдельными составляющими, такими как улица, город и страна.
Поля, в которых лежит список значений, загружаются вложенными записями.
| Тип отчёта | Поля, которые загружаются вложенными записями |
|---|---|
| Activities | Participants |
| Legacy Teams | Users |
| Mailbox | Parties |
| Persons | Phone, Email, IM |
| Products | Prices |
| Users | Access |
Поля, структура которых зависит от самой записи, приходят в формате JSON. Это Custom Fields в отчётах Deals и Persons, Label IDs, Attendees и Series в Activities, Expected Outcome и Report в Goals, а также объекты с настройками в User Settings.
Название таблицы
Задайте название пайплайна и таблицы назначения.
- Integration name.
Название пайплайна. Оно используется только в интерфейсе Renta. - Table name.
Назва ние таблицы назначения. Можно оставить сгенерированное название или ввести своё.
Расписание
Выберите, как часто запускается пайплайн.
| Тип расписания | Описание |
|---|---|
| Manual | Пайплайн запускается только вручную через интерфейс или по API. |
| Daily | Пайплайн запускается раз в день в указанное время обновления. |
| Interval | Пайплайн запускается через указанные интервалы времени. |
| Cron Expression | Пайплайн запускается по расписанию, заданному cron-выражением. |
Для расписания Daily укажите Update time (точное время запуска), затем нажмите Create pipeline.
Новый пайплайн появляется в разделе Pipelines на вкладке ETL, где видно его запуски, прогресс и название таблицы назначения.
Стратегия синхронизации
Все типы отчётов Pipedrive Renta синхронизирует одинаково.
| Стратегия | Поддерживаемые типы отчётов | Описание |
|---|---|---|
| Полная перезагрузка | Activities, Activity Types, Call Logs, Currencies, Deal Fields, Deals, Files, Filters, Goals, Lead Sources, Leads, Legacy Teams, Mailbox, Notes, Organization Fields, Organizations, Permission Sets, Person Fields, Persons, Pipelines, Product Fields, Products, Roles, Stages, User Settings, Users | Renta на каждом запуске читает объект целиком и заменяет содержимое таблицы назначения. Таблица повторяет состояние аккаунта Pipedrive на момент запуска, а запись, которую Pipedrive перестал отдавать, уходит из таблицы на следующем запуске. |
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.