Integração Pipedrive CRM - Lumina Flow Builder

Visão Geral

A integração Pipedrive CRM permite que você automatize completamente seu pipeline de vendas diretamente de conversas no WhatsApp. Crie deals, gerencie contatos, organize empresas e sincronize todo o seu processo comercial em tempo real.

O que é Pipedrive?

Pipedrive é um CRM (Customer Relationship Management) focado em vendas, projetado para ajudar equipes comerciais a organizar, rastrear e fechar negócios. Com pipeline visual e automações, é uma das ferramentas mais populares para gestão de vendas no mundo.

Por que integrar Pipedrive com WhatsApp?

1. Captura Automática de Leads: Cadastre automaticamente todos os contatos que interagem via WhatsApp
2. Qualificação em Tempo Real: Qualifique leads durante a conversa e crie deals automaticamente
3. Pipeline Sincronizado: Movimente deals entre estágios baseado nas respostas dos clientes
4. Redução de Trabalho Manual: Elimine digitação repetitiva de dados no CRM
5. Resposta Mais Rápida: Equipe de vendas notificada instantaneamente sobre novos leads qualificados

Recursos Disponíveis

A integração oferece 11 operações completas organizadas em 3 recursos principais:

📊 Deals (Negócios)

Gerencie oportunidades de venda no seu pipeline:

• DEAL_CREATE - Criar novos negócios
• DEAL_GET - Buscar detalhes de um negócio
• DEAL_UPDATE - Atualizar negócios existentes
• DEAL_LIST - Listar múltiplos negócios

👤 Persons (Pessoas/Contatos)

Gerencie sua base de contatos:

• PERSON_CREATE - Criar novos contatos
• PERSON_GET - Buscar dados de um contato
• PERSON_UPDATE - Atualizar informações de contatos
• PERSON_SEARCH - Buscar contatos por nome/email

🏢 Organizations (Organizações/Empresas)

Gerencie empresas clientes (vendas B2B):

• ORGANIZATION_CREATE - Criar novas empresas
• ORGANIZATION_GET - Buscar dados de uma empresa
• ORGANIZATION_UPDATE - Atualizar informações de empresas

Configuração Inicial

1. Obter Credenciais do Pipedrive

Para usar a integração, você precisa:

API Token: 1. Acesse seu Pipedrive 2. Vá em Settings (Configurações) 3. Clique em Personal preferences (Preferências pessoais) 4. Selecione API 5. Copie seu Personal API token

Company Domain: - É o subdomínio da sua empresa no Pipedrive - Exemplo: se sua URL é minhaempresa.pipedrive.com, use minhaempresa

2. Configurar no Flow

Em cada node Pipedrive, configure:

{
  "config": {
    "apiToken": "SEU_TOKEN_AQUI",
    "companyDomain": "sua-empresa"
  }
}

Dica: Armazene o token em variável de ambiente ou variável de sistema para segurança:

{
  "config": {
    "apiToken": "{{pipedrive_token}}",
    "companyDomain": "{{pipedrive_domain}}"
  }
}

Casos de Uso Práticos

1. Captura e Qualificação de Leads

Fluxo: Visitante → Qualificação → Pessoa Criada → Deal Criado → Vendedor Notificado

START → INPUT (Nome) → INPUT (Empresa) → EMAIL → PHONE
  → PERSON_SEARCH (verificar se já existe)
  → CONDITION (não existe?)
    → PERSON_CREATE (criar contato)
    → DEAL_CREATE (criar negócio)
    → MESSAGE (confirmação)
  → END

Resultado: Lead qualificado entra automaticamente no pipeline com vendedor atribuído.

2. Atualização de Status de Pedido

Fluxo: Cliente consulta → Busca Deal → Mostra status

START → MESSAGE (Boas-vindas) → INPUT (Número pedido)
  → DEAL_GET (buscar detalhes)
  → MESSAGE (mostrar status, valor, estágio)
  → END

Resultado: Cliente obtém status em tempo real sem intervenção humana.

3. Progressão Automática no Pipeline

Fluxo: Cliente responde → Deal avança estágio

START → MESSAGE (Pergunta interesse)
  → INPUT (Resposta SIM/NÃO)
  → CONDITION (resposta = SIM?)
    → DEAL_UPDATE (mover para estágio "Proposta")
    → DEAL_UPDATE (atualizar probability = 60%)
    → MESSAGE (confirmação)
  → END

