True Conversionsby Nexopath

Conectando o Pipedrive

O Pipedrive se conecta via OAuth. O webhook é registrado automaticamente — nenhuma configuração manual é necessária dentro do Pipedrive.

Pré-requisitos

  • Uma conta Pipedrive com acesso de administrador.
  • Uma conta já criada no True Conversions.

Passos para conexão

  1. No painel do True Conversions, abra a conta (cliente).
  2. Clique em Integrações de CRM.
  3. No card do Pipedrive, clique em Conectar Pipedrive.
  4. Você será redirecionado para a página de autorização do Pipedrive. Faça login se solicitado.
  5. Revise as permissões e clique em Allow and Install.
  6. Você será redirecionado de volta ao True Conversions com uma mensagem de sucesso.

Ao conectar, o True Conversions automaticamente:

  • Registra um webhook que monitora mudanças de negócio (deal) no Pipedrive.
  • Cria um campo personalizado GCLID nos registros de pessoa (se ainda não existir).

Qual comportamento você recebe depende da Otimização de valor

Isso é importante e não é óbvio pela interface do Pipedrive:

  • Sem Otimização de valor ativada (padrão): o True Conversions só recebe o evento quando um negócio muda para ganho. É um único evento de conversão por negócio — funciona bem para Enhanced Conversions simples.
  • Com Otimização de valor ativada (na página da conta): o True Conversions passa a receber toda mudança de etapa do negócio, com o nome da etapa incluído — isso é o que permite enviar um valor diferente em cada etapa do funil (Lead → SQL → Ganho) em vez de só um valor no fechamento.

Ou seja: para rastrear o funil completo, ative a Otimização de valor primeiro (veja Otimização de valor) — só depois disso o Pipedrive passa a enviar as etapas intermediárias.

Outras mudanças de status (ex.: "aberto", "perdido") são ignoradas em ambos os casos.

Campo GCLID

Para o Google Ads associar a conversão offline ao clique original, o GCLID precisa estar no registro do contato no Pipedrive. O True Conversions cria esse campo personalizado automaticamente ao conectar. Para populá-lo:

  1. Instale a tag GTM do True Conversions no seu site (veja Configuração e rastreamento).
  2. Garanta que o envio do formulário ou a integração com o CRM passe o valor do gclid para o campo GCLID no registro de pessoa do Pipedrive.

Se você usa uma integração de formulário para CRM (Zapier, Make, captura nativa), mapeie o campo oculto gclid do formulário para o campo GCLID de pessoa no Pipedrive.

Re-autorização

Se o token OAuth expirar, o status mostrará Expirada na página de Integrações de CRM. Clique em Reautorizar — o webhook existente é substituído automaticamente.

Desconectando

Clique em Desconectar no card do Pipedrive. O webhook registrado deixa de receber eventos. Para uma limpeza completa, delete-o manualmente no Pipedrive em Settings → Tools and integrations → Webhooks.