Seven complete, schema-valid ACP envelopes covering the full range of automotive commerce scenarios. Each example is annotated with the scenario context, key metrics, and what makes ACP capture dramatically more than legacy formats. All
envelopes validate against acp-schema-v1.0.0.json.
{
"acp": {
"version": "1.0.0",
"protocol": "acp",
"generated_at": "2025-02-13T14:12:44Z",
"envelope_id": "acp_1739451164_b3k8m2",
"parent_envelope_id": null
},
"source": {
"provider": "AutomotiveAI",
"agent_type": "sales_chat",
"channel": "web_chat",
"session_id": "sess_a1b2c3d4",
"page_url": "https://genevamotors.com/inventory",
"referrer": "https://google.com/search?q=suvs+near+me",
"utm": { "source": "google", "medium": "organic" },
"device": { "type": "mobile", "os": "iOS 18" }
},
"dealership": {
"id": "geneva_motors_001",
"name": "Geneva Motors",
"crm_provider": "vinsolutions",
"dms_provider": "cdk",
"timezone": "America/Chicago"
},
"lead": {
"id": "lead_1739451164",
"status": "new",
"contact": {
"first_name": null,
"last_name": null,
"email": null,
"phone": null,
"zip": null
},
"vehicle_interests": [],
"budget": null,
"trade_in": null,
"intents": [
{
"type": "VEHICLE_INQUIRY",
"confidence": 0.82,
"detected_at": "2025-02-13T14:11:18Z",
"source_message_id": "msg_1"
}
],
"score": 7,
"score_factors": [
{ "factor": "VEHICLE_INQUIRY_intent", "points": 5, "category": "intent" },
{ "factor": "organic_search_source", "points": 2, "category": "engagement" }
]
},
"transaction": {
"id": "txn_1739451164",
"stage": "inquiry",
"last_updated": "2025-02-13T14:12:44Z"
},
"conversation": {
"id": "conv_1739451164",
"started_at": "2025-02-13T14:10:52Z",
"ended_at": "2025-02-13T14:12:44Z",
"duration_seconds": 112,
"message_count": 3,
"messages": [
{ "id": "msg_0", "role": "assistant", "content": "Welcome to Geneva Motors! I'd love to help you find your next vehicle. What are you looking for today?", "timestamp": "2025-02-13T14:10:52Z" },
{ "id": "msg_1", "role": "user", "content": "Do you have any SUVs available?", "timestamp": "2025-02-13T14:11:18Z" },
{ "id": "msg_2", "role": "assistant", "content": "We do! We have several great options right now — the 2025 Honda CR-V Sport Touring, 2024 Hyundai Tucson Limited Hybrid, 2024 Mazda CX-90 PHEV, and the 2025 Chevrolet Equinox EV. Prices range from $35,900 to $49,500. Any of those catch your eye, or do you have a budget or features in mind?", "timestamp": "2025-02-13T14:11:24Z" }
],
"sentiment": "neutral",
"topics": ["inventory", "suv"]
},
"events": [
{ "type": "conversation_started", "timestamp": "2025-02-13T14:10:52Z", "data": { "channel": "web_chat", "source": "organic" } },
{ "type": "intent_detected", "timestamp": "2025-02-13T14:11:18Z", "data": { "type": "VEHICLE_INQUIRY", "confidence": 0.82 } },
{ "type": "score_updated", "timestamp": "2025-02-13T14:11:18Z", "data": { "old_score": 2, "new_score": 7 } },
{ "type": "conversation_ended", "timestamp": "2025-02-13T14:12:44Z", "data": { "reason": "customer_idle" } }
]
}{
"acp": {
"version": "1.0.0",
"protocol": "acp",
"generated_at": "2025-02-13T15:42:30Z",
"envelope_id": "acp_1739456550_x8k2m9",
"parent_envelope_id": null
},
"source": {
"provider": "AutomotiveAI",
"agent_type": "sales_chat",
"channel": "web_chat",
"session_id": "sess_e5f6g7h8",
"page_url": "https://genevamotors.com/new/toyota-camry",
"utm": { "source": "google", "medium": "cpc", "campaign": "camry_2025" },
"device": { "type": "desktop", "os": "macOS" }
},
"dealership": {
"id": "geneva_motors_001",
"name": "Geneva Motors",
"crm_provider": "vinsolutions",
"dms_provider": "cdk",
"timezone": "America/Chicago"
},
"lead": {
"id": "lead_1739456200",
"status": "qualified",
"contact": {
"first_name": "Sarah",
"last_name": "Chen",
"email": "sarah.chen@email.com",
"phone": "+14155551234",
"zip": "60614"
},
"vehicle_interests": [
{
"year": 2025, "make": "Toyota", "model": "Camry", "trim": "XSE",
"condition": "new", "color": "Celestial Silver",
"stock_number": "T25-1847",
"features": ["Panoramic Roof", "JBL Audio"]
}
],
"budget": { "monthly_payment_target": 450, "down_payment": 5000 },
"trade_in": null,
"intents": [
{ "type": "VEHICLE_INQUIRY", "confidence": 0.95, "detected_at": "2025-02-13T15:30:22Z", "source_message_id": "msg_1" },
{ "type": "PRICING", "confidence": 0.88, "detected_at": "2025-02-13T15:33:10Z", "source_message_id": "msg_3" },
{ "type": "TEST_DRIVE", "confidence": 0.94, "detected_at": "2025-02-13T15:38:45Z", "source_message_id": "msg_5" }
],
"score": 78,
"score_factors": [
{ "factor": "email_provided", "points": 12, "category": "contact" },
{ "factor": "phone_provided", "points": 15, "category": "contact" },
{ "factor": "vehicle_interest", "points": 10, "category": "intent" },
{ "factor": "TEST_DRIVE_intent", "points": 18, "category": "intent" },
{ "factor": "budget_shared", "points": 8, "category": "qualification" },
{ "factor": "this_week_timeline", "points": 10, "category": "qualification" },
{ "factor": "paid_search_source", "points": 5, "category": "engagement" }
]
},
"transaction": {
"id": "txn_1739456200",
"stage": "qualified",
"last_updated": "2025-02-13T15:42:30Z",
"appointment": {
"type": "test_drive",
"scheduled_at": "2025-02-15T10:00:00-06:00",
"status": "scheduled",
"assigned_to": null
}
},
"conversation": {
"id": "conv_1739456200",
"started_at": "2025-02-13T15:30:00Z",
"ended_at": "2025-02-13T15:42:30Z",
"duration_seconds": 750,
"message_count": 8,
"messages": [
{ "id": "msg_0", "role": "assistant", "content": "Welcome to Geneva Motors! I'd love to help you find your next vehicle. What are you looking for?", "timestamp": "2025-02-13T15:30:00Z" },
{ "id": "msg_1", "role": "user", "content": "Hi! I'm interested in the 2025 Camry XSE. Is it still available?", "timestamp": "2025-02-13T15:30:22Z" },
{ "id": "msg_2", "role": "assistant", "content": "Great taste! Yes, we have the 2025 Camry XSE in Celestial Silver — stock T25-1847. It's priced at $32,499, which is $1,751 below MSRP. Comes loaded with the Panoramic Roof, JBL Audio, BSM, and Wireless CarPlay. Would you like to know more about financing or come see it in person?", "timestamp": "2025-02-13T15:30:28Z" },
{ "id": "msg_3", "role": "user", "content": "What would monthly payments look like? I'm trying to stay around $450/month with about $5k down.", "timestamp": "2025-02-13T15:33:10Z" },
{ "id": "msg_4", "role": "assistant", "content": "With $5,000 down on a 60-month term, you'd be looking at roughly $430-460/month depending on your rate. That's right in your range! We can get you a more precise number when you come in. Would you like to schedule a time to see the car and take it for a drive?", "timestamp": "2025-02-13T15:33:16Z" },
{ "id": "msg_5", "role": "user", "content": "Yeah I'd love to come in this Saturday morning if possible. My name is Sarah Chen.", "timestamp": "2025-02-13T15:38:45Z" },
{ "id": "msg_6", "role": "assistant", "content": "Perfect, Sarah! Saturday morning works great. How about 10 AM? I'll have the Camry ready and waiting. Can I grab your email and phone so we can send you a confirmation?", "timestamp": "2025-02-13T15:38:52Z" },
{ "id": "msg_7", "role": "user", "content": "Sure — sarah.chen@email.com and 415-555-1234. See you Saturday!", "timestamp": "2025-02-13T15:42:18Z" }
],
"sentiment": "positive",
"topics": ["camry", "pricing", "financing", "test_drive"]
},
"events": [
{ "type": "conversation_started", "timestamp": "2025-02-13T15:30:00Z", "data": { "channel": "web_chat" } },
{ "type": "intent_detected", "timestamp": "2025-02-13T15:30:22Z", "data": { "type": "VEHICLE_INQUIRY", "confidence": 0.95 } },
{ "type": "vehicle_interest_added", "timestamp": "2025-02-13T15:30:22Z", "data": { "make": "Toyota", "model": "Camry", "stock": "T25-1847" } },
{ "type": "intent_detected", "timestamp": "2025-02-13T15:33:10Z", "data": { "type": "PRICING", "confidence": 0.88 } },
{ "type": "intent_detected", "timestamp": "2025-02-13T15:38:45Z", "data": { "type": "TEST_DRIVE", "confidence": 0.94 } },
{ "type": "contact_extracted", "timestamp": "2025-02-13T15:38:45Z", "data": { "field": "name", "value": "Sarah Chen" } },
{ "type": "contact_extracted", "timestamp": "2025-02-13T15:42:18Z", "data": { "field": "email" } },
{ "type": "contact_extracted", "timestamp": "2025-02-13T15:42:18Z", "data": { "field": "phone" } },
{ "type": "score_updated", "timestamp": "2025-02-13T15:42:18Z", "data": { "old_score": 41, "new_score": 78 } },
{ "type": "stage_changed", "timestamp": "2025-02-13T15:42:18Z", "data": { "from": "inquiry", "to": "qualified" } },
{ "type": "appointment_scheduled", "timestamp": "2025-02-13T15:42:30Z", "data": { "type": "test_drive", "date": "2025-02-15T10:00:00-06:00" } },
{ "type": "conversation_ended", "timestamp": "2025-02-13T15:42:30Z", "data": { "reason": "natural_close" } }
],
"ai_analysis": {
"purchase_probability": 0.72,
"recommended_actions": ["confirm_appointment", "prepare_deal_sheet", "assign_senior_rep"],
"objections": [],
"engagement_level": "high",
"summary": "Sarah Chen inquired about the 2025 Camry XSE, discussed financing at $450/mo with $5K down, and scheduled a test drive for Saturday 10 AM. Strong purchase intent, no objections."
}
}{
"acp": {
"version": "1.0.0",
"protocol": "acp",
"generated_at": "2025-02-13T16:28:14Z",
"envelope_id": "acp_1739459294_m7p2q4",
"parent_envelope_id": null
},
"source": {
"provider": "AutomotiveAI",
"agent_type": "sales_chat",
"channel": "web_chat",
"session_id": "sess_j9k0l1m2",
"page_url": "https://genevamotors.com/new/ford-f150-lariat",
"utm": { "source": "facebook", "medium": "paid", "campaign": "truck_month" }
},
"dealership": {
"id": "geneva_motors_001",
"name": "Geneva Motors",
"crm_provider": "vinsolutions",
"timezone": "America/Chicago"
},
"lead": {
"id": "lead_1739458100",
"status": "qualified",
"contact": {
"first_name": "Marcus",
"last_name": "Rivera",
"email": "m.torres@email.com",
"phone": "+17735559876",
"zip": "60618"
},
"vehicle_interests": [
{
"year": 2024, "make": "Ford", "model": "F-150", "trim": "Lariat",
"condition": "new", "color": "Iconic Silver",
"stock_number": "F24-2281",
"features": ["4x4", "B&O Audio", "360° Camera", "Heated/Cooled Seats"]
}
],
"budget": {
"target_price": 50000,
"max_price": 53000,
"monthly_payment_target": 650,
"down_payment": 10000
},
"trade_in": {
"year": 2021, "make": "Honda", "model": "Civic",
"mileage": 38400,
"condition": "good",
"estimated_value": 18500,
"payoff_amount": 6200
},
"intents": [
{ "type": "VEHICLE_INQUIRY", "confidence": 0.97, "detected_at": "2025-02-13T16:05:30Z" },
{ "type": "TRADE_IN", "confidence": 0.93, "detected_at": "2025-02-13T16:10:44Z" },
{ "type": "FINANCING", "confidence": 0.91, "detected_at": "2025-02-13T16:15:22Z" },
{ "type": "NEGOTIATION", "confidence": 0.86, "detected_at": "2025-02-13T16:20:08Z" },
{ "type": "READY_TO_BUY", "confidence": 0.95, "detected_at": "2025-02-13T16:25:30Z" }
],
"score": 96,
"score_factors": [
{ "factor": "email_provided", "points": 12, "category": "contact" },
{ "factor": "phone_provided", "points": 15, "category": "contact" },
{ "factor": "READY_TO_BUY_intent", "points": 25, "category": "intent" },
{ "factor": "trade_in_discussed", "points": 12, "category": "qualification" },
{ "factor": "immediate_timeline", "points": 15, "category": "qualification" },
{ "factor": "budget_shared", "points": 8, "category": "qualification" }
]
},
"transaction": {
"id": "txn_1739458100",
"stage": "negotiation",
"last_updated": "2025-02-13T16:28:14Z",
"offer_history": [
{
"revision": 1,
"timestamp": "2025-02-13T16:22:00Z",
"status": "countered",
"vehicle_price": 52750,
"trade_in_value": 17000,
"monthly_payment": 680,
"notes": "Customer asked for lower trade-in payoff consideration"
}
],
"finance_terms": {
"type": "finance",
"term_months": 72,
"apr": 4.9,
"down_payment": 10000,
"monthly_payment": 680,
"credit_tier": "tier_1"
}
},
"conversation": {
"id": "conv_1739458100",
"started_at": "2025-02-13T16:05:00Z",
"ended_at": "2025-02-13T16:28:14Z",
"duration_seconds": 1394,
"message_count": 12,
"messages": [
{ "id": "msg_0", "role": "assistant", "content": "Welcome to Geneva Motors! How can I help you today?", "timestamp": "2025-02-13T16:05:00Z" },
{ "id": "msg_1", "role": "user", "content": "I want the F-150 Lariat you have listed. What's the best price you can do?", "timestamp": "2025-02-13T16:05:30Z" },
{ "id": "msg_11", "role": "user", "content": "Alright let's do this. I'm Marcus Rivera — m.rivera@email.com, 773-555-9876. When's the soonest I can come in?", "timestamp": "2025-02-13T16:25:30Z" }
],
"sentiment": "positive",
"topics": ["f150", "pricing", "trade_in", "financing", "negotiation"]
},
"events": [
{ "type": "conversation_started", "timestamp": "2025-02-13T16:05:00Z", "data": {} },
{ "type": "intent_detected", "timestamp": "2025-02-13T16:05:30Z", "data": { "type": "VEHICLE_INQUIRY" } },
{ "type": "trade_in_discussed", "timestamp": "2025-02-13T16:10:44Z", "data": { "vehicle": "2021 Honda Civic" } },
{ "type": "financing_discussed", "timestamp": "2025-02-13T16:15:22Z", "data": { "type": "finance", "term": 72 } },
{ "type": "offer_made", "timestamp": "2025-02-13T16:22:00Z", "data": { "revision": 1, "price": 52750 } },
{ "type": "intent_detected", "timestamp": "2025-02-13T16:25:30Z", "data": { "type": "READY_TO_BUY", "confidence": 0.95 } },
{ "type": "score_updated", "timestamp": "2025-02-13T16:25:30Z", "data": { "old_score": 71, "new_score": 96 } },
{ "type": "stage_changed", "timestamp": "2025-02-13T16:25:30Z", "data": { "from": "qualified", "to": "negotiation" } }
],
"ai_analysis": {
"purchase_probability": 0.91,
"recommended_actions": ["immediate_call", "prepare_deal_sheet", "schedule_delivery"],
"objections": [],
"engagement_level": "high",
"summary": "Marcus Rivera wants the F-150 Lariat immediately. Trading 2021 Civic (38K mi, $6.2K payoff). Pre-qualified Tier 1. $10K down, targeting $650/mo on 72 months. Ready to close."
}
}{
"lead": {
"id": "lead_1739460000",
"status": "contacted",
"contact": { "first_name": "David", "last_name": null, "email": null, "phone": null },
"vehicle_interests": [{
"year": 2023, "make": "BMW", "model": "X3", "trim": "xDrive30i",
"condition": "certified", "stock_number": "B23-0412"
}],
"intents": [
{ "type": "VEHICLE_INQUIRY", "confidence": 0.92, "detected_at": "2025-02-13T17:02:10Z" },
{ "type": "PRICING", "confidence": 0.90, "detected_at": "2025-02-13T17:05:44Z" },
{ "type": "OBJECTION_PRICE", "confidence": 0.88, "detected_at": "2025-02-13T17:08:22Z", "source_message_id": "msg_3" }
],
"score": 44,
"score_factors": [
{ "factor": "name_provided", "points": 8, "category": "contact" },
{ "factor": "vehicle_interest", "points": 10, "category": "intent" },
{ "factor": "PRICING_intent", "points": 8, "category": "intent" },
{ "factor": "OBJECTION_PRICE_intent", "points": 3, "category": "intent" },
{ "factor": "exploring_timeline", "points": 2, "category": "qualification" },
{ "factor": "no_contact_info", "points": -5, "category": "negative" }
]
},
"events": [
{ "type": "objection_detected", "timestamp": "2025-02-13T17:08:22Z", "data": { "type": "OBJECTION_PRICE", "context": "competitor_comparison" } }
],
"ai_analysis": {
"purchase_probability": 0.35,
"recommended_actions": ["send_comparison_sheet", "follow_up_48hr", "offer_price_match_review"],
"objections": ["OBJECTION_PRICE"],
"engagement_level": "medium",
"summary": "David interested in CPO X3 but objecting on price — claims competitor is $2K less. No email or phone captured. Recommend CPO value comparison follow-up if contact info obtained."
}
}{
"conversation": {
"id": "conv_1739462000",
"started_at": "2025-02-13T18:00:00Z",
"ended_at": null,
"message_count": 5,
"handoff": {
"requested": true,
"reason": "complaint",
"priority": "urgent",
"summary": "Customer brought vehicle in for warranty brake repair last week. Issue has recurred. Customer is frustrated and requesting to speak with a manager. Warranty claim #WR-2025-0847 is relevant. Recommend immediate escalation to service manager.",
"triggered_at": "2025-02-13T18:04:12Z"
},
"sentiment": "negative",
"topics": ["service", "warranty", "complaint"]
},
"events": [
{ "type": "conversation_started", "timestamp": "2025-02-13T18:00:00Z", "data": {} },
{ "type": "intent_detected", "timestamp": "2025-02-13T18:00:30Z", "data": { "type": "SERVICE_REQUEST", "confidence": 0.96 } },
{ "type": "handoff_triggered", "timestamp": "2025-02-13T18:04:12Z", "data": { "reason": "complaint", "priority": "urgent" } }
]
}acp (with parent_envelope_id) and events. They represent partial updates between snapshots. This specification does not define when or how frequently deltas are generated — that is an implementation decision.{
"acp": {
"version": "1.0.0",
"protocol": "acp",
"generated_at": "2025-02-13T15:35:08Z",
"envelope_id": "acp_1739456508_p3k7n2",
"parent_envelope_id": "acp_1739456200_x8k2m9"
},
"events": [
{
"type": "score_updated",
"timestamp": "2025-02-13T15:35:08Z",
"data": { "old_score": 47, "new_score": 65 }
},
{
"type": "intent_detected",
"timestamp": "2025-02-13T15:35:08Z",
"data": { "type": "FINANCING", "confidence": 0.84 }
}
]
}parent_envelope_id is non-null, the JSON Schema forbids all other top-level objects besides acp and events. Receivers encountering a delta whose parent is unknown MUST respond with ENVELOPE_CONFLICT (409).agent_type: "service_text" and SERVICE_REQUEST intents. The CRM routes these to the service department instead of the BDC.{
"acp": {
"version": "1.0.0",
"protocol": "acp",
"generated_at": "2025-02-13T19:15:30Z",
"envelope_id": "acp_1739466930_s2v8w1",
"parent_envelope_id": null
},
"source": {
"provider": "AutomotiveAI",
"agent_type": "service_text",
"channel": "sms",
"session_id": "sess_svc_q4r5s6"
},
"dealership": {
"id": "geneva_motors_001",
"name": "Geneva Motors",
"timezone": "America/Chicago"
},
"lead": {
"id": "lead_svc_1739466800",
"status": "new",
"contact": {
"first_name": "Linda",
"last_name": "Park",
"phone": "+13125558821"
},
"vehicle_interests": [],
"intents": [
{ "type": "SERVICE_REQUEST", "confidence": 0.97, "detected_at": "2025-02-13T19:12:08Z" }
],
"score": 0,
"score_factors": []
},
"transaction": {
"id": "txn_svc_1739466800",
"stage": "inquiry",
"last_updated": "2025-02-13T19:15:30Z",
"appointment": {
"type": "service",
"scheduled_at": "2025-02-17T08:30:00-06:00",
"status": "scheduled",
"assigned_to": null
}
},
"conversation": {
"id": "conv_svc_1739466800",
"started_at": "2025-02-13T19:11:00Z",
"ended_at": "2025-02-13T19:15:30Z",
"duration_seconds": 270,
"message_count": 4,
"messages": [
{ "id": "msg_0", "role": "user", "content": "Hi I need to schedule an oil change for my 2022 Camry", "timestamp": "2025-02-13T19:11:00Z" },
{ "id": "msg_1", "role": "assistant", "content": "Hi Linda! I'd be happy to help you schedule an oil change. We have availability Monday morning at 8:30 AM or Wednesday afternoon at 2:00 PM. Which works better for you?", "timestamp": "2025-02-13T19:11:06Z" },
{ "id": "msg_2", "role": "user", "content": "Monday 8:30 works. Thanks!", "timestamp": "2025-02-13T19:14:22Z" },
{ "id": "msg_3", "role": "assistant", "content": "You're all set for Monday, February 17th at 8:30 AM. We'll send you a confirmation text. See you then, Linda!", "timestamp": "2025-02-13T19:14:28Z" }
],
"sentiment": "positive",
"topics": ["oil_change", "service_appointment"]
},
"events": [
{ "type": "conversation_started", "timestamp": "2025-02-13T19:11:00Z", "data": { "channel": "sms" } },
{ "type": "intent_detected", "timestamp": "2025-02-13T19:11:00Z", "data": { "type": "SERVICE_REQUEST" } },
{ "type": "appointment_scheduled", "timestamp": "2025-02-13T19:15:30Z", "data": { "type": "service", "date": "2025-02-17T08:30:00-06:00" } },
{ "type": "conversation_ended", "timestamp": "2025-02-13T19:15:30Z", "data": { "reason": "natural_close" } }
]
}To illustrate the data density difference, here is what Example 2 (Sarah Chen / Camry) would look like as an ADF-XML submission — the legacy industry standard.
Converting the Example 2 envelope to ADF-XML discards:
<?xml version="1.0" encoding="UTF-8"?> <?adf version="1.0"?> <adf> <prospect status="new"> <requestdate>2025-02-13T15:42:30Z</requestdate> <vehicle interest="buy" status="new"> <year>2025</year> <make>Toyota</make> <model>Camry</model> <trim>XSE</trim> <stock>T25-1847</stock> </vehicle> <customer> <contact> <name part="first">Sarah</name> <name part="last">Chen</name> <email>sarah.chen@email.com</email> <phone type="voice">+14155551234</phone> </contact> </customer> <vendor> <vendorname>Geneva Motors</vendorname> </vendor> <!-- Everything else is lost. --> </prospect> </adf>
An implementation is considered ACP-compliant if it:
acp.version matches declared specification).envelope_id echo.See the full conformance profiles (Producer and Receiver) in the specification for detailed requirements.