Pipedrive
Pipedrive — это средство управления конвейерами CRM и конвейера, которое помогает сосредоточиться на действиях, которые имеют значение.
Этот соединитель доступен в следующих продуктах и регионах:
| Услуга | Class | Регионы |
|---|---|---|
| Copilot Studio | Премия | Все регионы Power Automate , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Логические приложения | Стандарт | Все регионы Logic Apps , кроме следующих: — Регионы Azure для государственных организаций — Регионы Azure Для Китая - Министерство обороны США (DoD) |
| Power Apps | Премия | Все регионы Power Apps , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Power Automate | Премия | Все регионы Power Automate , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Контакт | |
|---|---|
| Имя | Microsoft |
| URL |
Поддержка Microsoft LogicApps Поддержка Microsoft Power Automate Поддержка Microsoft Power Apps |
| Метаданные соединителя | |
|---|---|
| Publisher | Microsoft |
| Веб-сайт | https://www.pipedrive.com/ |
| Политика конфиденциальности | https://www.pipedrive.com/privacy |
Создание подключения
Соединитель поддерживает следующие типы проверки подлинности:
| По умолчанию | Параметры для создания подключения. | Все регионы | Недоступен для совместного использования |
По умолчанию
Применимо: все регионы
Параметры для создания подключения.
Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.
| Имя | Тип | Description | Обязательно |
|---|---|---|---|
| Ключ API | securestring | Ключ API | True |
Ограничения регулирования
| Имя | Вызовы | Период обновления |
|---|---|---|
| Вызовы API для каждого подключения | 100 | 60 секунд |
| Частота опросов триггеров | 1 | 120 секунд |
Действия
| Добавление действия |
Эта операция используется для создания нового действия для авторизованной учетной записи. |
| Добавление сделки (версия 2) (предварительная версия) |
Эта операция создает новую сделку для авторизованной учетной записи. |
| Добавление сделки [DEPRECATED] |
Это действие устарело. Вместо этого используйте команду add deal (V2).
|
| Обновление состояния сделки |
Эта операция используется для обновления состояния, связанного с сделкой, с учетом его идентификатора. |
| Получение сделки по идентификатору |
Эта операция извлекает все сведения о существующей сделке, учитывая его идентификатор. |
| Получение этапа по идентификатору |
Эта операция возвращает данные о определенной стадии. |
| Этап обновления сделки [не рекомендуется] |
Это действие устарело. Вместо этого используйте этап сделки с обновлением (версия 2 ).
|
| Этап сделки обновления (версия 2) (предварительная версия) |
Эта операция используется для обновления этапа, связанного с сделкой, с учетом его идентификатора. |
Добавление действия
Эта операция используется для создания нового действия для авторизованной учетной записи.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Тип
|
type | True | string |
Тип действия. |
|
Тема
|
subject | True | string |
Тема действия. |
|
Срок
|
due_date | string |
ГГГГ-ММ-ДД |
|
|
Время выполнения
|
due_time | string |
HH:MM |
|
|
Продолжительность
|
duration | string |
HH:MM |
|
|
Примечания.
|
note | string | ||
|
Кому назначено:
|
user_id | integer |
Идентификатор пользователя, которому будет назначено действие. |
|
|
Идентификатор сделки
|
deal_id | integer |
Идентификатор сделки, с которым будет связан действие. |
|
|
Контактный номер
|
person_id | integer |
Идентификатор пользователя, с которым будет связана активность. |
|
|
Идентификатор организации
|
org_id | integer |
Идентификатор организации, с которым будет связана активность. |
Возвращаемое значение
данные
- Тело
- ActivityResponse
Добавление сделки (версия 2) (предварительная версия)
Эта операция создает новую сделку для авторизованной учетной записи.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Название
|
title | True | string |
Название сделки. |
|
Идентификатор конвейера
|
pipeline_id | string |
Идентификатор конвейера для получения этапов. |
|
|
Идентификатор этапа
|
stage_id | string |
Этап сделки. |
|
|
Состояние
|
status | string |
Состояние сделки. |
|
|
Ценность
|
value | integer |
Денежное значение сделки. |
|
|
Валюта
|
currency | string |
Валюта сделки. |
|
|
Контактный номер
|
person_id | string |
Идентификатор пользователя, с которым связана сделка. |
|
|
Идентификатор организации
|
org_id | string |
Идентификатор организации, связанной с сделкой. |
|
|
Ожидаемая дата закрытия
|
expected_close_date | string |
yyyy-MM-dd |
|
|
Visiblity
|
visible_to | string |
Владелец, последователи или вся компания. |
Возвращаемое значение
данные
- Тело
- DealResponseV2
Добавление сделки [DEPRECATED]
Это действие устарело. Вместо этого используйте команду add deal (V2).
Эта операция создает новую сделку для авторизованной учетной записи.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Название
|
title | True | string |
Название сделки. |
|
Идентификатор этапа
|
stage_id | string |
Этап сделки. |
|
|
Состояние
|
status | string |
Состояние сделки. |
|
|
Ценность
|
value | integer |
Денежное значение сделки. |
|
|
Валюта
|
currency | string |
Валюта сделки. |
|
|
Контактный номер
|
person_id | string |
Идентификатор пользователя, с которым связана сделка. |
|
|
Идентификатор организации
|
org_id | string |
Идентификатор организации, связанной с сделкой. |
|
|
Ожидаемая дата закрытия
|
expected_close_date | string |
yyyy-MM-dd |
|
|
Visiblity
|
visible_to | string |
Владелец, последователи или вся компания. |
Возвращаемое значение
данные
- Тело
- DealResponse
Обновление состояния сделки
Эта операция используется для обновления состояния, связанного с сделкой, с учетом его идентификатора.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор сделки
|
dealId | True | integer |
Сделка |
|
Состояние
|
status | True | string |
Состояние сделки. |
|
Потерянная причина
|
lost_reason | string |
Сообщение о том, почему сделка была потеряна. |
Возвращаемое значение
данные
- Тело
- DealResponse
Получение сделки по идентификатору
Эта операция извлекает все сведения о существующей сделке, учитывая его идентификатор.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор сделки
|
dealId | True | integer |
Сделка |
Возвращаемое значение
данные
- Тело
- DealResponse
Получение этапа по идентификатору
Эта операция возвращает данные о определенной стадии.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор этапа
|
stageId | True | integer |
Идентификатор этапа |
Возвращаемое значение
- Тело
- StageResponse
Этап обновления сделки [не рекомендуется]
Это действие устарело. Вместо этого используйте этап сделки с обновлением (версия 2 ).
Эта операция используется для обновления этапа, связанного с сделкой, с учетом его идентификатора.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор сделки
|
dealId | True | integer |
Сделка |
|
Идентификатор этапа
|
stage_id | True | string |
Этап сделки. |
|
Ожидаемая дата закрытия
|
expected_close_date | string |
yyyy-MM-dd |
Возвращаемое значение
данные
- Тело
- DealResponse
Этап сделки обновления (версия 2) (предварительная версия)
Эта операция используется для обновления этапа, связанного с сделкой, с учетом его идентификатора.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор сделки
|
dealId | True | integer |
Сделка |
|
Идентификатор конвейера
|
pipeline_id | True | string |
Идентификатор конвейера для получения этапов. |
|
Идентификатор этапа
|
stage_id | True | string |
Этап сделки. |
|
Ожидаемая дата закрытия
|
expected_close_date | string |
yyyy-MM-dd |
Возвращаемое значение
данные
- Тело
- DealResponseV2
Триггеры
| При добавлении нового действия |
Активирует при добавлении нового действия в авторизованную учетную запись. |
| При добавлении новой сделки (версия 2) (предварительная версия) |
Активирует при добавлении новой сделки в авторизованную учетную запись (V2). |
| При добавлении новой сделки [DEPRECATED] |
Это действие устарело. Вместо этого используйте команду "При добавлении новой сделки" (V2).
|
При добавлении нового действия
Активирует при добавлении нового действия в авторизованную учетную запись.
Возвращаемое значение
данные
- Тело
- ActivityResponse
При добавлении новой сделки (версия 2) (предварительная версия)
Активирует при добавлении новой сделки в авторизованную учетную запись (V2).
Возвращаемое значение
данные
- Тело
- DealResponseV2
При добавлении новой сделки [DEPRECATED]
Это действие устарело. Вместо этого используйте команду "При добавлении новой сделки" (V2).
Активирует при добавлении новой сделки в авторизованную учетную запись.
Возвращаемое значение
данные
- Тело
- DealResponse
Определения
StageResponse
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Идентификатор этапа
|
id | integer |
Идентификатор этапа |
|
Имя этапа
|
name | string |
Сценическое имя |
ActivityResponse
данные
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Идентификатор действия
|
id | integer |
Уникальный идентификатор действия. |
|
Идентификатор пользователя
|
user_id | integer |
Идентификатор пользователя, которому назначено действие. |
|
Готово
|
done | boolean |
0 = Не сделано, 1 = Готово |
|
Тип
|
type | string |
Тип действия. |
|
Срок
|
due_date | string |
ГГГГ-ММ-ДД |
|
Время выполнения
|
due_time | string |
HH:MM |
|
Продолжительность
|
duration | string |
HH:MM |
|
Тема
|
subject | string |
Тема действия. |
|
Идентификатор сделки
|
deal_id | integer |
Идентификатор сделки, с которым связано действие. |
|
Название сделки
|
deal_title | string |
Название сделки, с которым связано действие. |
|
Идентификатор организации
|
org_id | integer |
Идентификатор организации, с которым связано действие. |
|
Название организации
|
org_name | string |
Имя организации, с которым связано действие. |
|
Контактный номер
|
person_id | integer |
Идентификатор пользователя, с которым связано действие. |
|
Имя контактного лица
|
person_name | string |
Имя пользователя, с которым связано действие. |
|
Создан Date-Time
|
add_time | date-time |
гггг-ММ-ддTHH:мм:ss.fffZ |
|
Обновления Date-Time
|
update_time | date-time |
гггг-ММ-ддTHH:мм:ss.fffZ |
|
Завершено Date-Time
|
marked_as_done_time | date-time |
гггг-ММ-ддTHH:мм:ss.fffZ |
|
Идентификатор события Google Calendar
|
gcal_event_id | string |
Идентификатор события календаря Google. |
|
Идентификатор календаря Google
|
google_calendar_id | string |
Идентификатор календаря Google. |
|
Замечание
|
note | string |
Обратите внимание на действие (формат HTML). |
|
Кому назначено:
|
assigned_to_user_id | integer |
Идентификатор пользователя, которому назначено действие. |
|
Кем создано:
|
created_by_user_id | integer |
Идентификатор пользователя, создавшего действие. |
|
Имя владельца
|
owner_name | string |
Имя владельца действия. |
DealResponse
данные
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Идентификатор сделки
|
id | integer |
Идентификатор сделки. |
|
Идентификатор
|
creator_user_id.id | integer |
Идентификатор создателя сделки. |
|
Имя
|
creator_user_id.name | string |
Имя создателя сделки. |
|
Адрес электронной почты
|
creator_user_id.email | string |
Электронная почта создателя сделки. |
|
Идентификатор
|
user_id.id | integer |
Идентификатор владельца сделки. |
|
Имя
|
user_id.name | string |
Имя владельца сделки. |
|
Адрес электронной почты
|
user_id.email | string |
Электронная почта владельца сделки. |
|
Имя
|
person_id.name | string |
Имя лица, связанного с сделкой. |
|
Идентификатор
|
person_id.value | integer |
Идентификатор лица, связанного с сделкой. |
|
Имя
|
org_id.name | string |
Имя организации, связанной с сделкой. |
|
Идентификатор
|
org_id.value | integer |
Идентификатор организации, связанной с сделкой. |
|
Состояние
|
status | string |
Открыть, выиграть, потерять или удалить. |
|
Название сделки
|
title | string |
Название сделки. |
|
Значение сделки
|
value | number |
Денежное значение сделки. |
|
Валюта
|
currency | string |
Валюта, связанная со значением сделки. |
|
Создан Date-Time
|
add_time | date-time |
гггг-ММ-ддTHH:мм:ss.fffZ |
|
Обновленные Date-Time
|
update_time | date-time |
гггг-ММ-ддTHH:мм:ss.fffZ |
|
Идентификатор этапа
|
stage_id | integer |
Идентификатор стадии сделки помещается в конвейер. |
|
Имя этапа
|
stage_name | string |
Имя этапа сделки помещается в конвейер |
|
Этап Uodated Date-Time
|
stage_change_time | date-time |
гггг-ММ-ддTHH:мм:ss.fffZ |
|
Активен
|
active | boolean |
Значение true, если сделка активна. |
|
Удаляется
|
deleted | boolean |
Значение true, если сделка была удалена. |
|
Дата следующего действия
|
next_activity_date | string |
yyyy-MM-dd |
|
Следующее время действия
|
next_activity_time | string |
гггг-ММ-ддTHH:мм:ss.fffZ |
|
Следующий идентификатор действия
|
next_activity_id | integer |
Идентификатор следующего действия. |
|
Идентификатор последнего действия
|
last_activity_id | integer |
Идентификатор последнего действия. |
|
Last Activity Date (Дата последнего действия);
|
last_activity_date | string |
yyyy-MM-dd |
|
Потерянная причина
|
lost_reason | string |
Сообщение о том, почему сделка была потеряна (используется, когда состояние=потеряно). |
|
Visiblity
|
visible_to | string |
Владелец, последователи или вся компания. |
|
Закрытый Date-Time
|
close_time | date-time |
гггг-ММ-ддTHH:мм:ss.fffZ |
|
Идентификатор конвейера
|
pipeline_id | integer |
Идентификатор конвейера, с которым связана сделка. |
|
Количество продуктов
|
products_count | integer |
Количество продуктов, связанных с сделкой. |
|
Число файлов
|
files_count | integer |
Количество файлов, связанных с сделкой. |
|
Количество заметок
|
notes_count | integer |
Количество заметок, связанных с сделкой. |
|
Число подписчиков
|
followers_count | integer |
Число последователей, связанных с сделкой. |
|
Число сообщений электронной почты
|
email_messages_count | integer |
Количество сообщений электронной почты, связанных с сделкой. |
|
Количество действий
|
activities_count | integer |
Количество действий, связанных с сделкой. |
|
Количество выполненных действий
|
done_activities_count | integer |
Количество выполненных действий, связанных с сделкой. |
|
Число неуклонных действий
|
undone_activities_count | integer |
Число неучтяемых активов, связанных с сделками. |
|
Количество действий, на которые ссылается ссылка
|
reference_activities_count | integer |
Количество ссылочных действий, связанных с сделкой. |
|
Количество участников
|
participants_count | integer |
Число участников, связанных с сделкой. |
|
Ожидаемая дата закрытия
|
expected_close_date | string |
yyyy-MM-dd |
|
Следующая тема действия
|
next_activity_subject | string |
Тема следующего действия, связанного с сделкой. |
|
Следующий тип действия
|
next_activity_type | string |
Тип следующего действия, связанного с сделкой. |
|
Следующая длительность действия
|
next_activity_duration | string |
Длительность следующего действия, связанного с сделкой. |
|
Следующее примечание о действиях
|
next_activity_note | string |
Заметки о следующем действии, связанном с сделкой |
DealResponseV2
данные
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Идентификатор сделки
|
id | integer |
Идентификатор сделки. |
|
Идентификатор
|
creator_user_id.id | integer |
Идентификатор создателя сделки. |
|
Имя
|
creator_user_id.name | string |
Имя создателя сделки. |
|
Адрес электронной почты
|
creator_user_id.email | string |
Электронная почта создателя сделки. |
|
Идентификатор
|
user_id.id | integer |
Идентификатор владельца сделки. |
|
Имя
|
user_id.name | string |
Имя владельца сделки. |
|
Адрес электронной почты
|
user_id.email | string |
Электронная почта владельца сделки. |
|
Имя
|
person_id.name | string |
Имя лица, связанного с сделкой. |
|
Идентификатор
|
person_id.value | integer |
Идентификатор лица, связанного с сделкой. |
|
Имя
|
org_id.name | string |
Имя организации, связанной с сделкой. |
|
Идентификатор
|
org_id.value | integer |
Идентификатор организации, связанной с сделкой. |
|
Состояние
|
status | string |
Открыть, выиграть, потерять или удалить. |
|
Название сделки
|
title | string |
Название сделки. |
|
Значение сделки
|
value | number |
Денежное значение сделки. |
|
Валюта
|
currency | string |
Валюта, связанная со значением сделки. |
|
Создан Date-Time
|
add_time | date-time |
гггг-ММ-ддTHH:мм:ss.fffZ |
|
Обновленные Date-Time
|
update_time | date-time |
гггг-ММ-ддTHH:мм:ss.fffZ |
|
Идентификатор этапа
|
stage_id | integer |
Идентификатор стадии сделки помещается в конвейер. |
|
Этап Uodated Date-Time
|
stage_change_time | date-time |
гггг-ММ-ддTHH:мм:ss.fffZ |
|
Активен
|
active | boolean |
Значение true, если сделка активна. |
|
Удаляется
|
deleted | boolean |
Значение true, если сделка была удалена. |
|
Дата следующего действия
|
next_activity_date | string |
yyyy-MM-dd |
|
Следующее время действия
|
next_activity_time | string |
гггг-ММ-ддTHH:мм:ss.fffZ |
|
Следующий идентификатор действия
|
next_activity_id | integer |
Идентификатор следующего действия. |
|
Идентификатор последнего действия
|
last_activity_id | integer |
Идентификатор последнего действия. |
|
Last Activity Date (Дата последнего действия);
|
last_activity_date | string |
yyyy-MM-dd |
|
Потерянная причина
|
lost_reason | string |
Сообщение о том, почему сделка была потеряна (используется, когда состояние=потеряно). |
|
Visiblity
|
visible_to | string |
Владелец, последователи или вся компания. |
|
Закрытый Date-Time
|
close_time | date-time |
гггг-ММ-ддTHH:мм:ss.fffZ |
|
Идентификатор конвейера
|
pipeline_id | integer |
Идентификатор конвейера, с которым связана сделка. |
|
Количество продуктов
|
products_count | integer |
Количество продуктов, связанных с сделкой. |
|
Число файлов
|
files_count | integer |
Количество файлов, связанных с сделкой. |
|
Количество заметок
|
notes_count | integer |
Количество заметок, связанных с сделкой. |
|
Число подписчиков
|
followers_count | integer |
Число последователей, связанных с сделкой. |
|
Число сообщений электронной почты
|
email_messages_count | integer |
Количество сообщений электронной почты, связанных с сделкой. |
|
Количество действий
|
activities_count | integer |
Количество действий, связанных с сделкой. |
|
Количество выполненных действий
|
done_activities_count | integer |
Количество выполненных действий, связанных с сделкой. |
|
Число неуклонных действий
|
undone_activities_count | integer |
Число неучтяемых активов, связанных с сделками. |
|
Количество действий, на которые ссылается ссылка
|
reference_activities_count | integer |
Количество ссылочных действий, связанных с сделкой. |
|
Количество участников
|
participants_count | integer |
Число участников, связанных с сделкой. |
|
Ожидаемая дата закрытия
|
expected_close_date | string |
yyyy-MM-dd |
|
Следующая тема действия
|
next_activity_subject | string |
Тема следующего действия, связанного с сделкой. |
|
Следующий тип действия
|
next_activity_type | string |
Тип следующего действия, связанного с сделкой. |
|
Следующая длительность действия
|
next_activity_duration | string |
Длительность следующего действия, связанного с сделкой. |
|
Следующее примечание о действиях
|
next_activity_note | string |
Заметки о следующем действии, связанном с сделкой |