W17 · 联系
告诉我们你想解决的真实场景。
家庭体验、机构 Pilot、Partner/API、媒体与研究咨询将进入不同处理队列。请不要在公开咨询表单提交儿童敏感信息。
选择咨询入口
机构 Pilot
Partner / API
媒体与研究
支持
W17-S02 · Type selector
先选择咨询类型。
W17-S03 · Form
咨询内容
W17-S04 · Privacy
个人信息的处理
仅为处理此次咨询使用所提交的信息。营销同意不会与本次咨询捆绑。
查看法律文件预览W17-S05 · Response
咨询已受理
“感谢你的咨询。受理编号：{reference_no}。我们已向 {masked_email} 发送自动确认邮件，请保存该编号，后续联系时可用于确认记录。”
成功状态样例：仅 ACCEPTED 后显示
受理编号 · 提交时间 · 邮件目标（脱敏）
原型不发送确认邮件。
W17-S06 · Inquiry Number / Acceptance Contract
Inquiry Number / Acceptance Contract
API：POST /api/v1/inquiries。请求必须带 Idempotency-Key；服务端先校验 -> 防滥用 -> 持久化 -> 生成/确认
成功响应最小字段：reference_no, accepted_at, status="ACCEPTED"。严禁把姓名、邮箱、message 放到 URL
重复提交：同一 Idempotency-Key + payload fingerprint 返回原 reference_no，不创建第二条咨询记录。
失败：持久化失败/校验失败/限流时不得展示成功页，不得伪造咨询编号。
实现约束注释：不作为公共营销页面内容。
W17-S07 · 自动回复邮件
自动回复邮件
邮件主题（zh-Hans）：“【MTFDX Kids / Family】已收到您的咨询｜{reference_no}”
邮件正文母文案：“{name} 您好，感谢您联系 MTFDX Kids / Family。我们已收到您的咨询。受理编号：
四语：ja-JP / en / zh-Hans / zh-Hant 使用同一邮件模板键；语言默认采用提交时 locale。
邮件失败：auto_reply_status=FAILED，记录 provider_error_code（不保存无必要的原始报文），进入有限重
内部通知：同时向配置的咨询处理队列/邮箱发送新咨询通知，包含 reference_no、类型、地区、联系人与必要正
实现约束注释：不作为公共营销页面内容。
W17-S08 · 管理后台记录与处理流程
管理后台记录与处理流程
标识：inquiry_id、reference_no、submitted_at / accepted_at、region、locale。
客户字段：inquiry_type、full_name、organization_name、role_title、email、phone、message。
Consent：privacy_consent、privacy_policy_version、consented_at；可选 marketing_consent 独立存储。
Attribution：source_site、source_route、source_entity、utm_source / medium / campaign / content（如存
处理：queue、status、owner_id、priority、tags、internal_notes、last_contact_at、resolved_at、
Delivery：auto_reply_status、internal_notification_status、provider_message_id、retry_count、
防滥用/审计：honeypot_result、rate_limit_result、server_validation_result、created_by="PUBLIC_FORM"、
默认状态机：NEW -> TRIAGED -> IN_PROGRESS -> WAITING_CUSTOMER -> RESOLVED -> CLOSED；旁路状态
后台列表必须支持按受理编号、状态、类型、地区、日期、负责人搜索/筛选；详情页显示完整记录、Consent 版
实现约束注释：不作为公共营销页面内容。
W17-S09 · 防滥用、错误与可观测性
防滥用、错误与可观测性
默认不强制 CAPTCHA；当风险规则触发时可 step-up challenge，避免给普通家长/机构用户增加不必要摩擦。
限流键可使用短期 keyed IP hash + email hash + session/device signal 的组合；不得持久化 raw IP。
错误文案：校验失败“请确认标记的项目后再提交。”；限流“提交次数较多，请稍后再试。”；服务不可用“目
Analytics 只记录 contact_submit_attempt / contact_validation_error / contact_server_accepted /
实现约束注释：不作为公共营销页面内容。
W17-S10 · 开发验收场景
开发验收场景
正常提交：生成唯一 reference_no；页面显示；自动确认邮件包含相同编号；后台可用相同编号查到同一记录。
未勾隐私同意：客户端提示 + 服务端 4xx；不创建咨询记录、不发送邮件。
重复点击/网络重试：同一 Idempotency-Key 不产生重复咨询或重复编号。
自动回复邮件失败：咨询仍为 ACCEPTED；后台显示失败并可重试；不会把客户带回失败页。
数据库/持久化失败：前端不得显示“已受理”，不得生成可见成功编号。
Honeypot/限流命中：不进入正常处理队列；不泄露风控规则细节。
四语：成功页、隐私同意、验证错误、自动回复邮件均有 ja/en/zh-Hans/zh-Hant 资源并完成长度 QA。
隐私链接：/legal/privacy 与 /privacy-center 可从表单打开且不清空已填写内容。
实现约束注释：不作为公共营销页面内容。
MTFDX Kids / Family · R7 · 普通表单错误、过期与同步异常使用琥珀。已确认紧急才使用红色。