ACP Envelope Examples

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.

IP Boundary: These examples show the output format of ACP envelopes. The intent confidence values, score calculations, and handoff decisions shown are illustrative. They do not represent any specific producer's algorithms.

1. Casual Browser

👀
Customer is just looking — no contact info, no specific vehicle, no timeline
A visitor lands on the dealership website, asks a general question about SUV inventory, gets a helpful response, and leaves. This is the lowest-signal interaction — but ACP still captures intent, engagement, and the full conversation for future attribution.
Score: 7
Stage: inquiry
3 messages
1 intent
casual-browser.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" } }
  ]
}

2. Qualified Lead — Test Drive Interest

🚗
Customer identifies a specific vehicle, provides contact info, and asks to schedule a test drive
Sarah Chen arrives from a Google Ads campaign, asks about the 2025 Camry XSE, shares her email and phone number, and asks to come in for a test drive this Saturday. This is a high-quality lead with clear purchase intent.
Score: 78
Stage: qualified
8 messages
3 intents
qualified-lead.json
{
  "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."
  }
}

3. Ready to Buy — Full Qualification

🔥
Customer has trade-in, financing questions, specific vehicle, and wants to move forward today
Marcus Rivera is trading in his 2021 Civic, wants the F-150 Lariat, has pre-approved financing, and says "let's do this." This is the highest-value envelope — every data field populated, maximum score, ready for immediate follow-up.
Score: 96
Stage: negotiation
12 messages
5 intents
ready-to-buy.json
{
  "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."
  }
}

4. Price Objection

⚠️
Customer interested but balking at price — mentions a competitor offer
David Kim likes the BMW X3 CPO but says he saw a similar one at a competing dealer for less. The AI handles the objection by differentiating on CPO warranty and features. Customer remains undecided. ACP captures the objection type so the follow-up team knows exactly what to address.
Score: 44
Stage: inquiry
6 messages
3 intents
price-objection.json (abbreviated — lead + intents + ai_analysis)
{
  "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."
  }
}

5. Human Handoff

🤝
Customer becomes frustrated — AI escalates to a human agent
A customer is upset about a service issue and the AI determines a human should take over. The handoff object provides the human agent with a full context summary, priority level, and reason — enabling a seamless transition without the customer repeating themselves.
Score: 32
Stage: inquiry
5 messages
Handoff: urgent
handoff.json (abbreviated — conversation + handoff)
{
  "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" } }
  ]
}

6. Delta Envelope

⚡
A lightweight partial update referencing a parent snapshot
Delta envelopes contain only 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.
Type: delta
2 events
delta-envelope.json
{
  "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 }
    }
  ]
}
Schema enforcement: When 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).

7. Service Request (Non-Sales)

🔧
Customer contacts the dealership about an oil change appointment — not a sales lead
ACP isn't just for sales. Service interactions generate envelopes too, using agent_type: "service_text" and SERVICE_REQUEST intents. The CRM routes these to the service department instead of the BDC.
Score: 0
Stage: inquiry
4 messages
1 intent
service-request.json (abbreviated)
{
  "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" } }
  ]
}

ACP vs ADF-XML — Side-by-Side

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.

ACP Envelope
127
data fields captured
ADF-XML Equivalent
14
data fields captured

What ADF-XML Loses

Converting the Example 2 envelope to ADF-XML discards:

✗ 3 detected intents with confidence
✗ Lead score (78) and 7 score factors
✗ Full 8-message conversation transcript
✗ 12 behavioral events with timestamps
✗ AI analysis and purchase probability
✗ UTM attribution and device context
✗ Appointment scheduling data
✗ Session linking and sentiment
same lead as ADF-XMLXML
<?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>
This is why ACP exists. The same customer interaction that produces 127 structured data fields in ACP gets compressed to 14 flat XML fields in ADF-XML. Every intent, every score factor, every behavioral signal, and the entire conversation transcript — gone. CRMs receiving ADF-XML are making decisions with 89% less data.

ACP Conformance Checklist

An implementation is considered ACP-compliant if it:

  1. Generates envelopes conforming to the published JSON Schema.
  2. Includes all required top-level objects in snapshot envelopes.
  3. Preserves envelope version integrity (acp.version matches declared specification).
  4. Supports snapshot envelopes (delta support is optional but recommended).
  5. Validates inbound envelopes against the schema on receipt.
  6. Returns acknowledgment responses for accepted payloads, including envelope_id echo.

See the full conformance profiles (Producer and Receiver) in the specification for detailed requirements.