Resultado: Pipeline atualizado automaticamente baseado em interações.

4. Cadastro B2B Completo

Fluxo: Empresa → Contato → Deal vinculado

START → INPUT (Nome empresa) → INPUT (Endereço)
  → ORGANIZATION_CREATE (criar empresa)
  → INPUT (Nome contato) → EMAIL → PHONE
  → PERSON_CREATE (criar pessoa com org_id)
  → INPUT (Produto interesse) → NUMBER (Valor estimado)
  → DEAL_CREATE (criar deal vinculado a pessoa e organização)
  → MESSAGE (confirmação completa)
  → END

Resultado: Hierarquia completa criada: Empresa → Pessoa → Deal.

5. Dashboard de Vendas

Fluxo: Listar deals → Calcular métricas → Mostrar resumo

START → DEAL_LIST (buscar últimos 50 deals)
  → ACCUMULATOR (somar valores)
  → MESSAGE (mostrar total de deals e valor total)
  → END

Resultado: Vendedor vê resumo do pipeline via WhatsApp.

Estrutura de Dados

Deal (Negócio)

{
  "id": 123,
  "title": "Venda Sistema - Cliente ABC",
  "value": 15000,
  "currency": "BRL",
  "status": "open",
  "stage_id": 2,
  "person_id": 456,
  "person_name": "João Silva",
  "org_id": 789,
  "org_name": "Empresa ABC LTDA",
  "user_id": 5,
  "owner_name": "Vendedor João",
  "add_time": "2025-01-15 10:30:00",
  "expected_close_date": "2025-02-01"
}

Person (Pessoa)

{
  "id": 456,
  "name": "João Silva",
  "email": [
    {
      "value": "joao@empresa.com",
      "primary": true
    }
  ],
  "phone": [
    {
      "value": "11999998888",
      "primary": true
    }
  ],
  "org_id": 789,
  "org_name": "Empresa ABC LTDA",
  "owner_id": 5
}

Organization (Organização)

{
  "id": 789,
  "name": "Empresa ABC LTDA",
  "address": "Av. Paulista, 1000 - São Paulo/SP",
  "people_count": 5,
  "deals_count": 3,
  "owner_id": 5,
  "add_time": "2025-01-10 09:00:00"
}

Boas Práticas

Segurança

✅ SIM: - Armazene API token em variáveis de ambiente - Não exponha token em mensagens ao usuário - Use HTTPS sempre (API Pipedrive já usa) - Valide permissões do token antes de operações críticas

❌ NÃO: - Hardcodar tokens no JSON do flow - Compartilhar tokens publicamente - Usar tokens de outros usuários sem autorização

Performance

✅ SIM: - Use PERSON_SEARCH antes de criar para evitar duplicados - Cache resultados de GET quando usar múltiplas vezes - Use limit apropriado em LIST (evite buscar todos) - Salve IDs retornados em variáveis para reutilizar

❌ NÃO: - Fazer múltiplas buscas do mesmo dado - Criar duplicados sem verificar existência - Buscar lista completa quando precisa de 1 item - Fazer requisições desnecessárias

Dados

✅ SIM: - Valide dados antes de criar/atualizar - Use nodes de validação (EMAIL, PHONE, NUMBER) - Trate erros com CONDITION - Mantenha dados consistentes entre sistemas - Use campos customizados para rastreabilidade

❌ NÃO: - Criar registros com dados incompletos - Ignorar erros de validação da API - Sobrescrever dados importantes sem confirmar - Deixar campos obrigatórios vazios

Organização

✅ SIM: - Nomeie deals de forma clara e padronizada - Use estágios do pipeline de forma consistente - Atribua vendedor responsável sempre - Vincule deals a pessoas e organizações - Use descrições para contexto adicional

❌ NÃO: - Criar deals sem título claro - Deixar deals sem vendedor responsável - Misturar convenções de nomenclatura - Esquecer de vincular relacionamentos

Exemplos de Automações Avançadas

1. Lead Scoring Automático

Use respostas para calcular score e criar deal com prioridade:

INPUT (Orçamento) → SWITCH (faixas de valor)
  → Baixo: stage_id=1, priority=Low
  → Médio: stage_id=2, priority=Medium
  → Alto: stage_id=3, priority=High, vendedor senior
→ DEAL_CREATE com configurações específicas

2. Distribuição Inteligente de Leads

