Integração Pipedrive + Leavo

Integração via Webhook – Pipedrive + Leavo

1. Visão Geral

O Pipedrive é um CRM focado em vendas, projetado para gerenciar pipelines e processos comerciais. A integração com o Leavo permite automatizar a sincronização de leads qualificados direto para o CRM e manter dados atualizados em tempo real.

Casos de uso principais:

• Enviar leads qualificados do Leavo direto para o Pipedrive
• Criar deals automaticamente quando lead é qualificado
• Atualizar status de leads no Leavo quando deal muda no Pipedrive
• Sincronizar dados bidirecionalmente entre sistemas

Fluxos disponíveis:

• ✅ Leavo → Pipedrive: Criar pessoas, organizações e deals via API REST
• ✅ Pipedrive → Leavo: Webhooks v2 notificam mudanças no CRM

Diferencial: CRM robusto com webhooks v2 avançados e API REST completa.

2. Documentação Oficial

Pipedrive:

• Guia para Webhooks v2
• API Reference v1/v2
• Tutorial: Create a Deal

Leavo:

• Painel de Webhooks

3. Recursos disponíveis via Webhook

3.1 Eventos do Pipedrive (Webhooks v2)

O Pipedrive suporta combinações de Ações e Objetos:

Eventos mais relevantes para Leavo:

• ✅ create.deal - Deal criado
• ✅ change.deal - Deal alterado (mudança de estágio)
• ✅ create.person - Pessoa criada
• ✅ change.person - Pessoa alterada

4. Como configurar webhooks

4.1 FLUXO 1: Leavo → Pipedrive (Enviar Leads Qualificados)

Permite que leads qualificados no Leavo sejam criados automaticamente como Deals no Pipedrive.

Passo 1: Obter API Token do Pipedrive

1.1 No Pipedrive:

1. Vá em Configurações (⚙️)
2. Selecione Configurações Pessoais
3. Clique na aba API
4. Copie o API Token

⚠️ IMPORTANTE: Guarde este token com segurança.

Passo 2: Identificar IDs Necessários

O Pipedrive requer IDs específicos. Vamos obtê-los via API:

2.1 Pipeline ID:

curl 'https://api.pipedrive.com/v1/pipelines?api_token=YOUR_TOKEN'

2.2 Stage ID (Estágio inicial):

curl 'https://api.pipedrive.com/v1/stages?pipeline_id=1&api_token=YOUR_TOKEN'

2.3 User ID (Responsável):

curl 'https://api.pipedrive.com/v1/users?api_token=YOUR_TOKEN'

Passo 3: Configurar Middleware (n8n ou Zapier)

⚠️ IMPORTANTE: O Pipedrive requer autenticação via api_token na query string. O Leavo não suporta parâmetros na URL de webhooks de saída.

Solução: Use middleware (n8n, Make, Zapier)

Opção A: Usando n8n

3.1 Criar Workflow no n8n:

3.2 Nó Function (Transform):

// Transformar payload do Leavo para Pipedrive
const leavo = $json.body.data;

return {
  json: {
    title: `${leavo.nome} - ${leavo.empresa}`,
    person_name: leavo.nome,
    person_email: leavo.email,
    person_phone: leavo.telefone,
    org_name: leavo.empresa,
    user_id: 123456, // ID do responsável
    pipeline_id: 1,
    stage_id: 2, // Qualificação
    value: 0,
    status: 'open'
  }
};

Passo 4: Configurar Webhook de Saída no Leavo

1. No Leavo, vá em Webhooks → Saída
2. Clique em "+ Criar Webhook"

Configurar:

4.2 FLUXO 2: Pipedrive → Leavo (Notificar Mudanças)

Permite que mudanças no Pipedrive (ex: deal ganho) atualizem o Leavo.

Passo 1: Criar Webhook de Entrada no Leavo

1. No Leavo, vá em Webhooks → Entrada
2. Clique em "+ Criar Webhook"

Configurar:

• Nome: Receber de Pipedrive - Deals
• Descrição: Atualiza leads quando deal muda
• Webhook ativo: LIGADO

Passo 2: Copiar URL do Leavo

Passo 3: Configurar Webhook no Pipedrive

Via Painel:

1. No Pipedrive, vá em Configurações → Ferramentas e aplicativos
2. Clique em (Ferramentas) → Webhooks
3. Clique em "+ Create webhook"

Configurar:

Passo 4: Estrutura do Payload do Pipedrive

Exemplo de change.deal:

{
  "meta": {
    "action": "change",
    "entity": "deal",
    "company_id": "12345",
    "entity_id": "789",
    "timestamp": "2025-12-11T18:00:00.000Z",
    "version": "2.0"
  },
  "data": {
    "id": 789,
    "title": "João Silva - Empresa ABC",
    "value": 5000,
    "currency": "BRL",
    "status": "won",
    "stage_id": 5,
    "pipeline_id": 1,
    "person_id": 456,
    "org_id": 654
  },
  "previous": {
    "status": "open",
    "stage_id": 2
  }
}

5. Testando a integração

✅ Checklist - Leavo → Pipedrive

Pipedrive:

• API Token obtido
• Pipeline ID identificado
• Stage ID identificado
• User ID identificado

Middleware (n8n/Make):

• Workflow/Scenario criado
• Webhook configurado
• Transformation logic implementada
• Pipedrive API configurada

Teste:

• Lead qualificado no Leavo
• Webhook disparou
• Deal criado no Pipedrive
• Campos corretos

✅ Checklist - Pipedrive → Leavo

Leavo:

• Webhook de entrada criado
• URL copiada

Pipedrive:

• Webhook criado
• URL do Leavo configurada
• Evento change.deal configurado

6. Estrutura de Payloads

6.1 Leavo → Pipedrive (via API)

curl -X POST 'https://api.pipedrive.com/v1/deals?api_token=YOUR_TOKEN' \
-H 'Content-Type: application/json' \
-d '{
  "title": "Maria Santos - Tech Solutions",
  "person_name": "Maria Santos",
  "person_email": "maria@example.com",
  "person_phone": "5511988887777",
  "org_name": "Tech Solutions",
  "user_id": 123456,
  "pipeline_id": 1,
  "stage_id": 2,
  "value": 5000,
  "currency": "BRL",
  "status": "open"
}'

7. Observações e Limitações

7.1 Limitações do Pipedrive

8. Boas Práticas

8.1 Use Campos Customizados

✅ Crie campos para dados do Leavo:

• cf_status_leavo - Status do lead
• cf_score_leavo - Score de qualificação
• cf_origem - Origem do lead

8.2 Sincronize Estágios

✅ Mapeie estágios do Pipedrive com status do Leavo:

9. Troubleshooting

9.1 Deal não cria

9.2 Webhook não dispara

10. Casos de Uso

10.1 Pipeline Automatizado

Objetivo: Leads qualificados viram deals automaticamente

Fluxo:

10.2 Sincronização Bidirecional

Objetivo: Status sincronizado entre sistemas

Fluxo:

Referências

• Pipedrive Webhooks v2 Guide
• Pipedrive API Reference
• Painel de Webhooks Leavo