Pipedrive
O Pipedrive é uma ferramenta de gerenciamento de pipeline e CRM que ajuda você a se concentrar em ações importantes.
Esse conector está disponível nos seguintes produtos e regiões:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicativos Lógicos | Standard | Todas as regiões dos Aplicativos Lógicos , exceto as seguintes: – Regiões do Azure Governamental - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Power Apps | Premium | Todas as regiões do Power Apps , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Power Automate | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Contato | |
|---|---|
| Nome | Microsoft |
| URL |
Suporte do Microsoft LogicApps Suporte do Microsoft Power Automate Suporte do Microsoft Power Apps |
| Metadados do conector | |
|---|---|
| Publicador | Microsoft |
| Site | https://www.pipedrive.com/ |
| Política de privacidade | https://www.pipedrive.com/privacy |
Criando uma conexão
O conector dá suporte aos seguintes tipos de autenticação:
| Default | Parâmetros para criar conexão. | Todas as regiões | Não compartilhável |
Padrão
Aplicável: todas as regiões
Parâmetros para criar conexão.
Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.
| Nome | Tipo | Description | Obrigatório |
|---|---|---|---|
| Chave de API | secureString | Chave de API | Verdade |
Limitações
| Nome | Chamadas | Período de renovação |
|---|---|---|
| Chamadas à API por conexão | 100 | 60 segundos |
| Frequência das pesquisas de gatilho | 1 | 120 segundos |
Ações
| Adicionar acordo (V2) (versão prévia) |
Essa operação cria um novo acordo para a conta autorizada. |
| Adicionar acordo [PRETERIDO] |
Esta ação foi preterida. Em vez disso, use Adicionar oferta (V2 ).
|
| Adicionar atividade |
Essa operação é usada para criar uma nova atividade para a conta autorizada. |
| Atualizar o status da negociação |
Essa operação é usada para atualizar o status associado a um negócio, considerando sua ID. |
| Estágio de negociação de atualização (V2) (versão prévia) |
Essa operação é usada para atualizar o estágio associado a um acordo, considerando sua ID. |
| Estágio de negociação de atualização [PRETERIDO] |
Esta ação foi preterida. Em vez disso, use o estágio de negociação de atualização (V2 ).
|
| Obter acordo por ID |
Esta operação recupera todos os detalhes de um negócio existente, considerando sua ID. |
| Obter estágio por ID |
Essa operação retorna dados sobre um estágio específico. |
Adicionar acordo (V2) (versão prévia)
Essa operação cria um novo acordo para a conta autorizada.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Title
|
title | True | string |
Título do acordo. |
|
Pipeline Id
|
pipeline_id | string |
A ID do pipeline da qual buscar estágios. |
|
|
ID do estágio
|
stage_id | string |
Estágio do acordo. |
|
|
Situação
|
status | string |
Status do negócio. |
|
|
Value
|
value | integer |
Valor monetário do negócio. |
|
|
Moeda
|
currency | string |
Moeda do negócio. |
|
|
ID de contato
|
person_id | string |
ID de usuário da pessoa à qual o negócio está associado. |
|
|
Id da Organização
|
org_id | string |
ID da organização associada ao acordo. |
|
|
Data de fechamento esperada
|
expected_close_date | string |
yyyy-MM-dd |
|
|
Visivelmente
|
visible_to | string |
Proprietário, seguidores ou empresa inteira. |
Retornos
dados
- Corpo
- DealResponseV2
Adicionar acordo [PRETERIDO]
Esta ação foi preterida. Em vez disso, use Adicionar oferta (V2 ).
Essa operação cria um novo acordo para a conta autorizada.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Title
|
title | True | string |
Título do acordo. |
|
ID do estágio
|
stage_id | string |
Estágio do acordo. |
|
|
Situação
|
status | string |
Status do negócio. |
|
|
Value
|
value | integer |
Valor monetário do negócio. |
|
|
Moeda
|
currency | string |
Moeda do negócio. |
|
|
ID de contato
|
person_id | string |
ID de usuário da pessoa à qual o negócio está associado. |
|
|
Id da Organização
|
org_id | string |
ID da organização associada ao acordo. |
|
|
Data de fechamento esperada
|
expected_close_date | string |
yyyy-MM-dd |
|
|
Visivelmente
|
visible_to | string |
Proprietário, seguidores ou empresa inteira. |
Retornos
dados
- Corpo
- DealResponse
Adicionar atividade
Essa operação é usada para criar uma nova atividade para a conta autorizada.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Tipo
|
type | True | string |
Tipo de atividade. |
|
Assunto
|
subject | True | string |
Assunto da atividade. |
|
Data de vencimento
|
due_date | string |
AAAA-MM-DD |
|
|
Tempo de Conclusão
|
due_time | string |
HH:MM |
|
|
Duração
|
duration | string |
HH:MM |
|
|
Anotações
|
note | string | ||
|
Atribuído a
|
user_id | integer |
Id do usuário ao qual a atividade será atribuída. |
|
|
ID do negócio
|
deal_id | integer |
ID da negociação à qual a atividade será associada. |
|
|
ID de contato
|
person_id | integer |
Id da pessoa à qual a atividade será associada. |
|
|
Id da Organização
|
org_id | integer |
ID da organização à qual a atividade será associada. |
Retornos
dados
- Corpo
- ActivityResponse
Atualizar o status da negociação
Essa operação é usada para atualizar o status associado a um negócio, considerando sua ID.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do negócio
|
dealId | True | integer |
Negócio |
|
Situação
|
status | True | string |
Status do negócio. |
|
Motivo perdido
|
lost_reason | string |
Mensagem sobre por que o acordo foi perdido. |
Retornos
dados
- Corpo
- DealResponse
Estágio de negociação de atualização (V2) (versão prévia)
Essa operação é usada para atualizar o estágio associado a um acordo, considerando sua ID.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do negócio
|
dealId | True | integer |
Negócio |
|
Pipeline Id
|
pipeline_id | True | string |
A ID do pipeline da qual buscar estágios. |
|
ID do estágio
|
stage_id | True | string |
Estágio do acordo. |
|
Data de fechamento esperada
|
expected_close_date | string |
yyyy-MM-dd |
Retornos
dados
- Corpo
- DealResponseV2
Estágio de negociação de atualização [PRETERIDO]
Esta ação foi preterida. Em vez disso, use o estágio de negociação de atualização (V2 ).
Essa operação é usada para atualizar o estágio associado a um acordo, considerando sua ID.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do negócio
|
dealId | True | integer |
Negócio |
|
ID do estágio
|
stage_id | True | string |
Estágio do acordo. |
|
Data de fechamento esperada
|
expected_close_date | string |
yyyy-MM-dd |
Retornos
dados
- Corpo
- DealResponse
Obter acordo por ID
Esta operação recupera todos os detalhes de um negócio existente, considerando sua ID.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do negócio
|
dealId | True | integer |
Negócio |
Retornos
dados
- Corpo
- DealResponse
Obter estágio por ID
Essa operação retorna dados sobre um estágio específico.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do estágio
|
stageId | True | integer |
ID do estágio |
Retornos
- Corpo
- StageResponse
Gatilhos
| Quando um novo acordo é adicionado (V2) (versão prévia) |
Dispara quando um novo acordo é adicionado à conta autorizada (V2). |
| Quando um novo acordo é adicionado [PRETERIDO] |
Esta ação foi preterida. Use quando um novo acordo for adicionado (V2).
|
| Quando uma nova atividade é adicionada |
Dispara quando uma nova atividade é adicionada à conta autorizada. |
Quando um novo acordo é adicionado (V2) (versão prévia)
Dispara quando um novo acordo é adicionado à conta autorizada (V2).
Retornos
dados
- Corpo
- DealResponseV2
Quando um novo acordo é adicionado [PRETERIDO]
Esta ação foi preterida. Use quando um novo acordo for adicionado (V2).
Dispara quando um novo acordo é adicionado à conta autorizada.
Retornos
dados
- Corpo
- DealResponse
Quando uma nova atividade é adicionada
Dispara quando uma nova atividade é adicionada à conta autorizada.
Retornos
dados
- Corpo
- ActivityResponse
Definições
StageResponse
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID do estágio
|
id | integer |
ID do estágio |
|
Nome do estágio
|
name | string |
Nome do estágio |
ActivityResponse
dados
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID da atividade
|
id | integer |
ID exclusiva da atividade. |
|
Id do usuário
|
user_id | integer |
ID do usuário ao qual a atividade é atribuída. |
|
Está concluído
|
done | boolean |
0 = Não concluído, 1 = Concluído |
|
Tipo
|
type | string |
Tipo da atividade. |
|
Data de vencimento
|
due_date | string |
AAAA-MM-DD |
|
Tempo de Conclusão
|
due_time | string |
HH:MM |
|
Duração
|
duration | string |
HH:MM |
|
Assunto
|
subject | string |
Assunto da atividade. |
|
ID do negócio
|
deal_id | integer |
Id do negócio ao qual a atividade está associada. |
|
Título da Negociação
|
deal_title | string |
Título da negociação à qual a atividade está associada. |
|
Id da Organização
|
org_id | integer |
Id da organização à qual a atividade está associada. |
|
Nome da Organização
|
org_name | string |
Nome da organização à qual a atividade está associada. |
|
ID de contato
|
person_id | integer |
Id da pessoa à qual a atividade está associada. |
|
Nome do contato
|
person_name | string |
Nome da pessoa à qual a atividade está associada. |
|
Criado Date-Time
|
add_time | date-time |
yyyyy-MM-ddTHH:mm:ss.fffZ |
|
Atualizações Date-Time
|
update_time | date-time |
yyyyy-MM-ddTHH:mm:ss.fffZ |
|
Concluído Date-Time
|
marked_as_done_time | date-time |
yyyyy-MM-ddTHH:mm:ss.fffZ |
|
ID de evento do Google Calendar
|
gcal_event_id | string |
ID do evento google calendar. |
|
ID do Calendário do Google
|
google_calendar_id | string |
Id do calendário do Google. |
|
Observação
|
note | string |
Observação da atividade (formato HTML). |
|
Atribuído a
|
assigned_to_user_id | integer |
ID de usuário ao qual a atividade é atribuída. |
|
Criado por
|
created_by_user_id | integer |
ID do usuário que criou a atividade. |
|
Nome do Proprietário
|
owner_name | string |
Nome do proprietário da atividade. |
DealResponse
dados
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID do negócio
|
id | integer |
Id do acordo. |
|
ID
|
creator_user_id.id | integer |
Id do criador do negócio. |
|
Nome
|
creator_user_id.name | string |
Nome do criador do negócio. |
|
Email
|
creator_user_id.email | string |
Email do criador do negócio. |
|
ID
|
user_id.id | integer |
Id do dono do negócio. |
|
Nome
|
user_id.name | string |
Nome do proprietário do negócio. |
|
Email
|
user_id.email | string |
Email do proprietário do negócio. |
|
Nome
|
person_id.name | string |
Nome da pessoa associada ao negócio. |
|
ID
|
person_id.value | integer |
ID da pessoa associada ao negócio. |
|
Nome
|
org_id.name | string |
Nome da organização associada ao acordo. |
|
ID
|
org_id.value | integer |
ID da organização associada ao acordo. |
|
Situação
|
status | string |
Abrir, ganhar, perder ou excluir. |
|
Título da Negociação
|
title | string |
Título do acordo. |
|
Valor do negócio
|
value | number |
Valor monetário do negócio. |
|
Moeda
|
currency | string |
Moeda associada ao valor da negociação. |
|
Criado Date-Time
|
add_time | date-time |
yyyyy-MM-ddTHH:mm:ss.fffZ |
|
Atualização Date-Time
|
update_time | date-time |
yyyyy-MM-ddTHH:mm:ss.fffZ |
|
ID do estágio
|
stage_id | integer |
ID do estágio em que o negócio é colocado em um pipeline. |
|
Nome do estágio
|
stage_name | string |
Nome do estágio em que o negócio é colocado em um pipeline |
|
Estágio de Date-Time Uodated
|
stage_change_time | date-time |
yyyyy-MM-ddTHH:mm:ss.fffZ |
|
Está ativo
|
active | boolean |
True se o negócio estiver ativo. |
|
Está Excluído
|
deleted | boolean |
True se o acordo tiver sido excluído. |
|
Próxima Data da Atividade
|
next_activity_date | string |
yyyy-MM-dd |
|
Hora da Próxima Atividade
|
next_activity_time | string |
yyyyy-MM-ddTHH:mm:ss.fffZ |
|
ID da Próxima Atividade
|
next_activity_id | integer |
ID da próxima atividade. |
|
ID da última atividade
|
last_activity_id | integer |
ID da última atividade. |
|
Data da última atividade
|
last_activity_date | string |
yyyy-MM-dd |
|
Motivo perdido
|
lost_reason | string |
Mensagem sobre por que o negócio foi perdido (a ser usado quando status=perdido). |
|
Visivelmente
|
visible_to | string |
Proprietário, seguidores ou empresa inteira. |
|
Date-Time fechado
|
close_time | date-time |
yyyyy-MM-ddTHH:mm:ss.fffZ |
|
Pipeline Id
|
pipeline_id | integer |
Id do pipeline ao qual o negócio está associado. |
|
Contagem de produtos
|
products_count | integer |
Número de produtos associados ao negócio. |
|
Contagem de arquivos
|
files_count | integer |
Número de arquivos associados ao negócio. |
|
Contagem de anotações
|
notes_count | integer |
Número de anotações associadas ao negócio. |
|
Contagem de seguidores
|
followers_count | integer |
Número de seguidores associados ao acordo. |
|
Contagem de Mensagens de Email
|
email_messages_count | integer |
Número de mensagens de email associadas ao negócio. |
|
Contagem de atividades
|
activities_count | integer |
Número de atividades associadas ao negócio. |
|
Contagem de atividades concluídas
|
done_activities_count | integer |
Número de atividades realizadas associadas ao negócio. |
|
Contagem de atividades desfeitas
|
undone_activities_count | integer |
Número de ativações desfeitas associadas às ofertas. |
|
Contagem de atividades referenciadas
|
reference_activities_count | integer |
Número de atividades referenciadas associadas ao negócio. |
|
Contagem de participantes
|
participants_count | integer |
Número de participantes associados ao acordo. |
|
Data de fechamento esperada
|
expected_close_date | string |
yyyy-MM-dd |
|
Assunto da Próxima Atividade
|
next_activity_subject | string |
Assunto da próxima atividade associada ao negócio. |
|
Próximo Tipo de Atividade
|
next_activity_type | string |
Tipo de próxima atividade associada ao negócio. |
|
Duração da Próxima Atividade
|
next_activity_duration | string |
Duração da próxima atividade associada ao negócio. |
|
Observação da Próxima Atividade
|
next_activity_note | string |
Notas para a próxima atividade associada ao negócio |
DealResponseV2
dados
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID do negócio
|
id | integer |
Id do acordo. |
|
ID
|
creator_user_id.id | integer |
Id do criador do negócio. |
|
Nome
|
creator_user_id.name | string |
Nome do criador do negócio. |
|
Email
|
creator_user_id.email | string |
Email do criador do negócio. |
|
ID
|
user_id.id | integer |
Id do dono do negócio. |
|
Nome
|
user_id.name | string |
Nome do proprietário do negócio. |
|
Email
|
user_id.email | string |
Email do proprietário do negócio. |
|
Nome
|
person_id.name | string |
Nome da pessoa associada ao negócio. |
|
ID
|
person_id.value | integer |
ID da pessoa associada ao negócio. |
|
Nome
|
org_id.name | string |
Nome da organização associada ao acordo. |
|
ID
|
org_id.value | integer |
ID da organização associada ao acordo. |
|
Situação
|
status | string |
Abrir, ganhar, perder ou excluir. |
|
Título da Negociação
|
title | string |
Título do acordo. |
|
Valor do negócio
|
value | number |
Valor monetário do negócio. |
|
Moeda
|
currency | string |
Moeda associada ao valor da negociação. |
|
Criado Date-Time
|
add_time | date-time |
yyyyy-MM-ddTHH:mm:ss.fffZ |
|
Atualização Date-Time
|
update_time | date-time |
yyyyy-MM-ddTHH:mm:ss.fffZ |
|
ID do estágio
|
stage_id | integer |
ID do estágio em que o negócio é colocado em um pipeline. |
|
Estágio de Date-Time Uodated
|
stage_change_time | date-time |
yyyyy-MM-ddTHH:mm:ss.fffZ |
|
Está ativo
|
active | boolean |
True se o negócio estiver ativo. |
|
Está Excluído
|
deleted | boolean |
True se o acordo tiver sido excluído. |
|
Próxima Data da Atividade
|
next_activity_date | string |
yyyy-MM-dd |
|
Hora da Próxima Atividade
|
next_activity_time | string |
yyyyy-MM-ddTHH:mm:ss.fffZ |
|
ID da Próxima Atividade
|
next_activity_id | integer |
ID da próxima atividade. |
|
ID da última atividade
|
last_activity_id | integer |
ID da última atividade. |
|
Data da última atividade
|
last_activity_date | string |
yyyy-MM-dd |
|
Motivo perdido
|
lost_reason | string |
Mensagem sobre por que o negócio foi perdido (a ser usado quando status=perdido). |
|
Visivelmente
|
visible_to | string |
Proprietário, seguidores ou empresa inteira. |
|
Date-Time fechado
|
close_time | date-time |
yyyyy-MM-ddTHH:mm:ss.fffZ |
|
Pipeline Id
|
pipeline_id | integer |
Id do pipeline ao qual o negócio está associado. |
|
Contagem de produtos
|
products_count | integer |
Número de produtos associados ao negócio. |
|
Contagem de arquivos
|
files_count | integer |
Número de arquivos associados ao negócio. |
|
Contagem de anotações
|
notes_count | integer |
Número de anotações associadas ao negócio. |
|
Contagem de seguidores
|
followers_count | integer |
Número de seguidores associados ao acordo. |
|
Contagem de Mensagens de Email
|
email_messages_count | integer |
Número de mensagens de email associadas ao negócio. |
|
Contagem de atividades
|
activities_count | integer |
Número de atividades associadas ao negócio. |
|
Contagem de atividades concluídas
|
done_activities_count | integer |
Número de atividades realizadas associadas ao negócio. |
|
Contagem de atividades desfeitas
|
undone_activities_count | integer |
Número de ativações desfeitas associadas às ofertas. |
|
Contagem de atividades referenciadas
|
reference_activities_count | integer |
Número de atividades referenciadas associadas ao negócio. |
|
Contagem de participantes
|
participants_count | integer |
Número de participantes associados ao acordo. |
|
Data de fechamento esperada
|
expected_close_date | string |
yyyy-MM-dd |
|
Assunto da Próxima Atividade
|
next_activity_subject | string |
Assunto da próxima atividade associada ao negócio. |
|
Próximo Tipo de Atividade
|
next_activity_type | string |
Tipo de próxima atividade associada ao negócio. |
|
Duração da Próxima Atividade
|
next_activity_duration | string |
Duração da próxima atividade associada ao negócio. |
|
Observação da Próxima Atividade
|
next_activity_note | string |
Notas para a próxima atividade associada ao negócio |