Distribua leads entre vendedores de forma balanceada:

PERSON_CREATE → VARIABLE (contador vendedor)
  → SWITCH (contador % 3)
    → 0: user_id=1 (Vendedor A)
    → 1: user_id=2 (Vendedor B)
    → 2: user_id=3 (Vendedor C)
→ DEAL_CREATE com vendedor atribuído
→ VARIABLE (incrementar contador)

3. Follow-up Automático

Agende lembretes baseado em estágio:

DEAL_UPDATE (estágio = Proposta Enviada)
  → DELAY (48 horas)
  → DEAL_GET (verificar se ainda está no mesmo estágio)
  → CONDITION (não avançou?)
    → WEBHOOK (notificar vendedor para follow-up)
    → MESSAGE (enviar lembrete ao cliente)

4. Recuperação de Deals Perdidos

Reative deals perdidos após período:

DEAL_LIST (status=lost)
  → LOOP (para cada deal)
    → CONDITION (lost há mais de 30 dias?)
      → MESSAGE (oferta especial)
      → INPUT (interesse?)
      → CONDITION (resposta positiva?)
        → DEAL_UPDATE (status=open, estágio inicial)

Limites e Considerações

Limites da API Pipedrive

• Rate Limit: 100 requisições por 10 segundos (por token)
• Dados retornados: Máximo 500 itens por LIST
• Tamanho payload: Máximo 5MB por requisição

Paginação

Para buscar mais de 500 deals, use paginação:

{
  "limit": 500,
  "start": 0
}

Segunda página:

{
  "limit": 500,
  "start": 500
}

Campos Customizados

Você pode criar campos customizados no Pipedrive e usá-los na integração:

{
  "deal": {
    "title": "Venda X",
    "Campo_Customizado__c": "Valor customizado",
    "Origem_Lead__c": "WhatsApp",
    "Score_Qualificacao__c": 85
  }
}

Nota: Campos customizados terminam com __c no Pipedrive.

Troubleshooting

Erro: "Unauthorized" (401)

Causa: API token inválido ou expirado

Solução: 1. Verifique se token está correto 2. Gere novo token no Pipedrive 3. Confirme que token tem permissões necessárias

Erro: "Not Found" (404)

Causa: ID não existe ou foi deletado

Solução: 1. Verifique se ID está correto 2. Use GET antes de UPDATE para validar existência 3. Use SEARCH para encontrar registro

Erro: "Validation Error" (422)

Causa: Dados obrigatórios faltando ou formato inválido

Solução: 1. Verifique campos obrigatórios (title em deals, name em persons/orgs) 2. Valide formato de emails e telefones 3. Confira tipos de dados (numbers vs strings)

Deal não aparece no Pipedrive

Possíveis causas: 1. Status = "deleted" (use status="open") 2. Criado em pipeline diferente do esperado 3. Filtros aplicados na visualização do Pipedrive

Solução: 1. Verifique status na resposta do CREATE 2. Confirme stage_id correto 3. Remova filtros na interface do Pipedrive

Recursos Adicionais

Documentação Oficial

• Pipedrive API Reference
• Pipedrive Developer Hub

Nodes Relacionados

• WEBHOOK - Notificar sistemas externos sobre mudanças
• CONDITION - Tomar decisões baseadas em dados
• LOOP - Processar múltiplos deals/pessoas
• VARIABLE - Armazenar IDs e dados temporariamente

Integrações Complementares

• SALESFORCE - CRM alternativo para grandes empresas
• HUBSPOT - CRM com foco em marketing e vendas
• MAILCHIMP - Email marketing para nutrir leads
• SLACK - Notificar equipe sobre novos deals

Suporte

Dúvidas ou problemas com a integração?

1. Consulte a documentação específica de cada operação
2. Verifique os exemplos práticos incluídos
3. Teste flows em ambiente de desenvolvimento primeiro
4. Use responseVariable para debug de respostas

Estatísticas de Uso

A integração Pipedrive no Lumina Flow Builder oferece:

• 11 operações completas
• 3 recursos principais (Deals, Persons, Organizations)
• 100% da funcionalidade essencial para automação de vendas
• Suporte para campos customizados ilimitados
• Compatível com todas as versões do Pipedrive

---

Documentação completa e atualizada em: 15 de janeiro de 2025

Versão da API: Pipedrive API v1

Status: Produção - Totalmente funcional