Como integrar o ADManager Plus e o Pipedrive

Pré-requisitos

O Pipedrive usa o OAuth 2.0 para autorizar solicitações de API.

Ele requer um client_id e client_secret para autorização.

Privilégios:

Para importar usuários (ação de entrada): Certifique-se de que a conta usada para autorização tenha permissão para ler todas as contas de usuário.

Para executar qualquer ação ou consulta no Pipedrive (ação de saída): Certifique-se de que a conta usada para autorização tenha permissão para executar a ação desejada.

Configuração de autorização

• Efetue login no ADManager Plus e navegue até a aba Automation.
• No painel esquerdo, em Configuration, clique em Application Integrations.
• Em Enterprise Applications, clique em Pipedrive.
• Ative o botão Enable Pipedrive Integration.
• Na página Pipedrive Configuration, clique em Authorization.
• Execute as etapas para gerar um client_id e client_secret do Pipedrive e cole-os nos respectivos campos de valor.
• Clique em Configure.

Configuração do webhook de entrada

Os webhooks de entrada permitem buscar dados de usuário do Pipedrive e enviá-los para o ADManager Plus. O mapeamento de atributos configurado nesta seção pode ser selecionado como a fonte de dados durante a configuração da automação. Para configurar um webhook de entrada para o Pipedrive:

• Em Inbound Webhook, clique em Pipedrive Endpoint Configuration.

• Na aba Endpoint Configuration, um endpoint, Pipedrive USERS ENDPOINT, vem pré-configurado. No entanto, se desejar usar um novo endpoint para importar usuários, você pode configurar um usando o + Add API endpoint button e preenchendo os campos necessários de acordo com a documentação de API do Pipedrive. Clique aqui para saber como.

  Observação:

  • O par de valores de chave de API é pré-configurado como um cabeçalho para autenticar solicitações de API, conforme configurado durante a authorization configuration.
  • Macros: Você pode adicionar macros à configuração de seu endpoint para mudá-lo dinamicamente conforme sua necessidade usando o componente macro chooser
  • Consulte a documentação de API do Pipedrive e configure cabeçalhos e parâmetros adicionais, se necessário. Na aba Settings , a opção Repeat calling this endpoint será configurada para buscar 30 registros por chamada. Isso será repetido até que nenhum token de próxima página seja recebido.

• Quando terminar, clique em Test & Save. Uma janela de resposta exibirá todos os parâmetros solicitados que podem ser obtidos usando a chamada de API. Após verificar se os parâmetros solicitados foram chamados à ação, clique em Proceed.

  Observação:

  • Consulte a documentação de API do Pipedrive para saber mais sobre os parâmetros que devem ser configurados para buscar apenas parâmetros específicos.
  • Você pode configurar vários endpoints para o Pipedrive usando o + Add API endpoint button. Clique aqui para saber como.
• Clique em Data Source - LDAP Attribute Mapping para corresponder endpoints e mapear os atributos LDAP do AD com os respectivos atributos no Pipedrive.

• Clique em + Add New Configuration e faça o seguinte:

  • Digite o Configuration Name e a Description e selecione a Automation Category no menu suspenso.

  • No campo Select Endpoint, selecione o endpoint desejado e uma Primary Key que seja exclusiva de um usuário (por exemplo, employeeIdentifier).

    Observação: Quando vários endpoints são configurados, esse atributo deve ter o mesmo valor em todos os endpoints.
  • No campo Attribute Mapping, selecione o atributo no menu suspenso LDAP Attribute Name e mapeie-o com o respectivo atributo no Pipedrive.
  • Se você quiser criar um novo formato personalizado para isso, clique em Add New Format.

Configuração do webhook de saída

Os webhooks de saída permitem que você envie mudanças feitas no AD para o Pipedrive, obtenha dados do Pipedrive e execute tarefas no Pipedrive - tudo a partir do ADManager Plus. Os webhooks configurados nesta seção podem ser incluídos nos modelos de orquestração, que, por sua vez, podem ser usados durante automações programadas e orientadas por eventos. Eles também podem ser aplicados diretamente nos usuários desejados para executar uma sequência de ações neles (Management > Advanced Management > Orchestration). Para configurar webhooks de saída para o Pipedrive:

• Em Outbound Webhook, clique em Pipedrive Webhook Configuration.
• Clique em + Add Webhook.
• Digite um nome e uma descrição para esse webhook.
• Decida a ação que deve ser executada e consulte a documentação de API do Pipedrive para obter os detalhes da API, como URL, cabeçalhos e parâmetros.
• Selecione o método HTTP que permitirá que você execute a ação desejada no endpoint no menu suspenso.
• Digite o URL do endpoint.
• Configure Headers, Parameters e Message Type no formato apropriado com base na chamada de API que você gostaria de executar.
• Clique em Test and Save.
• Uma janela pop-up exibirá uma lista de usuários e grupos do AD para testar a chamada de API configurada. Selecione o usuário ou grupo desejado sobre o qual essa solicitação de API deve ser testada e clique em OK. Isso fará uma chamada em tempo real para o URL do endpoint e os objetos selecionados serão modificados de acordo com a configuração.
• A resposta do webhook e os detalhes da solicitação serão exibidos. Verifique se eles correspondem ao comportamento esperado da API e clique em Save.