跳到主要内容

消息推送配置 — 用户操作手册

功能概述​

消息推送配置用于把系统里的重要提醒自动发到企业微信、钉钉或飞书群里。配置完成后，订单变化、库存预警等消息会自动同步到指定群聊，方便团队及时处理。

前置条件
  • 已登录品牌管理后台
  • 已创建目标群聊（企业微信/钉钉/飞书）并拿到该群的消息地址
  • 具备系统设置权限

一、页面总览​

页面分为两个主要区域：

  1. 消息接收设置：填写消息要发到哪个平台、哪个群
  2. 消息内容设置：选择哪些提醒要发送，以及消息里显示哪些内容

二、配置消息接收设置​

Step 1：填写端点名称​

  1. 在「端点名称」输入框中填写一个便于识别的名称
  2. 例如：企业微信-运营通知、钉钉-库存预警
提示

如果不填写名称，系统会自动生成默认名称，格式为「{平台名称}通知端点」。

Step 2：选择推送平台​

  1. 点击「推送平台」下拉框
  2. 选择您要使用的平台类型：
    • 企业微信：推送到企业微信群聊机器人
    • 钉钉：推送到钉钉群聊机器人
    • 飞书：推送到飞书机器人助手
注意

「自定义」平台类型暂未开放，敬请期待。

Step 3：填写群消息地址​

  1. 在「Webhook地址」输入框中粘贴从群聊机器人获取的地址
  2. 点击输入框右侧的「帮助」按钮可查看各平台获取方式
说明
  • 这里填写的是群机器人提供的消息地址。
  • 如果您不确定复制的是哪一项，建议让负责企业微信、钉钉或飞书配置的同事协助确认。

常见格式示例如下：

  • 企业微信：https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=xxxxxx
  • 钉钉：https://oapi.dingtalk.com/robot/send?access_token=xxxxxx
  • 飞书：飞书机器人助手提供的 Webhook URL

Step 4：配置加签密钥（可选）​

  1. 如果您的群机器人创建时要求填写安全密钥，请把对应密钥填到这里
  2. 如果机器人没有要求安全密钥，这一项可以留空

Step 5：保存端点配置​

  1. 确认至少已启用一个推送事件（见下文「三、管理推送事件」）
  2. 点击「保存配置」按钮
  3. 系统提示「端点配置已保存」即表示配置成功
注意

保存端点前必须至少启用一个推送事件，否则无法保存。

三、管理提醒内容​

Step 1：查看事件列表​

在「推送事件模板」区域，您可以看到系统支持的提醒类型，包括：

  • 提醒名称和用途说明
  • 当前是否开启
  • 消息里会显示哪些信息

Step 2：开启/关闭事件推送​

  1. 找到需要配置的事件行
  2. 点击「状态」列的开关按钮
  3. 开关显示「开启」表示该事件会触发推送
  4. 开关显示「关闭」表示该事件不会推送
注意

如果所有提醒都关闭，系统将无法保存该消息接收设置。请至少保留一个开启的提醒。

Step 3：配置消息内容​

  1. 点击事件行右侧的「字段配置」按钮
  2. 在弹出的对话框中设置消息内容

3.1 设置消息标题和说明​

  • 标题：设置推送消息的标题文案
  • 开头：设置消息正文前的引导文案
  • 结尾：设置消息正文后的结束文案
提示

标题、开头、结尾均为可选配置，如不填写则使用系统默认值。

3.2 选择消息中显示哪些信息​

在「字段配置」表格中，您可以：

  • 显示/隐藏内容项：通过开关控制这项信息是否在消息里显示
  • 调整顺序：通过「顺序」列设置显示先后（数字越小越靠前）
说明
  • 必填字段：这类内容是系统固定显示的，不能关闭
  • 预留字段：这类内容当前不一定有值，可按需要决定是否显示
  • 跳转链接：部分提醒支持点击后直接进入对应页面

3.3 预览消息效果​

在对话框底部的「模板预览」区域，您可以实时查看最终会发到群里的消息样式。

3.4 保存消息内容配置​

  1. 配置完成后，点击「保存」按钮
  2. 系统提示「字段配置已更新」即表示保存成功
  3. 如需恢复默认配置，可点击「恢复默认」按钮

四、测试推送​

Step 1：检查测试条件​

测试推送前，请确保：

  • 已保存 Webhook 端点配置
  • 目标事件已开启推送

Step 2：执行测试​

  1. 在目标事件行点击「测试推送」按钮
  2. 系统会向已配置的群聊发送一条测试消息
  3. 根据测试结果，系统会给出相应提示：
测试结果说明
  • 「测试推送已发送，请检查群聊」：测试成功，请前往群聊查看测试消息
  • 「测试推送已触发，成功 X，失败 Y」：部分群聊发送成功，部分失败，请检查对应配置
  • 「未发现可用的推送端点，请检查订阅事件」：还没有可用的消息接收设置，或提醒未开启

五、获取群消息地址指南​

企业微信机器人配置​

  1. 在企业微信中创建群聊
  2. 点击群聊右上角 → 群设置 → 机器人
  3. 点击「添加机器人」，选择「自定义机器人」
  4. 设置机器人名称和头像
  5. 复制生成的消息地址

钉钉机器人配置​

  1. 在钉钉电脑版中创建群聊
  2. 点击群聊右上角 → 群设置 → 机器人
  3. 点击「添加机器人」，选择「自定义」-添加
  4. 安全设置选择「加签」，保存密钥填写到加签密钥
  5. 复制生成的消息地址

飞书机器人助手配置​

  1. 打开飞书机器人助手，点击「新建机器人应用」
  2. 配置应用名称、描述和图标
  3. 在流程设计中点击「创建流程」
  4. 选择「Webhook触发」作为触发器
  5. 复制页面上提供的消息地址
  6. 按页面提示完成机器人流程配置
  7. 添加「通过官方机器人发消息」节点完成配置
说明

飞书这里使用的是飞书机器人助手提供的消息地址，不是普通群机器人地址。配置完成后可用它接收系统提醒。

常见问题​

问题原因与解决方案
保存配置时提示「请至少启用一个推送事件」您需要先在「推送事件模板」区域开启至少一个事件的推送开关，然后才能保存端点配置。
保存配置时提示「请输入Webhook地址」还没有填写群消息地址，请回到群机器人设置页面重新复制后粘贴。
测试推送提示「未发现可用的推送端点」请检查：1）消息接收设置是否已保存；2）该提醒是否已开启；3）群消息地址是否填写正确。
测试推送提示「成功 X，失败 Y」说明部分群聊发送成功、部分失败。请检查失败的那几个群消息地址是否正确，网络是否正常。
钉钉收不到消息请检查：1）群消息地址是否正确；2）是否需要填写安全密钥；3）机器人是否被限制发言。
字段配置中的「预留」字段是什么意思这是系统预留的信息项，当前不一定有内容，您可以按需要决定是否显示。
如何恢复默认的字段配置在字段配置对话框中点击「恢复默认」按钮，系统会恢复默认的消息标题、说明和显示内容。