消息渠道

功能概述

消息渠道位于 能力扩展 → 消息渠道，保存投递配置；消息模板保存业务正文与变量。先配置渠道，再建立模板，最后通过试发送检查投递。

前置条件

准备对应渠道的凭证与接收对象，例如群机器人 Webhook、SMTP 账号或云短信 AccessKey。短信渠道还需在云厂商完成签名与模板审核。

1. 创建渠道

进入 能力扩展 → 消息渠道，点击 新增，填写名称并选择类型。

类型	主要配置
企业微信	群机器人 Webhook
钉钉	Webhook、机器人签名
邮件	发件地址、SMTP 主机与端口、账号、密码、默认收件地址
阿里云短信	AccessKey、SecretKey、地域、短信签名
腾讯云短信	AppId、AppKey、短信签名

企业微信渠道配置：填写名称、类型与群机器人 Webhook。

示例渠道名称为 DOCS_咨询通知，Webhook 使用占位地址 https://notify.example.com/webhook，配置时替换为群机器人提供的地址。保存后，渠道出现在列表中。

2. 建立消息模板

在渠道卡片点击 消息模板 → 新增。

字段	示例配置
名称	DOCS_咨询受理通知
编码	DOCS_INTAKE
内容	咨询「${topic}」已受理，工单编号：${ticketNo}。请在服务时间内补齐资料。

模板正文使用变量占位符。

普通渠道正文用 ${变量名} 插值。短信模板的内容填写云端模板编号，正文由云厂商模板渲染。

3. 试发送

点击模板行的 试发送，变量填写 JSON 对象：

{
  "topic": "知识库召回配置",
  "ticketNo": "DOCS-20261102-001"
}

试发送：填写模板编码与变量 JSON。

邮件可用 subject 指定主题；短信需带 phones，多个号码以逗号分隔。点击 发送 前确认渠道凭证、模板与接收对象，发送成功后界面提示“已发送”。

4. 在流程中使用

在流程的推送消息节点选择消息模板，将变量映射到业务输入。运行后检查节点状态和渠道返回信息，再由接收端核对内容与变量是否完整。

常见问题

现象	处理方法
模板编码不匹配	核对流程节点或试发送中使用的模板编码
变量未替换	JSON 变量名须与模板中的占位符一致
投递失败	检查渠道凭证是否有效，以及渠道返回的错误信息
短信未发出	确认短信签名与云端模板已通过云厂商审核