集成与开放能力支持自定义消息类型（如机器人发送待办卡片）吗？
2026-06-08
·
admin
美洽具备开放的集成能力，允许通过SDK与开放API定义并推送自定义消息类型（例如机器人发送的待办卡片）。开发者可制定消息结构、行为按钮与元数据，在支持的客户端中以卡片或富互动形式展现；对外部渠道需做兼容降级处理，必要时用链接或纯文本作为回退，确保在所有渠道能稳定触达交互。
先把概念说清楚：什么是“自定义消息类型”
当你说“机器人发送待办卡片”时，本质上是两件事：
- 消息结构：除了普通文本外，消息里包含字段（标题、摘要、时间、操作按钮等）；
- 渲染能力：客户端（网页版、移动SDK、公众号等）能够把这个字段集渲染成卡片、按钮、表单或富交互控件。
把它说得更简单点，就是：服务器发来一段结构化数据，客户端把它做成好用的交互界面。如果任一端不配合，就只能降级成一段文字或一个链接。
美洽在这件事上能做到什么（总体能力）
美洽作为一个面向企业的客服平台，本身提供了比较完善的开放能力：
- 提供客户端SDK（Web、iOS、Android）用于接收并渲染富消息；
- 提供开放API/机器人接口，允许外部系统推送自定义消息或模板消息到会话；
- 在控制台通常可以管理模板、权限与消息策略；
- 支持将消息与工单、会话上下文、用户标签绑定，实现流程化的待办/任务跟踪。
也就是说，想要机器人发送待办卡片，这套体系是具备的——关键在于实现细节、SDK版本和接入渠道的差异。
如何一步步实现（费曼式分解，越简单越明白）
第一步：设计消息结构（把内容和交互都想清楚）
先把你要的卡片拆成字段：标题、正文、截止时间、优先级、操作（完成/延期/查看详情）、关联工单ID等。把这些字段标准化成JSON Schema，便于前后端统一。
第二步：确认目标客户端的能力
- Web/移动SDK：通常能完整渲染卡片与按钮；
- 微信公众号/小程序：对富交互支持有限，需要把按钮映射成跳转或模板消息；
- 短信/邮件：只能降级为纯文本或带链接；
这一步非常重要：不要期望所有渠道都“长得一样”。
第三步：在美洽侧准备（控制台或模板）
- 在控制台创建或登记自定义消息模板（如果平台支持模板管理）；
- 配置权限、可见性与默认回退策略；
- 记录模板ID、版本号，便于调用。
- 认证（API Key / Token）；
- POST 消息体（包含目标会话/用户、模板ID、字段）；
- 检查返回结果，判断是否成功送达或排队。
- 前端事件（本地标记完成）；
- 回调到服务器（POST动作信息，更新工单）；
- 跳转到业务页（带上参数）。
并非每个企业都必须在控制台做这步，但多数场景下有个“模板管理”的地方能让你更可控。
第四步：用机器人/后端API发送消息
从业务系统发出HTTP请求，把设计好的JSON送到美洽的发送接口。基本流程：
第五步：客户端渲染与交互
客户端SDK收到消息后，会根据消息类型选择渲染器：卡片渲染器、按钮回调等。按钮可以触发：
示例：一个典型的待办卡片消息体（示意）
下面这个JSON示意帮助你快速把抽象变成可实现的格式（以实际文档为准）：
{
"to_user_id": "U123456",
"message_type": "custom_card",
"template_id": "todo_v1",
"payload": {
"title": "签署合同",
"summary": "客户：张三，需要在3天内签署合同",
"due_time": "2026-05-12T18:00:00+08:00",
"priority": "high",
"actions": [
{"type":"postback", "label":"完成", "value":{"action":"complete","id":"T987"}},
{"type":"url", "label":"查看详情", "url":"https://example.com/tasks/T987"}
],
"meta": {"related_order":"O5555"}
}
}
渠道能力对照表（帮你判断该怎么降级）
| 渠道 | 富卡片渲染 | 动作按钮回调 | 降级建议 |
| Web SDK | 支持 | 支持 | 无 |
| iOS/Android SDK | 支持 | 支持 | 检查SDK版本 |
| 微信公众号 | 部分支持 | 受限（多为跳转） | 使用跳转链接或模板消息 |
| 小程序 | 有限 | 有限 | 转为小程序内页面或订阅消息 |
| 短信/邮件 | 不支持 | 不支持 | 纯文本+跳转链接 |
常见细节与陷阱（实践中最容易踩的坑）
- SDK版本不一致：老版本SDK可能不识别新的消息type，先升级或做兼容代码；
- 按钮回调安全：postback要做签名或Token校验，防止伪造操作；
- 渠道限流与退信：第三方渠道（如短信）有发送限制，做好重试与用户告知；
- 用户体验：不要用过多按钮或复杂表单，待办卡片的核心是“能快速完成一件小事”；
- 审计与可追溯：重要操作（完成、拒绝）需写入工单或日志以便追踪。
测试与上线建议
- 先在沙盒环境做端到端测试（发送、渲染、回调）；
- 覆盖不同客户端与渠道，验证降级路径是否清晰；
- 限流与CDN考量：大量推送卡片要分批、节奏化发送，防止被平台限流；
- 监控关键指标：送达率、按钮点击率、操作成功率、错误码统计。
权限、合规与安全要点
发送机器人消息通常涉及：
- 鉴权（API Key、OAuth或签名）；
- 消息审核与敏感词过滤；
- 个人信息保护（敏感字段掩码、最小化存储）；
- 日志保存策略与权限控制，确保只有有权人员能查看交互记录。
什么时候不适合用“卡片式待办”
并非所有场景都需要卡片式消息：
- 如果只是通知类内容，纯文本或推送即可；
- 复杂表单或大量字段应在业务页处理，而非卡片；
- 当渠道无法交互（如短信）时，卡片反而带来误导，优先选择降级方案。
小结一下（但不做正式总结，就像边写边想）
总体来看，美洽是支持通过开放API/SDK发送自定义消息并渲染成卡片类交互的，关键点在于设计好消息结构、确认目标客户端能力并实现合理的回退策略。注意权限、安全和监控细节，就能把机器人推送的待办卡片做得既可靠又好用。好，想到这些先写到这里，后面再慢慢把实际接入示例和控制台截图补上吧。