Webhook Event Reference: All DeltaLead Event Types

This page is the definitive reference for every webhook event DeltaLead can deliver to your endpoint. Events are grouped by domain: lead lifecycle, conversation activity, appointments, and agent handoffs. For each event you will find the trigger condition and a full example payload so you know exactly what to expect in your handler.

Subscribe only to the events your integration actually needs. Filtering out irrelevant event types reduces unnecessary POST requests to your server and keeps your handler logic focused.

Lead Lifecycle Events

lead.created — New lead enters DeltaLead

Fired the moment a new lead arrives in DeltaLead from any connected channel — WhatsApp, Meta Ads, MercadoLibre, web form, email, or phone. At creation the lead’s score is 0; qualification happens asynchronously and triggers lead.qualified once complete.

Example payload

{
  "event": "lead.created",
  "timestamp": "2024-11-07T10:00:00Z",
  "organization_id": "org_xyz789",
  "data": {
    "id": "lead_abc123",
    "name": "Carlos Rodríguez",
    "phone": "+5491144441234",
    "channel": "facebook",
    "vehicle_interest": "Hilux 2024",
    "status": "new",
    "score": 0,
    "created_at": "2024-11-07T10:00:00Z"
  }
}

lead.qualified — AI completes lead qualification

Fired when the AI agent has finished its qualification conversation and assigned a purchase-intent score. The score field ranges from 0 to 100. The intent field reflects the AI’s assessment of how close the lead is to buying, for example purchase_30_days or researching.

Example payload

{
  "event": "lead.qualified",
  "timestamp": "2024-11-07T10:07:30Z",
  "organization_id": "org_xyz789",
  "data": {
    "id": "lead_abc123",
    "name": "Carlos Rodríguez",
    "phone": "+5491144441234",
    "score": 87,
    "intent": "purchase_30_days",
    "vehicle_interest": "Hilux SRX 2024",
    "status": "qualified",
    "channel": "facebook"
  }
}

lead.updated — Lead status, score, or assignment changes

Fired whenever a lead record is modified after creation. Common triggers include a manual status change by a seller, a score revision after a follow-up conversation, or an update to the vehicle of interest.

Example payload

{
  "event": "lead.updated",
  "timestamp": "2024-11-07T11:00:00Z",
  "organization_id": "org_xyz789",
  "data": {
    "id": "lead_abc123",
    "name": "Carlos Rodríguez",
    "phone": "+5491144441234",
    "score": 91,
    "status": "in_progress",
    "vehicle_interest": "Hilux SRX 2024",
    "channel": "facebook",
    "updated_at": "2024-11-07T11:00:00Z"
  }
}

lead.assigned — Lead assigned to a human seller

Fired when a qualified lead is assigned to a specific member of your sales team, either automatically by DeltaLead’s routing rules or manually by a manager. Use this event to notify the assigned seller via your own systems.

Example payload

{
  "event": "lead.assigned",
  "timestamp": "2024-11-07T11:05:00Z",
  "organization_id": "org_xyz789",
  "data": {
    "id": "lead_abc123",
    "name": "Carlos Rodríguez",
    "phone": "+5491144441234",
    "score": 91,
    "status": "assigned",
    "assigned_to": {
      "id": "user_seller001",
      "name": "Laura Méndez",
      "email": "laura.mendez@concesionaria.com"
    },
    "channel": "facebook",
    "vehicle_interest": "Hilux SRX 2024"
  }
}

Conversation Events

conversation.started — New conversation begins

Fired when a lead initiates a new conversation on any channel. A single lead can have multiple conversations over time; each one triggers its own conversation.started event.

Example payload

{
  "event": "conversation.started",
  "timestamp": "2024-11-07T10:00:05Z",
  "organization_id": "org_xyz789",
  "data": {
    "conversation_id": "conv_111aaa",
    "lead_id": "lead_abc123",
    "lead_name": "Carlos Rodríguez",
    "channel": "facebook",
    "agent_id": "agent_abc123",
    "agent_name": "Martín de Ventas",
    "started_at": "2024-11-07T10:00:05Z"
  }
}

conversation.message.received — Inbound message arrives

Fired each time a new inbound message is received from the lead during an active conversation. Subscribe to this event to mirror conversation history in your own CRM or data warehouse in real time.

Example payload

{
  "event": "conversation.message.received",
  "timestamp": "2024-11-07T10:01:20Z",
  "organization_id": "org_xyz789",
  "data": {
    "conversation_id": "conv_111aaa",
    "lead_id": "lead_abc123",
    "lead_name": "Carlos Rodríguez",
    "channel": "facebook",
    "message": {
      "id": "msg_999zzz",
      "body": "¿Tienen la Hilux SRX en stock?",
      "type": "text",
      "received_at": "2024-11-07T10:01:20Z"
    }
  }
}

Appointment Events

appointment.scheduled — AI books a test drive or showroom visit

Fired when an AI agent successfully schedules an appointment with a lead — typically a test drive or showroom visit. Use this event to add the appointment to your calendar system, notify the responsible seller, or prepare the vehicle.

Example payload

{
  "event": "appointment.scheduled",
  "timestamp": "2024-11-07T10:12:00Z",
  "organization_id": "org_xyz789",
  "data": {
    "lead_id": "lead_abc123",
    "lead_name": "Carlos Rodríguez",
    "appointment_type": "test_drive",
    "scheduled_at": "2024-11-09T11:00:00Z",
    "vehicle_interest": "Hilux SRX 2024"
  }
}

Agent Events

agent.handoff — AI transfers conversation to a human

Fired when an AI agent determines that a conversation requires human intervention and initiates a handoff. This occurs when one of the agent’s configured handoff_triggers is detected — for example, a lead asking to negotiate pricing or inquire about financing terms. The receiving seller gets full conversation context.

Example payload

{
  "event": "agent.handoff",
  "timestamp": "2024-11-07T10:15:00Z",
  "organization_id": "org_xyz789",
  "data": {
    "conversation_id": "conv_111aaa",
    "lead_id": "lead_abc123",
    "lead_name": "Carlos Rodríguez",
    "agent_id": "agent_abc123",
    "agent_name": "Martín de Ventas",
    "trigger": "financing",
    "channel": "facebook",
    "assigned_to": {
      "id": "user_seller001",
      "name": "Laura Méndez",
      "email": "laura.mendez@concesionaria.com"
    },
    "handoff_at": "2024-11-07T10:15:00Z"
  }
}

Overview

Leads

Conversations

Agents

Webhooks

Webhook Event Reference: All DeltaLead Event Types

Lead Lifecycle Events

Conversation Events

Appointment Events

Agent Events

​Lead Lifecycle Events

​Conversation Events

​Appointment Events

​Agent Events

Lead Lifecycle Events

Conversation Events

Appointment Events

Agent Events