Renta / Документация / Назначения / Pipedrive

Pipedrive

Renta записывает строки из вашего хранилища данных в Pipedrive: контакты, организации, сделки и лиды.

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

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

Renta авторизуется личным API-токеном Pipedrive. Токен наследует права своего владельца, поэтому используйте аккаунт, который видит и может править нужные записи.

Подключение назначения Pipedrive

Откройте каталогStep 1
  1. Перейдите в раздел Connections > Catalog в левом меню и откройте вкладку Destinations.
  2. Раскройте категорию Reverse ETL и нажмите карточку Pipedrive.
Карточка Pipedrive в категории Reverse ETL каталога назначений Renta
Введите API-токенStep 2
  1. Destination name.
    Укажите имя этого назначения. Оно используется только в интерфейсе Renta.
  2. API token.
    Личный API-токен Pipedrive. Он лежит в Pipedrive в разделе Settings > Personal preferences > API.

Нажмите Save. Renta проверяет токен обращением к вашему аккаунту Pipedrive до сохранения, поэтому неверный или отозванный токен отклоняется сразу, а не на первом запуске.

Страница подключения Pipedrive с полями имени назначения и API-токена
Назначение созданоStep 3

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

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

Подготовьте модель данных

Пайплайн Reverse ETL читает данные из модели: это SQL-запрос, сохранённый в разделе Data models, который решает, какие строки хранилища синхронизировать и что лежит в каждой строке. Создайте её до пайплайна, потому что выпадающие списки маппинга заполняются её колонками.

Дайте каждой строке колонку, по которой будете сопоставлять, и поля, без которых Pipedrive не создаст запись. Для контактов это имя, для сделок и лидов заголовок.

-- Contacts prepared for Pipedrive persons.
-- The query returns rows only, no table is created.
WITH demo_persons AS (
  SELECT
    'james.miller@example.com'  AS email,
    'James Miller'              AS name,
    '+12125550101'              AS phone
  UNION ALL SELECT 'olivia.johnson@example.com','Olivia Johnson','+13125550102'
  UNION ALL SELECT 'william.davis@example.com', 'William Davis', '+12145550103'
)
SELECT * FROM demo_persons

Создание модели данных

Напишите запросStep 1

В левом меню откройте Data models и нажмите New model. Дальше:

  1. Source.
    Выберите подключение к хранилищу, к которому пойдёт запрос.
  2. Write your model query.
    Вставьте свой SQL. Тип запроса оставьте SQL query.
  3. Run preview.
    Проверьте строки и названия колонок.

В качестве области выберите Reverse ETL only и нажмите Next step.

Шаг Data source с SQL-редактором и предпросмотром строк контактов
Проверьте колонки и выберите ключStep 2

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

На последнем шаге дайте модели имя и нажмите Create model. Это имя вы выберете в списке Data model при создании пайплайна.

Шаг Schema с тремя колонками модели контактов и уникальным ключом на email

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

Назначение и модель данных должны существовать до начала настройки.

Выберите хранилищеStep 1

В левом меню нажмите New pipeline. На шаге Source переключите тумблер в положение Reverse ETL и выберите своё хранилище, например Google BigQuery.

Шаг выбора источника с переключателем Reverse ETL и карточкой Google BigQuery
Выберите подключение к хранилищуStep 2

Выберите подключение к хранилищу, в котором лежат ваши модели данных, и нажмите Next step.

Шаг выбора подключения Google BigQuery со списком доступных подключений
Выберите Pipedrive как назначениеStep 3

На шаге Destination выберите Pipedrive в блоке Already connected и нажмите Next step.

Шаг выбора назначения с Pipedrive в блоке Already connected
Выберите подключение назначенияStep 4

Выберите созданное ранее подключение Pipedrive и нажмите Next step.

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

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

На последнем шаге выберите, каким объектом Pipedrive станут строки и как Renta узнаёт уже записанную запись.

Что отправляет Renta

Выберите объект и модель данных.

Настройки пайплайна Pipedrive с выбором объекта и списком моделей данных
ОбъектОписание
PersonsКонтакты. Сопоставление по email, имени, телефону или Pipedrive ID.
OrganizationsКомпании. Сопоставление по названию или Pipedrive ID.
DealsСделки в воронке. Сопоставление по заголовку или Pipedrive ID.
LeadsЛиды во входящих. Сопоставление по заголовку или Pipedrive ID.

