Webhooks & Integrações

Testes, simulações e log de eventos recebidos em tempo real

0 eventos

Simulador ProspecLead

POST /api/webhooks/sales/prospeclead

Formato:

customerInfo

name *

document (CNPJ) *

phone

vehicleInfo

plate *

brand *

model *

year *

vin (chassi)

deal info (opcional)

lead_id

deal_id

Payload JSON

Resposta da API

Aguardando envio...

Google Calendar

POST /api/webhooks/google-calendar

{"event":"OS_SCHEDULED","osId":"wo-001","techId":"T1","startTime":"2026-03-10T09:00:00Z"}

WhatsApp Lembrete

POST /api/webhooks/send-reminder

{"clientName":"João Silva","date":"10/03/2026","time":"09:00","address":"Av. Principal, 123","technicianName":"Carlos Técnico"}

Endpoints de Webhook

POST /api/webhooks/sales/prospeclead

Recebe venda do CRM ProspecLead. Cria automaticamente: Cliente (upsert), Veículo, O.S. de Instalação e Assinatura.

Suporta 2 formatos de payload:

Formato A — { customerInfo, vehicleInfo } (Next.js/Prisma)
Formato B — { client, vehicles[] } (Legacy multi-veículo)

POST /api/webhooks/google-calendar

Recebe notificações do Google Calendar sobre eventos de O.S. agendadas.

POST /api/webhooks/send-reminder

Dispara lembrete de instalação via WhatsApp Business API.

GET /api/webhooks/events

Lista os últimos eventos recebidos (ring buffer de 200).

Query params: ?source=prospeclead&limit=50

DELETE /api/webhooks/events

Limpa o log de eventos em memória.

Schema dos Payloads

Formato A — Next.js/Prisma (customerInfo + vehicleInfo)

{
  "customerInfo": {
    "name":     "Vale S.A.",
    "document": "33592510000154",  // CPF ou CNPJ
    "phone":    "(31) 99999-0001"
  },
  "vehicleInfo": {
    "plate": "ABC-1234",
    "brand": "Volvo",
    "model": "FH 540",
    "year":  2024,
    "vin":   "9BWHE21JX24060001"   // opcional
  },
  "lead_id": "LEAD-001",           // opcional
  "deal_id": "DEAL-003",           // opcional
  "notes":   "Comentário livre"    // opcional
}

Formato B — Legacy multi-veículo (client + vehicles[])

{
  "lead_id":   "LEAD-001",
  "deal_id":   "DEAL-003",
  "client": {
    "name":     "Transportes Brasil",
    "document": "98765432000111",
    "phone":    "(21) 99888-5555"
  },
  "vehicles": [
    { "plate":"ABC-1234", "brand":"Scania",
      "model":"R500", "year":2023 }
  ],
  "plan": {
    "name":          "Professional",
    "monthly_value": 1440,
    "devices_qty":   1,
    "billing_day":   15
  },
  "notes": "Gerado via ProspecLead"
}