Pipedrive
Взаимодействие с CRM Pipedrive
Pipedrive — это CRM-платформа, ориентированная на продажи, предназначенная для помощи командам продаж в управлении лидами, отслеживании сделок и оптимизации воронки продаж. Разработанная с учетом простоты и эффективности, Pipedrive предоставляет интуитивно понятное визуальное управление воронкой и практическую аналитику продаж.
С помощью интеграции Pipedrive в AACFlow вы можете:
- Управлять сделками: Перечислять, получать, создавать и обновлять сделки в вашей воронке продаж
- Управлять лидами: Получать, создавать, обновлять и удалять лиды для отслеживания потенциальных клиентов
- Отслеживать активности: Получать, создавать и обновлять активности продаж, такие как звонки, встречи и задачи
- Управлять проектами: Перечислять и создавать проекты для отслеживания постпродажной реализации
- Получать доступ к воронкам: Получать конфигурации воронок и перечислять сделки в конкретных воронках
- Получать файлы: Получать доступ к файлам, прикрепленным к сделкам, контактам или другим записям
- Получать доступ к почте: Получать почтовые сообщения и цепочки, связанные с записями CRM
В AACFlow интеграция Pipedrive позволяет вашим агентам взаимодействовать с вашим рабочим процессом продаж как частью автоматизированных процессов. Агенты могут квалифицировать лиды, управлять сделками на этапах воронки, планировать активности и поддерживать синхронизацию данных CRM — обеспечивая интеллектуальную автоматизацию продаж.
Интегрируйте Pipedrive в ваш рабочий процесс. Управляйте сделками, контактами, воронкой продаж, проектами, активностями, файлами и коммуникациями с мощными возможностями CRM.
Получение всех сделок из Pipedrive с опциональными фильтрами
| Параметр | Тип | Обязательный | Описание |
|---|
status | string | Нет | Получать только сделки с определенным статусом. Значения: open, won, lost. Если опущено, возвращаются все неудаленные сделки |
person_id | string | Нет | Если указано, возвращаются только сделки, связанные с указанным лицом (например, "456") |
org_id | string | Нет | Если указано, возвращаются только сделки, связанные с указанной организацией (например, "789") |
pipeline_id | string | Нет | Если указано, возвращаются только сделки в указанной воронке (например, "1") |
updated_since | string | Нет | Если установлено, возвращаются только сделки, обновленные после этого времени. Формат: 2025-01-01T10:20:00Z |
limit | string | Нет | Количество результатов для возврата (например, "50", по умолчанию: 100, максимум: 500) |
cursor | string | Нет | Для пагинации, маркер, представляющий первый элемент на следующей странице |
| Параметр | Тип | Описание |
|---|
deals | array | Массив объектов сделок из Pipedrive |
↳ id | number | ID сделки |
↳ title | string | Заголовок сделки |
↳ value | number | Значение сделки |
↳ currency | string | Код валюты |
↳ status | string | Статус сделки (open, won, lost, deleted) |
↳ stage_id | number | ID этапа воронки |
↳ pipeline_id | number | ID воронки |
↳ person_id | number | ID связанного лица |
↳ org_id | number | ID связанной организации |
↳ owner_id | number | ID пользователя-владельца сделки |
↳ add_time | string | Когда была создана сделка (ISO 8601) |
↳ update_time | string | Когда сделка была последний раз обновлена (ISO 8601) |
↳ won_time | string | Когда сделка была выиграна |
↳ lost_time | string | Когда сделка была проиграна |
↳ close_time | string | Когда сделка была закрыта |
↳ expected_close_date | string | Ожидаемая дата закрытия |
metadata | object | Метаданные пагинации для ответа |
↳ total_items | number | Общее количество элементов |
↳ has_more | boolean | Доступны ли дополнительные элементы |
↳ next_cursor | string | Курсор для получения следующей страницы (конечные точки v2) |
↳ next_start | number | Смещение для получения следующей страницы (конечные точки v1) |
success | boolean | Статус успешности операции |
Получение подробной информации о конкретной сделке
| Параметр | Тип | Обязательный | Описание |
|---|
deal_id | string | Да | ID сделки для получения (например, "123") |
| Параметр | Тип | Описание |
|---|
deal | object | Объект сделки с полными деталями |
success | boolean | Статус успешности операции |
Создание новой сделки в Pipedrive
| Параметр | Тип | Обязательный | Описание |
|---|
title | string | Да | Заголовок сделки (например, "Лицензия на корпоративное программное обеспечение") |
value | string | Нет | Денежное значение сделки (например, "5000") |
currency | string | Нет | Код валюты (например, "USD", "EUR", "GBP") |
person_id | string | Нет | ID лица, связанного с этой сделкой (например, "456") |
org_id | string | Нет | ID организации, связанной с этой сделкой (например, "789") |
pipeline_id | string | Нет | ID воронки, в которую должна быть помещена эта сделка (например, "1") |
stage_id | string | Нет | ID этапа, в который должна быть помещена эта сделка (например, "2") |
status | string | Нет | Статус сделки: open, won, lost |
expected_close_date | string | Нет | Ожидаемая дата закрытия в формате ГГГГ-ММ-ДД (например, "2025-06-30") |
| Параметр | Тип | Описание |
|---|
deal | object | Созданный объект сделки |
success | boolean | Статус успешности операции |
Обновление существующей сделки в Pipedrive
| Параметр | Тип | Обязательный | Описание |
|---|
deal_id | string | Да | ID сделки для обновления (например, "123") |
title | string | Нет | Новый заголовок для сделки (например, "Обновленная корпоративная лицензия") |
value | string | Нет | Новое денежное значение для сделки (например, "7500") |
status | string | Нет | Новый статус: open, won, lost |
stage_id | string | Нет | Новый ID этапа для сделки (например, "3") |
expected_close_date | string | Нет | Новая ожидаемая дата закрытия в формате ГГГГ-ММ-ДД (например, "2025-07-15") |
| Параметр | Тип | Описание |
|---|
deal | object | Обновленный объект сделки |
success | boolean | Статус успешности операции |
Получение файлов из Pipedrive с опциональными фильтрами
| Параметр | Тип | Обязательный | Описание |
|---|
sort | string | Нет | Сортировка файлов по полю (поддерживается: "id", "update_time") |
limit | string | Нет | Количество результатов для возврата (например, "50", по умолчанию: 100, максимум: 100) |
start | string | Нет | Начальное смещение пагинации (0-индекс первого возвращаемого элемента) |
downloadFiles | boolean | Нет | Загружать содержимое файлов в выходные данные файлов |
| Параметр | Тип | Описание |
|---|
files | array | Массив объектов файлов из Pipedrive |
↳ id | number | ID файла |
↳ name | string | Имя файла |
↳ file_type | string | Тип/расширение файла |
↳ file_size | number | Размер файла в байтах |
↳ add_time | string | Когда файл был загружен |
↳ update_time | string | Когда файл был последний раз обновлен |
↳ deal_id | number | ID связанной сделки |
↳ person_id | number | ID связанного лица |
↳ org_id | number | ID связанной организации |
↳ url | string | URL для скачивания файла |
downloadedFiles | file[] | Загруженные файлы из Pipedrive |
total_items | number | Общее количество возвращенных файлов |
has_more | boolean | Доступны ли дополнительные файлы |
next_start | number | Смещение для получения следующей страницы |
success | boolean | Статус успешности операции |
Получение почтовых цепочек из почтового ящика Pipedrive
| Параметр | Тип | Обязательный | Описание |
|---|
folder | string | Нет | Фильтр по папке: inbox, drafts, sent, archive (по умолчанию: inbox) |
limit | string | Нет | Количество результатов для возврата (например, "25", по умолчанию: 50) |
start | string | Нет | Начальное смещение пагинации (0-индекс первого возвращаемого элемента) |
| Параметр | Тип | Описание |
|---|
messages | array | Массив объектов почтовых цепочек из почтового ящика Pipedrive |
total_items | number | Общее количество возвращенных почтовых цепочек |
has_more | boolean | Доступны ли дополнительные сообщения |
next_start | number | Смещение для получения следующей страницы |
success | boolean | Статус успешности операции |
Получение всех сообщений из конкретной почтовой цепочки
| Параметр | Тип | Обязательный | Описание |
|---|
thread_id | string | Да | ID почтовой цепочки (например, "12345") |
| Параметр | Тип | Описание |
|---|
messages | array | Массив объектов почтовых сообщений из цепочки |
metadata | object | Метаданные цепочки и пагинации |
success | boolean | Статус успешности операции |
Получение всех воронок из Pipedrive
| Параметр | Тип | Обязательный | Описание |
|---|
sort_by | string | Нет | Поле для сортировки: id, update_time, add_time (по умолчанию: id) |
sort_direction | string | Нет | Направление сортировки: asc, desc (по умолчанию: asc) |
limit | string | Нет | Количество результатов для возврата (например, "50", по умолчанию: 100, максимум: 500) |
start | string | Нет | Начальное смещение пагинации (0-индекс первого возвращаемого элемента) |
| Параметр | Тип | Описание |
|---|
pipelines | array | Массив объектов воронок из Pipedrive |
↳ id | number | ID воронки |
↳ name | string | Название воронки |
↳ url_title | string | URL-дружественное название |
↳ order_nr | number | Порядковый номер воронки |
↳ active | boolean | Активна ли воронка |
↳ deal_probability | boolean | Включена ли вероятность сделки |
↳ add_time | string | Когда была создана воронка |
↳ update_time | string | Когда воронка была последний раз обновлена |
total_items | number | Общее количество возвращенных воронок |
has_more | boolean | Доступны ли дополнительные воронки |
next_start | number | Смещение для получения следующей страницы |
success | boolean | Статус успешности операции |
Получение всех сделок в конкретной воронке
| Параметр | Тип | Обязательный | Описание |
|---|
pipeline_id | string | Да | ID воронки (например, "1") |
stage_id | string | Нет | Фильтр по конкретному этапу внутри воронки (например, "2") |
limit | string | Нет | Количество результатов для возврата (например, "50", по умолчанию: 100, максимум: 500) |
start | string | Нет | Начальное смещение пагинации (0-индекс первого возвращаемого элемента) |
| Параметр | Тип | Описание |
|---|
deals | array | Массив объектов сделок из воронки |
metadata | object | Метаданные воронки и пагинации |
success | boolean | Статус успешности операции |
Получение всех проектов или конкретного проекта из Pipedrive
| Параметр | Тип | Обязательный | Описание |
|---|
project_id | string | Нет | Опционально: ID конкретного проекта для получения (например, "123") |
status | string | Нет | Фильтр по статусу проекта: open, completed, deleted (только для перечисления всех) |
limit | string | Нет | Количество результатов для возврата (например, "50", по умолчанию: 100, максимум: 500, только для перечисления всех) |
cursor | string | Нет | Для пагинации, маркер, представляющий первый элемент на следующей странице |
| Параметр | Тип | Описание |
|---|
projects | array | Массив объектов проектов (при перечислении всех) |
project | object | Объект одного проекта (когда указан project_id) |
total_items | number | Общее количество возвращенных проектов |
has_more | boolean | Доступны ли дополнительные проекты |
next_cursor | string | Курсор для получения следующей страницы |
success | boolean | Статус успешности операции |
Создание нового проекта в Pipedrive
| Параметр | Тип | Обязательный | Описание |
|---|
title | string | Да | Заголовок проекта (например, "Маркетинговая кампания Q2") |
description | string | Нет | Описание проекта |
start_date | string | Нет | Дата начала проекта в формате ГГГГ-ММ-ДД (например, "2025-04-01") |
end_date | string | Нет | Дата окончания проекта в формате ГГГГ-ММ-ДД (например, "2025-06-30") |
| Параметр | Тип | Описание |
|---|
project | object | Созданный объект проекта |
success | boolean | Статус успешности операции |
Получение активностей (задач) из Pipedrive с опциональными фильтрами
| Параметр | Тип | Обязательный | Описание |
|---|
user_id | string | Нет | Фильтр активностей по ID пользователя (например, "123") |
type | string | Нет | Фильтр по типу активности (call, meeting, task, deadline, email, lunch) |
done | string | Нет | Фильтр по статусу завершения: 0 для невыполненных, 1 для выполненных |
limit | string | Нет | Количество результатов для возврата (например, "50", по умолчанию: 100, максимум: 500) |
start | string | Нет | Начальное смещение пагинации (0-индекс первого возвращаемого элемента) |
| Параметр | Тип | Описание |
|---|
activities | array | Массив объектов активностей из Pipedrive |
↳ id | number | ID активности |
↳ subject | string | Тема активности |
↳ type | string | Тип активности (call, meeting, task и т.д.) |
↳ due_date | string | Срок выполнения (ГГГГ-ММ-ДД) |
↳ due_time | string | Время выполнения (ЧЧ:ММ) |
↳ duration | string | Продолжительность (ЧЧ:ММ) |
↳ deal_id | number | ID связанной сделки |
↳ person_id | number | ID связанного лица |
↳ org_id | number | ID связанной организации |
↳ done | boolean | Выполнена ли активность |
↳ note | string | Заметка активности |
↳ add_time | string | Когда была создана активность |
↳ update_time | string | Когда активность была последний раз обновлена |
total_items | number | Общее количество возвращенных активностей |
has_more | boolean | Доступны ли дополнительные активности |
next_start | number | Смещение для получения следующей страницы |
success | boolean | Статус успешности операции |
Создание новой активности (задачи) в Pipedrive
| Параметр | Тип | Обязательный | Описание |
|---|
subject | string | Да | Тема/заголовок активности (например, "Последующий звонок с Джоном") |
type | string | Да | Тип активности: call, meeting, task, deadline, email, lunch |
due_date | string | Да | Срок выполнения в формате ГГГГ-ММ-ДД (например, "2025-03-15") |
due_time | string | Нет | Время выполнения в формате ЧЧ:ММ (например, "14:30") |
duration | string | Нет | Продолжительность в формате ЧЧ:ММ (например, "01:00" для 1 часа) |
deal_id | string | Нет | ID сделки для связи (например, "123") |
person_id | string | Нет | ID лица для связи (например, "456") |
org_id | string | Нет | ID организации для связи (например, "789") |
note | string | Нет | Заметки для активности |
| Параметр | Тип | Описание |
|---|
activity | object | Созданный объект активности |
success | boolean | Статус успешности операции |
Обновление существующей активности (задачи) в Pipedrive
| Параметр | Тип | Обязательный | Описание |
|---|
activity_id | string | Да | ID активности для обновления (например, "12345") |
subject | string | Нет | Новая тема/заголовок для активности (например, "Обновленная встреча с клиентом") |
due_date | string | Нет | Новый срок выполнения в формате ГГГГ-ММ-ДД (например, "2025-03-20") |
due_time | string | Нет | Новое время выполнения в формате ЧЧ:ММ (например, "15:00") |
duration | string | Нет | Новая продолжительность в формате ЧЧ:ММ (например, "00:30" для 30 минут) |
done | string | Нет | Отметить как выполненную: 0 для невыполненных, 1 для выполненных |
note | string | Нет | Новые заметки для активности |
| Параметр | Тип | Описание |
|---|
activity | object | Обновленный объект активности |
success | boolean | Статус успешности операции |
Получение всех лидов или конкретного лида из Pipedrive
| Параметр | Тип | Обязательный | Описание |
|---|
lead_id | string | Нет | Опционально: ID конкретного лида для получения (например, "abc123-def456-ghi789") |
archived | string | Нет | Получать архивные лиды вместо активных (например, "true" или "false") |
owner_id | string | Нет | Фильтр по ID пользователя-владельца (например, "123") |
person_id | string | Нет | Фильтр по ID лица (например, "456") |
organization_id | string | Нет | Фильтр по ID организации (например, "789") |
limit | string | Нет | Количество результатов для возврата (например, "50", по умолчанию: 100, максимум: 500) |
start | string | Нет | Начальное смещение пагинации (0-индекс первого возвращаемого элемента) |
| Параметр | Тип | Описание |
|---|
leads | array | Массив объектов лидов (при перечислении всех) |
↳ id | string | ID лида (UUID) |
↳ title | string | Заголовок лида |
↳ person_id | number | ID связанного лица |
↳ organization_id | number | ID связанной организации |
↳ owner_id | number | ID владельца лида |
↳ value | object | Значение лида |
↳ amount | number | Сумма значения |
↳ currency | string | Код валюты (например, USD, EUR) |
↳ expected_close_date | string | Ожидаемая дата закрытия (ГГГГ-ММ-ДД) |
↳ is_archived | boolean | Архивирован ли лид |
↳ was_seen | boolean | Был ли лид просмотрен |
↳ add_time | string | Когда был создан лид (ISO 8601) |
↳ update_time | string | Когда лид был последний раз обновлен (ISO 8601) |
lead | object | Объект одного лида (когда указан lead_id) |
↳ id | string | ID лида (UUID) |
↳ title | string | Заголовок лида |
↳ person_id | number | ID связанного лица |
↳ organization_id | number | ID связанной организации |
↳ owner_id | number | ID владельца лида |
↳ value | object | Значение лида |
↳ amount | number | Сумма значения |
↳ currency | string | Код валюты (например, USD, EUR) |
↳ expected_close_date | string | Ожидаемая дата закрытия (ГГГГ-ММ-ДД) |
↳ is_archived | boolean | Архивирован ли лид |
↳ was_seen | boolean | Был ли лид просмотрен |
↳ add_time | string | Когда был создан лид (ISO 8601) |
↳ update_time | string | Когда лид был последний раз обновлен (ISO 8601) |
total_items | number | Общее количество возвращенных лидов |
has_more | boolean | Доступны ли дополнительные лиды |
next_start | number | Смещение для получения следующей страницы |
success | boolean | Статус успешности операции |
Создание нового лида в Pipedrive
| Параметр | Тип | Обязательный | Описание |
|---|
title | string | Да | Название лида (например, "Acme Corp - Редизайн веб-сайта") |
person_id | string | Нет | ID лица (ОБЯЗАТЕЛЬНО, если не указан organization_id) (например, "456") |
organization_id | string | Нет | ID организации (ОБЯЗАТЕЛЬНО, если не указан person_id) (например, "789") |
owner_id | string | Нет | ID пользователя, который будет владеть лидом (например, "123") |
value_amount | string | Нет | Потенциальная сумма значения (например, "10000") |
value_currency | string | Нет | Код валюты (например, "USD", "EUR", "GBP") |
expected_close_date | string | Нет | Ожидаемая дата закрытия в формате ГГГГ-ММ-ДД (например, "2025-04-15") |
visible_to | string | Нет | Видимость: 1 (Владелец и подписчики), 3 (Вся компания) |
| Параметр | Тип | Описание |
|---|
lead | object | Созданный объект лида |
success | boolean | Статус успешности операции |
Обновление существующего лида в Pipedrive
| Параметр | Тип | Обязательный | Описание |
|---|
lead_id | string | Да | ID лида для обновления (например, "abc123-def456-ghi789") |
title | string | Нет | Новое название для лида (например, "Обновленный лид - Премиум пакет") |
person_id | string | Нет | Новый ID лица (например, "456") |
organization_id | string | Нет | Новый ID организации (например, "789") |
owner_id | string | Нет | Новый ID пользователя-владельца (например, "123") |
value_amount | string | Нет | Новая сумма значения (например, "15000") |
value_currency | string | Нет | Новый код валюты (например, "USD", "EUR", "GBP") |
expected_close_date | string | Нет | Новая ожидаемая дата закрытия в формате ГГГГ-ММ-ДД (например, "2025-05-01") |
is_archived | string | Нет | Архивировать лид: true или false |
| Параметр | Тип | Описание |
|---|
lead | object | Обновленный объект лида |
success | boolean | Статус успешности операции |
Удаление конкретного лида из Pipedrive
| Параметр | Тип | Обязательный | Описание |
|---|
lead_id | string | Да | ID лида для удаления (например, "abc123-def456-ghi789") |
| Параметр | Тип | Описание |
|---|
data | object | Данные подтверждения удаления |
success | boolean | Статус успешности операции |
