Nó PipeDrive

O nó de workflow PipeDrive chama a PipeDrive API v1 para gerenciar deals, pessoas e atividades. Use-o para sincronizar conversas de vendas do WhatsApp no seu pipeline PipeDrive ou disparar follow-ups quando deals mudam de estágio.

ID do nó no editor: pipedrive_request
Base URL: https://api.pipedrive.com/v1/
Auth: API token como parâmetro de query ?api_token={{pipedrive_api_token}}

O que faz

• Envia requisições HTTP autenticadas para endpoints REST do PipeDrive
• Suporta GET, POST, PUT, PATCH e DELETE
• Retorna status HTTP, data de resposta e headers de resposta
• Inclui templates de operação para deals, pessoas e atividades

Pré-requisitos

1. Uma conta PipeDrive
2. API token em Personal preferences → API no PipeDrive
3. Chave de integração pipedrive_api_token em Configurações → Chaves de API

O PipeDrive autentica via parâmetro de query api_token, não headers Bearer. Sempre acrescente ?api_token={{pipedrive_api_token}} às suas URLs (os templates fazem isso automaticamente).

Como configurar

Passo 1 — Definir credenciais

1. No PipeDrive, acesse Personal preferences → API
2. Copie seu API token
3. No WhatsWave Configurações → Chaves de API, adicione:
   • Nome: pipedrive_api_token
   • Valor: seu PipeDrive API token

Passo 2 — Adicionar o nó

Arraste PipeDrive da paleta Marketing para o canvas do workflow.

Passo 3 — Escolher um template de operação

Passo 4 — Configurar campos da requisição

Exemplo — criar deal a partir de lead WhatsApp (POST):

• URL: https://api.pipedrive.com/v1/deals?api_token={{pipedrive_api_token}}
• Method: POST
• Body:

{
  "title": "WhatsApp — {{contact.name}}",
  "person_id": {{variables.pipedrive_person_id}},
  "value": 1500,
  "currency": "BRL",
  "stage_id": {{variables.pipedrive_stage_id}}
}

Exemplo — criar pessoa primeiro (POST /persons):

• URL: https://api.pipedrive.com/v1/persons?api_token={{pipedrive_api_token}}
• Method: POST
• Body:

{
  "name": "{{contact.name}}",
  "email": [{"value": "{{contact.email}}", "primary": true}],
  "phone": [{"value": "{{contact.phone}}", "primary": true}]
}

Exemplo — atualizar estágio do deal (PUT):

• URL: https://api.pipedrive.com/v1/deals/{{variables.deal_id}}?api_token={{pipedrive_api_token}}
• Method: PUT
• Body:

{
  "stage_id": {{variables.new_stage_id}}
}

O PipeDrive encapsula respostas em { success, data, ... }. O objeto deal/pessoa real fica em data.data.

Passo 5 — Usar dados da resposta

Deal ID: {{pipedrive_1.data.data.id}}
Person ID: {{pipedrive_1.data.data.person_id}}

Inspecione a saída de execução para confirmar o caminho exato — a estrutura aninhada data.data do PipeDrive varia levemente por endpoint.

Saídas do nó

Dicas e boas práticas

• Sempre inclua api_token na URL — esquecê-lo causa erros 401
• Crie person antes de deal — deals exigem person_id ou org_id
• Obtenha valores de stage_id nas configurações de pipeline do PipeDrive ou via GET /stages (URL customizada)
• O value do deal está em unidades de moeda (1500 = R$ 1.500,00), não em centavos
• Configure webhooks do PipeDrive para mudanças de estágio de deal → workflow Webhook do WhatsWave
• Use activities para registrar interações WhatsApp como chamadas/notas no PipeDrive
• Paginate com ?start=0&limit=100 nos endpoints de listagem
• Armazene IDs de pessoa/deal do PipeDrive em campos customizados de contato WhatsWave

Exemplos de casos de uso

Consulta WhatsApp → deal PipeDrive

1. Gatilho — mensagem WhatsApp recebida com intenção de compra
2. PipeDrive POST — criar pessoa
3. Variable — salvar person_id
4. PipeDrive POST — criar deal no primeiro estágio do pipeline
5. Enviar mensagem — "Obrigado! Nossa equipe entrará em contato."

Deal ganho → onboarding WhatsApp

1. Gatilho Webhook — deal PipeDrive atualizado (stage = won)
2. PipeDrive GET — buscar detalhes do deal e da pessoa
3. Enviar mensagem — boas-vindas e próximos passos

Resumo diário do pipeline

1. Gatilho agendado — toda manhã
2. PipeDrive GET — listar deals abertos
3. Loop — iterar deals
4. Enviar mensagem — notificar representante de vendas no WhatsApp

FAQ

Por que 401 Unauthorized?
api_token ausente ou inválido na query string da URL. Verifique a chave de integração pipedrive_api_token.

Por que os dados do deal ficam aninhados em data.data?
A API PipeDrive encapsula todas as respostas. Verifique data.success === true antes de ler data.data.

Posso usar autenticação Bearer token?
Não — o PipeDrive v1 usa autenticação por parâmetro de query. Acrescente ?api_token= a cada URL de requisição.

Como encontro stage_id?
Chame GET https://api.pipedrive.com/v1/stages?api_token={{pipedrive_api_token}} via configuração customizada, ou confira as configurações de pipeline na interface do PipeDrive.

Qual a diferença dos deals HubSpot?
O PipeDrive é focado em pipeline de vendas com gestão de deals mais simples. O HubSpot oferece marketing + CRM mais amplo. Use o CRM principal da sua equipe.

Referência da API

Relacionados

• Visão geral de Marketing
• Variáveis no workflow
• Webhooks recebidos
• Nó Loop