** Pipedrive
O Pipedrive é uma ferramenta de gerenciamento de pipeline e CRM que ajuda você a se concentrar em ações importantes.
Este conector está disponível nos seguintes produtos e regiões:
| Serviço | Class | Regiões |
|---|---|---|
| Estúdio Copiloto | Premium | Todas as regiões do Power Automatic , exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicações Lógicas | Standard | Todas as regiões do Logic Apps , exceto as seguintes: - Regiões do Azure Government - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Aplicações Power | Premium | Todas as regiões do Power Apps , exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Automatize o poder | Premium | Todas as regiões do Power Automatic , exceto as seguintes: - Governo dos EUA (CCG) - 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 | |
|---|---|
| Editora | Microsoft |
| Sítio Web | https://www.pipedrive.com/ |
| Política de privacidade | https://www.pipedrive.com/privacy |
A criar uma ligação
O conector suporta os seguintes tipos de autenticação:
| Predefinição | 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.
Esta conexão não é compartilhável. Se o aplicativo avançado 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 |
Limites de Limitação
| Name | Chamadas | Período de Renovação |
|---|---|---|
| Chamadas de API por conexão | 100 | 60 segundos |
| Frequência das sondagens de desencadeamento | 1 | 120 segundos |
Ações
| Adicionar atividade |
Esta operação é usada para criar uma nova atividade para a conta autorizada. |
| Adicionar oferta (V2) (Pré-visualização) |
Esta operação cria um novo negócio para a conta autorizada. |
| Adicionar oferta [DEPRECATED] |
Esta ação foi preterida. Por favor, use Adicionar oferta (V2) em vez disso.
|
| Atualizar status do negócio |
Esta operação é usada para atualizar o status associado a um negócio, dado o seu id. |
| Estágio de atualização do negócio (V2) (Visualização) |
Esta operação é usada para atualizar o estágio associado a um negócio, dado o seu id. |
| Etapa de atualização do negócio [DEPRECATED] |
Esta ação foi preterida. Em vez disso, use o estágio de atualização do acordo (V2).
|
| Obter estágio por id |
Esta operação retorna dados sobre um estágio específico. |
| Obter oferta por id |
Esta operação recupera todos os detalhes de um negócio existente, dado o seu id. |
Adicionar atividade
Esta operação é usada para criar uma nova atividade para a conta autorizada.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Tipo
|
type | True | string |
Tipo de atividade. |
|
Assunto
|
subject | True | string |
Objeto da atividade. |
|
Data Para Conclusão
|
due_date | string |
AAAA-MM-DD |
|
|
Prazo de vencimento
|
due_time | string |
HH: MM |
|
|
Duração
|
duration | string |
HH: MM |
|
|
Observações
|
note | string | ||
|
Atribuído a
|
user_id | integer |
ID do usuário ao qual a atividade será atribuída. |
|
|
ID da Oferta
|
deal_id | integer |
ID do negócio ao qual a atividade será associada. |
|
|
ID de contato
|
person_id | integer |
ID da pessoa à qual a atividade estará associada. |
|
|
ID da Organização
|
org_id | integer |
ID da organização à qual a atividade será associada. |
Devoluções
dados
- Body
- ActivityResponse
Adicionar oferta (V2) (Pré-visualização)
Esta operação cria um novo negócio para a conta autorizada.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Title
|
title | True | string |
Título do negócio. |
|
Pipeline Id
|
pipeline_id | string |
O id do pipeline para buscar estágios. |
|
|
ID do estágio
|
stage_id | string |
Fase do negócio. |
|
|
Situação
|
status | string |
Situação do negócio. |
|
|
Valor
|
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 negócio. |
|
|
Data de Encerramento Esperada
|
expected_close_date | string |
yyyy-MM-dd |
|
|
Visibilidade
|
visible_to | string |
Proprietário, seguidores ou toda a empresa. |
Devoluções
dados
- Body
- DealResponseV2
Adicionar oferta [DEPRECATED]
Esta ação foi preterida. Por favor, use Adicionar oferta (V2) em vez disso.
Esta operação cria um novo negócio para a conta autorizada.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Title
|
title | True | string |
Título do negócio. |
|
ID do estágio
|
stage_id | string |
Fase do negócio. |
|
|
Situação
|
status | string |
Situação do negócio. |
|
|
Valor
|
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 negócio. |
|
|
Data de Encerramento Esperada
|
expected_close_date | string |
yyyy-MM-dd |
|
|
Visibilidade
|
visible_to | string |
Proprietário, seguidores ou toda a empresa. |
Devoluções
dados
- Body
- DealResponse
Atualizar status do negócio
Esta operação é usada para atualizar o status associado a um negócio, dado o seu id.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
ID da Oferta
|
dealId | True | integer |
Negócio |
|
Situação
|
status | True | string |
Situação do negócio. |
|
Razão perdida
|
lost_reason | string |
Mensagem sobre o motivo da perda do negócio. |
Devoluções
dados
- Body
- DealResponse
Estágio de atualização do negócio (V2) (Visualização)
Esta operação é usada para atualizar o estágio associado a um negócio, dado o seu id.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
ID da Oferta
|
dealId | True | integer |
Negócio |
|
Pipeline Id
|
pipeline_id | True | string |
O id do pipeline para buscar estágios. |
|
ID do estágio
|
stage_id | True | string |
Fase do negócio. |
|
Data de Encerramento Esperada
|
expected_close_date | string |
yyyy-MM-dd |
Devoluções
dados
- Body
- DealResponseV2
Etapa de atualização do negócio [DEPRECATED]
Esta ação foi preterida. Em vez disso, use o estágio de atualização do acordo (V2).
Esta operação é usada para atualizar o estágio associado a um negócio, dado o seu id.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
ID da Oferta
|
dealId | True | integer |
Negócio |
|
ID do estágio
|
stage_id | True | string |
Fase do negócio. |
|
Data de Encerramento Esperada
|
expected_close_date | string |
yyyy-MM-dd |
Devoluções
dados
- Body
- DealResponse
Obter estágio por id
Esta operação retorna dados sobre um estágio específico.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
ID do estágio
|
stageId | True | integer |
ID do estágio |
Devoluções
- Body
- StageResponse
Obter oferta por id
Esta operação recupera todos os detalhes de um negócio existente, dado o seu id.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
ID da Oferta
|
dealId | True | integer |
Negócio |
Devoluções
dados
- Body
- DealResponse
Acionadores
| Quando um novo acordo é adicionado [DEPRECATED] |
Esta ação foi preterida. Por favor, use Quando um novo acordo é adicionado (V2) em vez disso.
|
| Quando um novo negócio é adicionado (V2) (Visualização) |
Aciona quando um novo negócio é adicionado à conta autorizada (V2). |
| Quando uma nova atividade é adicionada |
Aciona quando uma nova atividade é adicionada à conta autorizada. |
Quando um novo acordo é adicionado [DEPRECATED]
Esta ação foi preterida. Por favor, use Quando um novo acordo é adicionado (V2) em vez disso.
Aciona quando uma nova transação é adicionada à conta autorizada.
Devoluções
dados
- Body
- DealResponse
Quando um novo negócio é adicionado (V2) (Visualização)
Aciona quando um novo negócio é adicionado à conta autorizada (V2).
Devoluções
dados
- Body
- DealResponseV2
Quando uma nova atividade é adicionada
Aciona quando uma nova atividade é adicionada à conta autorizada.
Devoluções
dados
- Body
- ActivityResponse
Definições
StageResponse
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
ID do estágio
|
id | integer |
ID do estágio |
|
Nome artístico
|
name | string |
Nome da fase |
AtividadeResposta
dados
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
ID da atividade
|
id | integer |
ID único da atividade. |
|
ID do Utilizador
|
user_id | integer |
Id do usuário ao qual a atividade é atribuída. |
|
Está Feito
|
done | boolean |
0 = Não concluído, 1 = Concluído |
|
Tipo
|
type | string |
Tipo de atividade. |
|
Data Para Conclusão
|
due_date | string |
AAAA-MM-DD |
|
Prazo de vencimento
|
due_time | string |
HH: MM |
|
Duração
|
duration | string |
HH: MM |
|
Assunto
|
subject | string |
Objeto da atividade. |
|
ID da Oferta
|
deal_id | integer |
ID do negócio ao qual a atividade está associada. |
|
Título do negócio
|
deal_title | string |
Título do negócio ao 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 |
aaaa-MM-ddTHH:mm:ss.fffZ |
|
Atualizações Date-Time
|
update_time | date-time |
aaaa-MM-ddTHH:mm:ss.fffZ |
|
Concluída Date-Time
|
marked_as_done_time | date-time |
aaaa-MM-ddTHH:mm:ss.fffZ |
|
ID do evento do Google Agenda
|
gcal_event_id | string |
ID do evento do calendário do Google. |
|
ID do Google Agenda
|
google_calendar_id | string |
Id do calendário do Google. |
|
Observação
|
note | string |
Nota da atividade (formato HTML). |
|
Atribuído a
|
assigned_to_user_id | integer |
ID de usuário do usuário ao qual a atividade é atribuída. |
|
Criado por
|
created_by_user_id | integer |
ID de usuário do usuário que criou a atividade. |
|
Nome do Proprietário
|
owner_name | string |
Nome do proprietário da atividade. |
DealResponse
dados
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
ID da Oferta
|
id | integer |
Id do negócio. |
|
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 |
E-mail do criador do negócio. |
|
Id
|
user_id.id | integer |
Id do proprietário do negócio. |
|
Nome
|
user_id.name | string |
Nome do proprietário do negócio. |
|
Email
|
user_id.email | string |
E-mail 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 negócio. |
|
Id
|
org_id.value | integer |
ID da organização associada ao negócio. |
|
Situação
|
status | string |
Aberto, ganho, perdido ou excluído. |
|
Título do negócio
|
title | string |
Título do negócio. |
|
Valor do Negócio
|
value | number |
Valor monetário do negócio. |
|
Moeda
|
currency | string |
Moeda associada ao valor do negócio. |
|
Criado Date-Time
|
add_time | date-time |
aaaa-MM-ddTHH:mm:ss.fffZ |
|
Atualizado Date-Time
|
update_time | date-time |
aaaa-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 artístico
|
stage_name | string |
Nome do estágio em que o negócio é colocado em um pipeline |
|
Estágio Uodated Date-Time
|
stage_change_time | date-time |
aaaa-MM-ddTHH:mm:ss.fffZ |
|
Está ativo
|
active | boolean |
True se o negócio estiver ativo. |
|
É suprimido
|
deleted | boolean |
True se o negócio tiver sido excluído. |
|
Data da próxima atividade
|
next_activity_date | string |
yyyy-MM-dd |
|
Próxima Hora da Atividade
|
next_activity_time | string |
aaaa-MM-ddTHH:mm:ss.fffZ |
|
Próxima ID da 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 |
|
Razão perdida
|
lost_reason | string |
Mensagem sobre o motivo da perda do negócio (para ser usada quando status=perdido). |
|
Visibilidade
|
visible_to | string |
Proprietário, seguidores ou toda a empresa. |
|
Fechado Date-Time
|
close_time | date-time |
aaaa-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 notas
|
notes_count | integer |
Número de notas associadas ao negócio. |
|
Contagem de seguidores
|
followers_count | integer |
Número de seguidores associados ao negócio. |
|
Contagem de mensagens de e-mail
|
email_messages_count | integer |
Número de mensagens de e-mail 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 não feitas
|
undone_activities_count | integer |
Número de atividades não realizadas associadas aos negócios. |
|
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 negócio. |
|
Data de Encerramento Esperada
|
expected_close_date | string |
yyyy-MM-dd |
|
Próximo Assunto da 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. |
|
Próxima Duração da Atividade
|
next_activity_duration | string |
Duração da próxima atividade associada ao negócio. |
|
Próxima Nota de Atividade
|
next_activity_note | string |
Notas para a próxima atividade associada ao negócio |
DealResponseV2
dados
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
ID da Oferta
|
id | integer |
Id do negócio. |
|
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 |
E-mail do criador do negócio. |
|
Id
|
user_id.id | integer |
Id do proprietário do negócio. |
|
Nome
|
user_id.name | string |
Nome do proprietário do negócio. |
|
Email
|
user_id.email | string |
E-mail 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 negócio. |
|
Id
|
org_id.value | integer |
ID da organização associada ao negócio. |
|
Situação
|
status | string |
Aberto, ganho, perdido ou excluído. |
|
Título do negócio
|
title | string |
Título do negócio. |
|
Valor do Negócio
|
value | number |
Valor monetário do negócio. |
|
Moeda
|
currency | string |
Moeda associada ao valor do negócio. |
|
Criado Date-Time
|
add_time | date-time |
aaaa-MM-ddTHH:mm:ss.fffZ |
|
Atualizado Date-Time
|
update_time | date-time |
aaaa-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 Uodated Date-Time
|
stage_change_time | date-time |
aaaa-MM-ddTHH:mm:ss.fffZ |
|
Está ativo
|
active | boolean |
True se o negócio estiver ativo. |
|
É suprimido
|
deleted | boolean |
True se o negócio tiver sido excluído. |
|
Data da próxima atividade
|
next_activity_date | string |
yyyy-MM-dd |
|
Próxima Hora da Atividade
|
next_activity_time | string |
aaaa-MM-ddTHH:mm:ss.fffZ |
|
Próxima ID da 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 |
|
Razão perdida
|
lost_reason | string |
Mensagem sobre o motivo da perda do negócio (para ser usada quando status=perdido). |
|
Visibilidade
|
visible_to | string |
Proprietário, seguidores ou toda a empresa. |
|
Fechado Date-Time
|
close_time | date-time |
aaaa-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 notas
|
notes_count | integer |
Número de notas associadas ao negócio. |
|
Contagem de seguidores
|
followers_count | integer |
Número de seguidores associados ao negócio. |
|
Contagem de mensagens de e-mail
|
email_messages_count | integer |
Número de mensagens de e-mail 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 não feitas
|
undone_activities_count | integer |
Número de atividades não realizadas associadas aos negócios. |
|
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 negócio. |
|
Data de Encerramento Esperada
|
expected_close_date | string |
yyyy-MM-dd |
|
Próximo Assunto da 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. |
|
Próxima Duração da Atividade
|
next_activity_duration | string |
Duração da próxima atividade associada ao negócio. |
|
Próxima Nota de Atividade
|
next_activity_note | string |
Notas para a próxima atividade associada ao negócio |