核心概念

账户

账户是由 E.164 手机号码（+228…）标识的最终用户。

状态	含义
pending	已邀请 / 尚未完全认领
claimed	用户已通过 OTP 完成认领，可以使用应用
blocked	已退出 / 被阻止

合作伙伴通过 M2M 或服务提供方字段将账户关联到自己的组织。已关联用户会在中心中看到该合作伙伴。

合作伙伴

合作伙伴是一个组织（例如 SEED），具有：

• API 密钥
• 模板
• 渠道链（应用内 → WhatsApp → SMS）
• 可选机器人和流程
• 品牌设置（徽标和名称）

消息

合作伙伴发送给用户的消息可以是：

类型	中心行为
文本、媒体、链接、HTML	独立中心消息（列表中最新消息优先）
流程邀请	独立流程卡片
支持回复	位于用户发起的对话中

合作伙伴 API 的 POST /messages 创建的是中心消息，而不是支持聊天会话。

内容类型

content_type	说明
text	纯文本
image	图片 URL 或 Base64
document	PDF / 文件
audio	音频文件
video	视频文件
link	CTA 卡片（URL、标签和标题）
html	移动端新闻简报（HTML）
flow	交互式多步骤表单邀请
system	平台系统消息

对话

对话是支持类会话：

• 当用户发起支持请求时创建
• 客服人员通过合作伙伴中心或客服人员 API 回复
• 机器人会话可以使用 Bot · … 等主题，并在用户的对话菜单中隐藏

投递渠道

每个合作伙伴可配置有序渠道链，例如：

1. inapp：移动端 / MorisBox 客户端应用
2. whatsapp
3. sms

OTP 和关键消息可以强制使用部分渠道。

有关客户端界面、合作伙伴工具和渠道行为的完整目录，请参阅平台。

幂等性

发送时传递 idempotency_key，可防止重试造成重复消息：

{ "idempotency_key": "partner-order-98765" }

同一合作伙伴和密钥会返回原始消息。