Pipedrive
Pipedrive es una herramienta de administración de canalizaciones y CRM que le ayuda a centrarse en las acciones que importan.
Este conector está disponible en los siguientes productos y regiones:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Aplicaciones lógicas | Estándar | Todas las regiones de Logic Apps excepto las siguientes: - Regiones de Azure Government - Regiones de Azure China - Departamento de Defensa de EE. UU. (DoD) |
| Power Apps | Premium | Todas las regiones de Power Apps excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Power Automate | Premium | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Contacto | |
|---|---|
| Nombre | Microsoft |
| URL |
Compatibilidad con Microsoft LogicApps Soporte técnico de Microsoft Power Automate Soporte técnico de Microsoft Power Apps |
| Metadatos del conector | |
|---|---|
| Publicador | Microsoft |
| Website | https://www.pipedrive.com/ |
| Directiva de privacidad | https://www.pipedrive.com/privacy |
Creación de una conexión
El conector admite los siguientes tipos de autenticación:
| Predeterminado | Parámetros para crear una conexión. | Todas las regiones | No se puede compartir |
Predeterminado
Aplicable: Todas las regiones
Parámetros para crear una conexión.
Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.
| Nombre | Tipo | Description | Obligatorio |
|---|---|---|---|
| Clave de API | securestring | Clave de API | Cierto |
Limitaciones
| Nombre | Llamadas | Período de renovación |
|---|---|---|
| Llamadas API por conexión | 100 | 60 segundos |
| Frecuencia de sondeos de desencadenador | 1 | 120 segundos |
Acciones
| Agregar actividad |
Esta operación se usa para crear una nueva actividad para la cuenta autorizada. |
| Agregar oferta (V2) (versión preliminar) |
Esta operación crea una nueva oferta para la cuenta autorizada. |
| Agregar oferta [EN DESUSO] |
Esta acción ha quedado en desuso. Use Agregar oferta (V2) en su lugar.
|
| Estado de la oferta de actualización |
Esta operación se usa para actualizar el estado asociado a una oferta, dado su identificador. |
| Fase de la oferta de actualización (V2) (versión preliminar) |
Esta operación se usa para actualizar la fase asociada a una oferta, dado su identificador. |
| Fase de la oferta de actualización [EN DESUSO] |
Esta acción ha quedado en desuso. Use la fase de oferta de actualización (V2) en su lugar.
|
| Obtención de la fase por identificador |
Esta operación devuelve datos sobre una fase específica. |
| Obtención de la oferta por identificador |
Esta operación recupera todos los detalles de una oferta existente, dado su identificador. |
Agregar actividad
Esta operación se usa para crear una nueva actividad para la cuenta autorizada.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Tipo
|
type | True | string |
Tipo de actividad. |
|
Asunto
|
subject | True | string |
Asunto de la actividad. |
|
Fecha límite
|
due_date | string |
AAAA-MM-DD |
|
|
Tiempo de vencimiento
|
due_time | string |
HH:MM |
|
|
Duración
|
duration | string |
HH:MM |
|
|
Notas
|
note | string | ||
|
Asignado a
|
user_id | integer |
Identificador del usuario al que se asignará la actividad. |
|
|
Identificador de oferta
|
deal_id | integer |
Identificador de la oferta a la que se asociará la actividad. |
|
|
ID de contacto
|
person_id | integer |
Id. de persona a la que se asociará la actividad. |
|
|
Identificador de organización
|
org_id | integer |
Id. de la organización a la que se asociará la actividad. |
Devoluciones
datos
- Body
- ActivityResponse
Agregar oferta (V2) (versión preliminar)
Esta operación crea una nueva oferta para la cuenta autorizada.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Title
|
title | True | string |
Título del trato. |
|
Id. de canalización
|
pipeline_id | string |
Identificador de la canalización de la que se van a capturar fases. |
|
|
Id. de fase
|
stage_id | string |
Fase del trato. |
|
|
Estado
|
status | string |
Estado de la oferta. |
|
|
Importancia
|
value | integer |
Valor monetario de la oferta. |
|
|
Moneda
|
currency | string |
Moneda del trato. |
|
|
ID de contacto
|
person_id | string |
Identificador de usuario de la persona a la que está asociada la oferta. |
|
|
Identificador de organización
|
org_id | string |
Identificador de la organización asociada a la oferta. |
|
|
Fecha de cierre esperada
|
expected_close_date | string |
yyyy-MM-dd |
|
|
Visiblidad
|
visible_to | string |
Propietario, seguidores o toda la empresa. |
Devoluciones
datos
- Body
- DealResponseV2
Agregar oferta [EN DESUSO]
Esta acción ha quedado en desuso. Use Agregar oferta (V2) en su lugar.
Esta operación crea una nueva oferta para la cuenta autorizada.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Title
|
title | True | string |
Título del trato. |
|
Id. de fase
|
stage_id | string |
Fase del trato. |
|
|
Estado
|
status | string |
Estado de la oferta. |
|
|
Importancia
|
value | integer |
Valor monetario de la oferta. |
|
|
Moneda
|
currency | string |
Moneda del trato. |
|
|
ID de contacto
|
person_id | string |
Identificador de usuario de la persona a la que está asociada la oferta. |
|
|
Identificador de organización
|
org_id | string |
Identificador de la organización asociada a la oferta. |
|
|
Fecha de cierre esperada
|
expected_close_date | string |
yyyy-MM-dd |
|
|
Visiblidad
|
visible_to | string |
Propietario, seguidores o toda la empresa. |
Devoluciones
datos
- Body
- DealResponse
Estado de la oferta de actualización
Esta operación se usa para actualizar el estado asociado a una oferta, dado su identificador.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de oferta
|
dealId | True | integer |
Trato |
|
Estado
|
status | True | string |
Estado de la oferta. |
|
Motivo perdido
|
lost_reason | string |
Mensaje sobre por qué se perdió el trato. |
Devoluciones
datos
- Body
- DealResponse
Fase de la oferta de actualización (V2) (versión preliminar)
Esta operación se usa para actualizar la fase asociada a una oferta, dado su identificador.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de oferta
|
dealId | True | integer |
Trato |
|
Id. de canalización
|
pipeline_id | True | string |
Identificador de la canalización de la que se van a capturar fases. |
|
Id. de fase
|
stage_id | True | string |
Fase del trato. |
|
Fecha de cierre esperada
|
expected_close_date | string |
yyyy-MM-dd |
Devoluciones
datos
- Body
- DealResponseV2
Fase de la oferta de actualización [EN DESUSO]
Esta acción ha quedado en desuso. Use la fase de oferta de actualización (V2) en su lugar.
Esta operación se usa para actualizar la fase asociada a una oferta, dado su identificador.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de oferta
|
dealId | True | integer |
Trato |
|
Id. de fase
|
stage_id | True | string |
Fase del trato. |
|
Fecha de cierre esperada
|
expected_close_date | string |
yyyy-MM-dd |
Devoluciones
datos
- Body
- DealResponse
Obtención de la fase por identificador
Esta operación devuelve datos sobre una fase específica.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de fase
|
stageId | True | integer |
Id. de fase |
Devoluciones
- Body
- StageResponse
Obtención de la oferta por identificador
Esta operación recupera todos los detalles de una oferta existente, dado su identificador.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de oferta
|
dealId | True | integer |
Trato |
Devoluciones
datos
- Body
- DealResponse
Desencadenadores
| Cuando se agrega una nueva actividad |
Se desencadena cuando se agrega una nueva actividad a la cuenta autorizada. |
| Cuando se agrega una nueva oferta (V2) (versión preliminar) |
Se desencadena cuando se agrega una nueva oferta a la cuenta autorizada (V2). |
| Cuando se agrega una nueva oferta [EN DESUSO] |
Esta acción ha quedado en desuso. Use cuando se agregue una nueva oferta (V2) en su lugar.
|
Cuando se agrega una nueva actividad
Se desencadena cuando se agrega una nueva actividad a la cuenta autorizada.
Devoluciones
datos
- Body
- ActivityResponse
Cuando se agrega una nueva oferta (V2) (versión preliminar)
Se desencadena cuando se agrega una nueva oferta a la cuenta autorizada (V2).
Devoluciones
datos
- Body
- DealResponseV2
Cuando se agrega una nueva oferta [EN DESUSO]
Esta acción ha quedado en desuso. Use cuando se agregue una nueva oferta (V2) en su lugar.
Se desencadena cuando se agrega una nueva oferta a la cuenta autorizada.
Devoluciones
datos
- Body
- DealResponse
Definiciones
StageResponse
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Id. de fase
|
id | integer |
Id. de fase |
|
Nombre de la fase
|
name | string |
Nombre de la fase |
ActivityResponse
datos
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Id. de actividad
|
id | integer |
Identificador único de la actividad. |
|
ID de usuario
|
user_id | integer |
Identificador del usuario al que está asignada la actividad. |
|
Se realiza
|
done | boolean |
0 = No hecho, 1 = Listo |
|
Tipo
|
type | string |
Tipo de la actividad. |
|
Fecha límite
|
due_date | string |
AAAA-MM-DD |
|
Tiempo de vencimiento
|
due_time | string |
HH:MM |
|
Duración
|
duration | string |
HH:MM |
|
Asunto
|
subject | string |
Asunto de la actividad. |
|
Identificador de oferta
|
deal_id | integer |
Identificador de la oferta a la que está asociada la actividad. |
|
Título de la oferta
|
deal_title | string |
Título de la oferta a la que está asociada la actividad. |
|
Identificador de organización
|
org_id | integer |
Identificador de la organización a la que está asociada la actividad. |
|
Nombre de la organización
|
org_name | string |
Nombre de la organización a la que está asociada la actividad. |
|
ID de contacto
|
person_id | integer |
Id. de persona a la que está asociada la actividad. |
|
Nombre de contacto
|
person_name | string |
Nombre de persona a la que está asociada la actividad. |
|
Date-Time creados
|
add_time | date-time |
aaaa-MM-ddTHH:mm:ss.fffZ |
|
Actualizaciones Date-Time
|
update_time | date-time |
aaaa-MM-ddTHH:mm:ss.fffZ |
|
Completado Date-Time
|
marked_as_done_time | date-time |
aaaa-MM-ddTHH:mm:ss.fffZ |
|
Identificador de evento de Google Calendar
|
gcal_event_id | string |
Identificador del evento de calendario de Google. |
|
Id. de calendario de Google
|
google_calendar_id | string |
Id. del calendario de Google. |
|
Nota:
|
note | string |
Nota de la actividad (formato HTML). |
|
Asignado a
|
assigned_to_user_id | integer |
Identificador de usuario del usuario al que se asigna la actividad. |
|
Creado por
|
created_by_user_id | integer |
Identificador de usuario del usuario que creó la actividad. |
|
Nombre del propietario
|
owner_name | string |
Nombre del propietario de la actividad. |
DealResponse
datos
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Identificador de oferta
|
id | integer |
Id. del trato. |
|
Id
|
creator_user_id.id | integer |
Id. del creador de la oferta. |
|
Nombre
|
creator_user_id.name | string |
Nombre del creador del contrato. |
|
Correo Electrónico
|
creator_user_id.email | string |
Correo electrónico del creador de la oferta. |
|
Id
|
user_id.id | integer |
Id. del propietario del contrato. |
|
Nombre
|
user_id.name | string |
Nombre del propietario de la oferta. |
|
Correo Electrónico
|
user_id.email | string |
Correo electrónico del propietario del contrato. |
|
Nombre
|
person_id.name | string |
Nombre de la persona asociada al contrato. |
|
Id
|
person_id.value | integer |
Id. de la persona asociada al contrato. |
|
Nombre
|
org_id.name | string |
Nombre de la organización asociada a la oferta. |
|
Id
|
org_id.value | integer |
Identificador de la organización asociada a la oferta. |
|
Estado
|
status | string |
Abrir, ganar, perder o eliminar. |
|
Título de la oferta
|
title | string |
Título del trato. |
|
Valor de oferta
|
value | number |
Valor monetario de la oferta. |
|
Moneda
|
currency | string |
Moneda asociada al valor de la oferta. |
|
Date-Time creados
|
add_time | date-time |
aaaa-MM-ddTHH:mm:ss.fffZ |
|
Date-Time actualizado
|
update_time | date-time |
aaaa-MM-ddTHH:mm:ss.fffZ |
|
Id. de fase
|
stage_id | integer |
Identificador de la fase en la que se coloca la oferta en una canalización. |
|
Nombre de la fase
|
stage_name | string |
Nombre de la fase en la que se coloca la oferta en una canalización |
|
Date-Time de fase uodated
|
stage_change_time | date-time |
aaaa-MM-ddTHH:mm:ss.fffZ |
|
Está activo
|
active | boolean |
True si la oferta está activa. |
|
Está eliminado
|
deleted | boolean |
True si se ha eliminado la oferta. |
|
Fecha de actividad siguiente
|
next_activity_date | string |
yyyy-MM-dd |
|
Hora de la actividad siguiente
|
next_activity_time | string |
aaaa-MM-ddTHH:mm:ss.fffZ |
|
Identificador de actividad siguiente
|
next_activity_id | integer |
Identificador de la siguiente actividad. |
|
Identificador de última actividad
|
last_activity_id | integer |
Identificador de la última actividad. |
|
Fecha de la última actividad
|
last_activity_date | string |
yyyy-MM-dd |
|
Motivo perdido
|
lost_reason | string |
Mensaje sobre por qué se perdió la oferta (que se usará cuando status=lost). |
|
Visiblidad
|
visible_to | string |
Propietario, seguidores o toda la empresa. |
|
Date-Time cerradas
|
close_time | date-time |
aaaa-MM-ddTHH:mm:ss.fffZ |
|
Id. de canalización
|
pipeline_id | integer |
Identificador de canalización al que está asociada la oferta. |
|
Recuento de productos
|
products_count | integer |
Número de productos asociados a la oferta. |
|
Recuento de archivos
|
files_count | integer |
Número de archivos asociados con la oferta. |
|
Recuento de notas
|
notes_count | integer |
Número de notas asociadas a la oferta. |
|
Recuento de seguidores
|
followers_count | integer |
Número de seguidores asociados al trato. |
|
Recuento de mensajes de correo electrónico
|
email_messages_count | integer |
Número de mensajes de correo electrónico asociados a la oferta. |
|
Recuento de actividades
|
activities_count | integer |
Número de actividades asociadas al contrato. |
|
Recuento de actividades realizadas
|
done_activities_count | integer |
Número de actividades realizadas asociadas a la oferta. |
|
Recuento de actividades de deshacer
|
undone_activities_count | integer |
Número de activitios de deshacer asociados a las ofertas. |
|
Recuento de actividades a las que se hace referencia
|
reference_activities_count | integer |
Número de actividades a las que se hace referencia asociada con la oferta. |
|
Recuento de participantes
|
participants_count | integer |
Número de participantes asociados a la oferta. |
|
Fecha de cierre esperada
|
expected_close_date | string |
yyyy-MM-dd |
|
Asunto de la actividad siguiente
|
next_activity_subject | string |
Asunto de la siguiente actividad asociada a la oferta. |
|
Tipo de actividad siguiente
|
next_activity_type | string |
Tipo de actividad siguiente asociada a la oferta. |
|
Siguiente duración de la actividad
|
next_activity_duration | string |
Duración de la siguiente actividad asociada a la oferta. |
|
Nota de actividad siguiente
|
next_activity_note | string |
Notas de la siguiente actividad asociada a la oferta |
DealResponseV2
datos
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Identificador de oferta
|
id | integer |
Id. del trato. |
|
Id
|
creator_user_id.id | integer |
Id. del creador de la oferta. |
|
Nombre
|
creator_user_id.name | string |
Nombre del creador del contrato. |
|
Correo Electrónico
|
creator_user_id.email | string |
Correo electrónico del creador de la oferta. |
|
Id
|
user_id.id | integer |
Id. del propietario del contrato. |
|
Nombre
|
user_id.name | string |
Nombre del propietario de la oferta. |
|
Correo Electrónico
|
user_id.email | string |
Correo electrónico del propietario del contrato. |
|
Nombre
|
person_id.name | string |
Nombre de la persona asociada al contrato. |
|
Id
|
person_id.value | integer |
Id. de la persona asociada al contrato. |
|
Nombre
|
org_id.name | string |
Nombre de la organización asociada a la oferta. |
|
Id
|
org_id.value | integer |
Identificador de la organización asociada a la oferta. |
|
Estado
|
status | string |
Abrir, ganar, perder o eliminar. |
|
Título de la oferta
|
title | string |
Título del trato. |
|
Valor de oferta
|
value | number |
Valor monetario de la oferta. |
|
Moneda
|
currency | string |
Moneda asociada al valor de la oferta. |
|
Date-Time creados
|
add_time | date-time |
aaaa-MM-ddTHH:mm:ss.fffZ |
|
Date-Time actualizado
|
update_time | date-time |
aaaa-MM-ddTHH:mm:ss.fffZ |
|
Id. de fase
|
stage_id | integer |
Identificador de la fase en la que se coloca la oferta en una canalización. |
|
Date-Time de fase uodated
|
stage_change_time | date-time |
aaaa-MM-ddTHH:mm:ss.fffZ |
|
Está activo
|
active | boolean |
True si la oferta está activa. |
|
Está eliminado
|
deleted | boolean |
True si se ha eliminado la oferta. |
|
Fecha de actividad siguiente
|
next_activity_date | string |
yyyy-MM-dd |
|
Hora de la actividad siguiente
|
next_activity_time | string |
aaaa-MM-ddTHH:mm:ss.fffZ |
|
Identificador de actividad siguiente
|
next_activity_id | integer |
Identificador de la siguiente actividad. |
|
Identificador de última actividad
|
last_activity_id | integer |
Identificador de la última actividad. |
|
Fecha de la última actividad
|
last_activity_date | string |
yyyy-MM-dd |
|
Motivo perdido
|
lost_reason | string |
Mensaje sobre por qué se perdió la oferta (que se usará cuando status=lost). |
|
Visiblidad
|
visible_to | string |
Propietario, seguidores o toda la empresa. |
|
Date-Time cerradas
|
close_time | date-time |
aaaa-MM-ddTHH:mm:ss.fffZ |
|
Id. de canalización
|
pipeline_id | integer |
Identificador de canalización al que está asociada la oferta. |
|
Recuento de productos
|
products_count | integer |
Número de productos asociados a la oferta. |
|
Recuento de archivos
|
files_count | integer |
Número de archivos asociados con la oferta. |
|
Recuento de notas
|
notes_count | integer |
Número de notas asociadas a la oferta. |
|
Recuento de seguidores
|
followers_count | integer |
Número de seguidores asociados al trato. |
|
Recuento de mensajes de correo electrónico
|
email_messages_count | integer |
Número de mensajes de correo electrónico asociados a la oferta. |
|
Recuento de actividades
|
activities_count | integer |
Número de actividades asociadas al contrato. |
|
Recuento de actividades realizadas
|
done_activities_count | integer |
Número de actividades realizadas asociadas a la oferta. |
|
Recuento de actividades de deshacer
|
undone_activities_count | integer |
Número de activitios de deshacer asociados a las ofertas. |
|
Recuento de actividades a las que se hace referencia
|
reference_activities_count | integer |
Número de actividades a las que se hace referencia asociada con la oferta. |
|
Recuento de participantes
|
participants_count | integer |
Número de participantes asociados a la oferta. |
|
Fecha de cierre esperada
|
expected_close_date | string |
yyyy-MM-dd |
|
Asunto de la actividad siguiente
|
next_activity_subject | string |
Asunto de la siguiente actividad asociada a la oferta. |
|
Tipo de actividad siguiente
|
next_activity_type | string |
Tipo de actividad siguiente asociada a la oferta. |
|
Siguiente duración de la actividad
|
next_activity_duration | string |
Duración de la siguiente actividad asociada a la oferta. |
|
Nota de actividad siguiente
|
next_activity_note | string |
Notas de la siguiente actividad asociada a la oferta |