Data model задаёт строки для синхронизации. Колонки, доступные для сопоставления и маппинга ниже, берутся из неё.

Сопоставление записей

Укажите, какая колонка идентифицирует запись. Собственного upsert у Pipedrive нет, поэтому каждый объект записывается через поиск с последующим обновлением или созданием, и поиск идёт именно по этому полю.

Блок сопоставления записе�й с колонкой источника слева и полем Pipedrive справа

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

Pipedrive ID доступен только в режиме Update. Создать запись по внутреннему идентификатору нельзя, поэтому вместе с Upsert или Mirror пайплайн не сохранится.

Маппинг полей

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

Сопоставление колонок модели данных с полями контакта Pipedrive
ОбъектОбязательное поле
PersonsName
OrganizationsName
DealsTitle
LeadsTitle, а также Person ID или Organization ID

Лид должен принадлежать человеку или организации, которые уже есть в Pipedrive. Родительскую запись Renta не создаёт, поэтому замаппьте Person ID или Organization ID на колонку с уже существующим идентификатором.

Renta никогда не создаёт кастомные поля. Сначала заведите поле в Pipedrive, и оно появится в этом списке. Денежному полю нужна ещё и валюта: без неё Pipedrive не понимает, в чём выражена сумма, и Renta попросит замаппить её до сохранения.

Поведение синхронизации

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

Списки Sync mode и When a source row is deleted вместе с полем имени интеграции

  1. Sync mode Как записывается строка.

    РежимОписание
    UpsertОбновить найденную запись или создать новую, если совпадения нет. Вариант по умолчанию.
    UpdateТолько обновлять найденные записи. Строка без совпадения отклоняется, ничего не создаётся.
    MirrorЗаписывать присутствующие строки и применять политику удалённых строк к тем, что ушли из модели.

  2. When a source row is deleted Что происходит с записью, чьей строки больше нет. Действует только в режиме Mirror.

    ВариантОписание
    IgnoreОставить запись в Pipedrive нетронутой. Вариант по умолчанию.
    DeleteУдалить запись. Она попадает в корзину Pipedrive и восстанавливается в течение 30 дней.

  3. Integration name.
    Имя вашего пайплайна. Измените его под свои задачи.

Расписание

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

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

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

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

Новый пайплайн появится в разделе Pipelines на вкладке Reverse ETL, где видно его запуски и прогресс.

Список пайплайнов Reverse ETL с новой интеграцией Pipedrive

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

Renta синхронизирует данные инкрементально. Запуск сравнивает модель с состоянием, которое записал предыдущий запуск, и отправляет только изменения, поэтому ночная синхронизация затрагивает несколько записей, а не весь список. Первому запуску не с чем сравнивать, поэтому он доставляет модель целиком.

Состояние строкиЧто делает Renta
НоваяИщет по полю сопоставления, затем обновляет найденную запись или создаёт новую. В режиме Update строка без совпадения отклоняется.
ИзменённаяЗаписывает новые значения в найденную запись.
Без измененийНичего не отправляет.
УдалённаяСледует политике удалённых строк, которая действует только в режиме Mirror: оставляет запись или удаляет её.

Ограничения

  1. Каждая запись стоит одного поиска.
    У Pipedrive нет upsert, поэтому каждая строка это поиск плюс запись. Renta держит их в разных бюджетах запросов, потому что Search API у Pipedrive ограничен заметно жёстче остальных методов, но первый большой запуск всё равно идёт ощутимо дольше инкрементального.
  2. Поисковый индекс отстаёт на несколько секунд.
    Только что созданная запись может ещё не находиться поиском, поэтому запуск сразу после предыдущего способен создать дубль. Запуски по расписанию в это окно не попадают.
  3. Кастомные поля должны существовать заранее.
    Renta маппит на поля, которые уже есть в аккаунте, и никогда их не создаёт.
  4. Лиду нужен существующий родитель.
    Лид отклоняется, если не ссылается на человека или организацию, уже заведённых в Pipedrive.
  5. Запуск останавливается при потоке отказов.
    Renta останавливает запуск, когда отклонено больше 30% партии или больше 10% строк, доставленных с начала запуска. Уже записанные записи остаются, а следующий запуск продолжит с места остановки.
Часто задаваемые вопросы

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.