消息推送对接

对接钉钉「自定义机器人」,与企业微信「消息推送」,将系统消息实时推送到企业群聊

系统支持通过 Webhook 将巡检任务提醒、维修工单、设备报警等消息实时推送到钉钉或企业微信群聊。

群聊机器人由企业方在钉钉 / 企业微信客户端内自行创建。以下先说明如何在两个平台完成配置,再介绍如何与本系统对接。

钉钉:创建自定义机器人

在钉钉群聊中添加"自定义机器人",即可获得一个用于向该群推送消息的 Webhook 地址。请按官方文档完成配置:

官方文档 · 创建自定义机器人:https://open.dingtalk.com/document/dingstart/custom-bot-creation-and-installation

创建步骤概览(详细操作以官方文档为准):

  1. 在钉钉客户端进入需要接收消息的群聊,点击右上角"群设置"。
  2. 依次点击"机器人" -> "添加机器人",选择"自定义机器人"并添加。
  3. 配置机器人头像、名称与安全设置,勾选《自定义机器人服务及免责条款》后完成。

说明:

  • 自定义机器人仅支持在群聊中发送消息,不支持发送单聊消息。
  • 创建完成后,可在机器人详情中查看 Webhook 地址,形如 https://oapi.dingtalk.com/robot/send?access_token=xxxxxx

官方文档 · 自定义机器人安全设置:https://open.dingtalk.com/document/dingstart/customize-robot-security-settings

钉钉提供三种安全设置,请选择自定义关键词:

  • 自定义关键词:消息中必须包含至少一个设定关键词才能发送成功,最多可设置 10 个关键词。可以写「消息推送」的标题等。

企业微信:配置「消息推送」

在企业微信内部群聊中添加"消息推送"(原"群机器人",v4.1.41 起更名),可获得推送用的 Webhook 地址。请按官方文档完成配置:

官方文档 · 如何设置「消息推送」:https://open.work.weixin.qq.com/help2/pc/14931

配置要点(详细操作以官方文档为准):

  1. 电脑端或手机端进入内部群聊,点击右上角"..." -> "消息推送" -> "添加"。
  2. 添加完成后,点击对应"消息推送"的详情即可查看 Webhook 地址。
  3. 每条"消息推送"每分钟最多发送 20 条消息。

说明:

  • 目前仅内部群聊支持添加"消息推送",外部群暂不支持。
  • 若群聊开启了"全员禁言",通过"消息推送"发送的消息将无法送达。

与本系统对接

机器人创建完成后,按以下步骤与本系统对接:

  1. 在钉钉或企业微信中按上文指引完成机器人(消息推送)的创建,并复制机器人的 Webhook 地址
  2. 登录系统,在“基础设置”-“消息推送”相关配置中新增钉钉或企业微信渠道,填入“推送地址”字段。
  3. 保存后,系统产生的巡检任务、维修工单、设备报警等消息即会推送到对应群聊。

注意事项:

  • Webhook 地址拥有向该群发送消息的权限,请妥善保管,切勿泄露到公开渠道。
  • 群聊机器人属企业自身资源,由企业自行管理;本系统仅负责向配置的 Webhook 地址推送消息。