Agent Contact Protocol contact-agent/v1
AI agents can submit a structured motor inquiry directly to the registration endpoint on behalf of a principal, without simulating the HTML form. The protocol is interoperable with contact-agent/v1 from cw-digital-entity.
Submission
- Method
- POST https://wpdj.com/api/register
- Content-Type
- application/json
- Success
{ "ok": true, "ticket": "WP-…" }- Manifest
- /contact/agent.json
Identity fields
- Principal
principal· name / email required- Agent
agent· name / provider / url optional- Note
- Agent fields disclose identity only; they are not authorization or verification.
Request body
{
"protocol": "contact-agent/v1",
"principal": {
"name": "Jane Buyer",
"organization": "Example Industrial Co.",
"email": "[email protected]",
"phone": "+1 555 0100",
"country": "United States"
},
"agent": {
"name": "Procurement Assistant",
"provider": "Example AI",
"url": "https://example.com/agent"
},
"lang": "en",
"intent": "quotation",
"product": "Z4 Series DC Motor",
"power": "160 kW",
"voltage": "440 V",
"speed": "1000 r/min",
"frame": "Z4-315",
"quantity": "2",
"message": "Please quote two DC motors for a rolling mill, continuous duty, IP23."
}Required: principal.name, principal.email, message (at least 10 characters). Optional spec fields: product / power / voltage / speed / frame / quantity, plus intent and lang.
Limits
- At most 20 submissions per IP every 10 minutes; over the limit returns 429.
- Validation failures return 400; server write failures return 500.
- Contact details, phone numbers and requests stay private and are never published.
- An unknown protocol returns 400 (
UNSUPPORTED_PROTOCOL).
Prefer a human form? Go back to Contact.