Integração Pipedrive

Ativo

Receba novos deals e pessoas do Pipedrive direto na sua automação ARVEX.

Status

Ativo

Última conexão

29/07/2026, 00:46:46

Método

POST

Endpoint

POST /api/public/leads

Autenticação

Envie sua chave de API no cabeçalho x-api-key em todas as requisições.

x-api-key: SUA_CHAVE_ARVEX

Corpo da requisição

Campo	Obrigatório	Tipo	Descrição
name	Sim	string	Nome completo do lead
phone	Sim	string	Telefone BR em formato livre (ex.: +55 11 99999-0000)
email	Não	string	E-mail do lead
source	Não	string	Origem (ex.: rd_station, facebook_ads)
tag	Não	string	Tag de campanha ou segmentação
notes	Não	string	Observações livres (máx. 2000 caracteres)

Exemplo de requisição

curl

curl -X POST https://SEU-DOMINIO/api/public/leads \
  -H "Content-Type: application/json" \
  -H "x-api-key: SUA_CHAVE_ARVEX" \
  -d '{
    "name": "Maria Silva",
    "phone": "+55 11 99999-0000",
    "email": "maria@example.com",
    "source": "rd_station",
    "tag": "campanha_setembro",
    "notes": "Interessada em avaliação"
  }'

Resposta · 201 Created

application/json

{
  "success": true,
  "message": "Lead received successfully",
  "lead_id": "uuid"
}

Comportamento

Valida name e phone (obrigatórios).

Deduplica leads com mesmo phone + email nas últimas 24h.

Persiste o lead na tabela leads.

Dispara o evento de automação new_lead_received com o payload completo do lead.

Códigos de erro

Código	Descrição
400	Corpo JSON inválido
401	x-api-key ausente ou inválida
422	Falha de validação (veja `errors`)
500	Erro de banco de dados ou servidor

Payload esperado do webhook Pipedrive

application/json

{
  "current.person.name": "",
  "current.person.phone": "",
  "current.person.email": "",
  "current.title": ""
}

Fluxo

Pipedrive → Normalização → /leads → Automação ARVEX

Endpoint Webhook Pipedrive

POST /api/public/integrations/pipedrive/webhook

Pronto para configurar?

Cole o endpoint acima nas configurações de webhook do Pipedrive e comece a receber leads automaticamente.

Ver documentação completa

ARVEX · Plataforma de automação de atendimento para clínicas