# 统一消息动态操作课程

真实操作关键帧动态演示 · 语音同步标注（非连续录屏）

画面来源为真实产品操作关键帧，按配音剪辑；指针、边框与路径图为后期教学标注。

## 先认识场景，再开始操作

配置一个业务通知场景，区分消息任务、送达与已读。

检查要点：准备测试账号，确认当前版本与菜单权限。

### 配音讲解

你好，欢迎学习红迅平台的统一消息。这节课，我们一起来完成这样一个目标：配置一个业务通知场景，区分消息任务、送达与已读。课程适合消息管理员和集成开发。你可以先看一遍，再打开测试环境，跟着五个步骤练习。画面来自实际产品。因为版本和权限可能不同，如果你的菜单位置不一样，可以先查阅页面下方的操作讲义。

## 核对消息通道

进入消息中心查看通道与配置，确认站内或已接入的供应商通道，检查凭据和接收人标识。

检查要点：通道目录存在不代表供应商连接可用，真实发送使用测试账号。

### 配音讲解

我们先做第一步，核对消息通道。进入消息中心查看通道与配置，确认站内或已接入的供应商通道，检查凭据和接收人标识。这里要留意的是：通道目录存在不代表供应商连接可用，真实发送使用测试账号。

## 编写并预览模板

选择场景，编辑标题、摘要和正文，设置变量并预览采购审批通知。

检查要点：缺少变量时应明确失败或提示，不使用含个人信息的真实样本。

### 配音讲解

接下来，进入第二步，编写并预览模板。选择场景，编辑标题、摘要和正文，设置变量并预览采购审批通知。继续之前，请确认：缺少变量时应明确失败或提示，不使用含个人信息的真实样本。

## 配置接收人与场景

绑定业务事件、接收人规则、通道策略和模板，先预览接收人范围。

检查要点：检查租户、组织和角色边界，避免通知到无关人员。

### 配音讲解

然后来看第三步，配置接收人与场景。绑定业务事件、接收人规则、通道策略和模板，先预览接收人范围。这一步的关键是：检查租户、组织和角色边界，避免通知到无关人员。

## 触发并查看投递

使用测试业务事件触发通知，查看任务、分发记录和站内收件箱，核对业务关联 ID。

检查要点：任务提交、通道送达、已读分别记录，消息状态不替代审批结果。

### 配音讲解

现在进入第四步，触发并查看投递。使用测试业务事件触发通知，查看任务、分发记录和站内收件箱，核对业务关联 ID。完成以后，我们还要检查：任务提交、通道送达、已读分别记录，消息状态不替代审批结果。

## 检查回调与补偿

制造受控失败，核对错误原因、回调认证与幂等，再通过允许入口重试或补偿。

检查要点：对结果未知的发送先对账，不能不断重试导致重复通知。

### 配音讲解

最后，完成第五步，检查回调与补偿。制造受控失败，核对错误原因、回调认证与幂等，再通过允许入口重试或补偿。到这里，别忘了核对：对结果未知的发送先对账，不能不断重试导致重复通知。

## 回顾操作路径，检查实际结果

完成五步练习，再核对真实业务结果；用无权限与失败场景检查边界。

检查要点：讲义、字幕与技术文档可在课程页面继续查阅。

### 配音讲解

我们再回顾一下，统一消息的五个步骤是：核对消息通道、编写并预览模板、配置接收人与场景、触发并查看投递、检查回调与补偿。练习时，建议先跑通一条正常路径，再检查无权限和失败时的提示。如果操作会写入数据、发布内容或发送通知，请先核对目标，再执行。页面下方有文字讲义、字幕和对应技术文档。遇到不熟悉的地方，可以点击章节，回到那一步再听一遍。这节课就到这里，我们下节课见。

[技术白皮书](/docs/cube/whitepaper#module-messages) · [开发手册](/docs/cube/development)
