> ## Documentation Index
> Fetch the complete documentation index at: https://docs.deltalead.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Webhook Event Reference: All DeltaLead Event Types
> Reference for all DeltaLead webhook events — lead lifecycle, conversation, appointment, and agent handoff events with full payload schemas.
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
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.
```json Example payload theme={null}
{
"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"
}
}
```
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`.
```json Example payload theme={null}
{
"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"
}
}
```
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.
```json Example payload theme={null}
{
"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"
}
}
```
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.
```json Example payload theme={null}
{
"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
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.
```json Example payload theme={null}
{
"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"
}
}
```
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.
```json Example payload theme={null}
{
"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
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.
```json Example payload theme={null}
{
"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
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.
```json Example payload theme={null}
{
"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"
}
}
```