Conectando o Pipedrive

O Pipedrive se conecta via OAuth. Os webhooks são registrados 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, vá até Accounts e selecione a conta.
  2. Clique em CRM Integrations no menu lateral.
  3. No card do Pipedrive, clique em Connect Pipedrive.
  4. Você será redirecionado para a página de autorização do Pipedrive. Faça login com sua conta Pipedrive se solicitado.
  5. Revise as permissões e clique em Allow and Install.
  6. Você será redirecionado de volta ao True Conversions. Uma mensagem de sucesso confirma a conexão.

Pronto. O True Conversions automaticamente:

  • Registra um webhook na sua conta Pipedrive que monitora mudanças de status de negócios (deals).
  • Cria um campo personalizado GCLID nos registros de pessoa do Pipedrive (se ainda não existir). Esse campo armazena o Google Ads click ID para correspondência de conversões offline.

Quais Eventos São Capturados

O True Conversions monitora eventos de negócio ganho (deal won). Quando o status de um negócio muda para "ganho" no Pipedrive, o webhook dispara e o True Conversions:

  1. Recebe os dados do negócio.
  2. Extrai email, telefone, nome, valor do negócio e GCLID (se presente) do contato.
  3. Normaliza e aplica hash no PII.
  4. Roteia a conversão para as plataformas de anúncios conectadas (Google Ads, Meta).

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


Campo GCLID

Para que o Google Ads Enhanced Conversions associe a conversão offline ao clique original no anúncio, o GCLID (Google Click ID) precisa estar armazenado no registro do contato no Pipedrive.

O True Conversions cria esse campo personalizado automaticamente quando você conecta. Para populá-lo:

  1. Instale a tag GTM do True Conversions no seu site (veja Primeiros Passos).
  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 (ex.: Zapier, Make, captura nativa de formulários), mapeie o campo oculto gclid do seu formulário para o campo GCLID de pessoa no Pipedrive.


Re-autorização

Se o token OAuth expirar (normalmente após um período prolongado de inatividade), o status da integração mostrará expired na página CRM Integrations. Clique em Re-authorize para reconectar. O webhook existente é substituído automaticamente.


Desconectando

Clique em Disconnect no card do Pipedrive. Isso remove o registro da integração do True Conversions. O webhook registrado no Pipedrive deixará de receber eventos. Para uma limpeza completa, você também pode deletar o webhook manualmente no Pipedrive em Settings > Tools and integrations > Webhooks.