Conectar Pipedrive ao Elido

A integração com Pipedrive cria negócios e atualiza seu estágio quando o Elido dispara um evento de conversão ou um link ultrapassa um limite de cliques. Baseada em token de API — sem OAuth, sem registro de aplicativo.

Obtenha seu token de API do Pipedrive#

1. Faça login no Pipedrive.
2. Clique no seu avatar → Personal preferences → API.
3. Copie o token exibido. É uma string hexadecimal de 40 caracteres. Não confunda com um client secret OAuth — este é o token pessoal vinculado à sua conta.

Configure no Elido#

1. Vá para Dashboard → Webhooks → Add Pipedrive.
2. Cole o token de API. Clique em Fetch pipelines — o Elido consulta a API do Pipedrive e lista todos os pipelines que sua conta pode ver.
3. Selecione o pipeline de destino e o estágio padrão do negócio para novos negócios.
4. (Opcional) Selecione um usuário proprietário para negócios criados automaticamente.
5. Clique em Save.

Configure os gatilhos#

Em Dashboard → Webhooks → Pipedrive → Triggers, configure o que dispara uma ação no Pipedrive:

• Conversion recorded → cria um novo negócio. O título do negócio é definido com o slug do link e a campanha UTM se presente (ex: spring-2026 / newsletter). O campo de valor é preenchido com o value e currency declarados na conversão.
• Threshold exceeded → move um negócio existente para o próximo estágio. O Elido faz a correspondência pelo click_id do link armazenado no campo personalizado do negócio (você configurará isso no passo 3 abaixo).
• Scan failure → cria um negócio com o rótulo "Needs review". Use isso se um link sinalizado for um ativo de vendas que precisa de acompanhamento manual.

Adicione o campo personalizado click_id (para o gatilho de limite)#

Para que o movimento de limite para estágio funcione, o Pipedrive precisa armazenar o click_id do Elido no negócio para que o Elido possa procurá-lo mais tarde.

1. No Pipedrive, vá para Settings → Data fields → Deals → Add custom field.
2. Tipo: Text, rótulo: Elido Click ID.
3. Copie a chave do campo (o Pipedrive a exibe na lista de campos, ex: 8b2a4c...).
4. Cole-a em Dashboard → Webhooks → Pipedrive → Click ID field key.

O que não sincroniza#

• Negócios históricos — O Elido apenas cria negócios a partir de eventos que acontecem após a conexão.
• Pipedrive → Elido — apenas saída. Alterações de estágio de negócio no Pipedrive não afetam os links do Elido.

Solução de problemas#

"401 Unauthorized" — O token de API está incorreto. Confirme chamando https://api.pipedrive.com/v1/users/me?api_token=TOKEN em um navegador. Se você ver seu perfil de usuário, o token é válido.

Pipeline não aparece na lista — Seu usuário do Pipedrive pode não ter acesso a esse pipeline. As configurações de visibilidade do Pipedrive podem restringir o acesso ao pipeline por equipe. Verifique com seu administrador do Pipedrive.

Negócios criados sem proprietário — Se o campo de proprietário estiver em branco na configuração do Elido, os negócios são atribuídos ao usuário cujo token de API foi usado. Defina um proprietário explícito se quiser que os negócios sejam atribuídos a outra pessoa.

Negócios duplicados — Cada evento de conversão cria um negócio. Se você estiver vendo duplicatas, verifique se o mesmo workspace do Elido está configurado com duas conexões ao Pipedrive (raro, mas possível se você tiver readicionado a integração).