钉钉机器人节点可以将消息推送至钉钉群中。可以应用在设备消息推送、监控报警、信息公示等多种场景,将设备告警信息、设备属性信息、业务逻辑处理结果等,以定时触发或设备触发等方式推送到钉钉群中。目前仅支持信息推送,不支持返回消息处理。

节点配置

配置项 说明
节点名称 设置节点名称。支持中文汉字、英文字母、数字和下划线(_),长度不超过30个字符。
Webhook 钉钉群机器人的Webhook地址。

需在钉钉群对话窗口,单击...设置按钮,然后选择群机器人,创建一个自定义钉钉机器人,并复制其Webhook地址。

创建钉钉机器人详细步骤 ,请参见下一章节:创建钉钉机器人。
配置方法 可选择以下方法对发送内容进行格式化处理:
  • 使用模板。目前,支持以下两种模板:
    • 设备告警:系统会自动根据选择的数据源,自动生成相关的告警推送信息,您也可以对模板进行编辑修改。目前,仅支持设备触发节点和产品节点作为设备告警的数据源。
    • 固定文案:需输入固定的消息内容。适合与设备物模型无关信息,只做消息提醒的场景。
  • 自定义:可自定义推送内容为固定文本或前置节点的输出内容中的变量,或变量与固定文本结合起来,形成有业务价值的消息。

    以text消息类型为例。如果需要钉钉机器人往群中动态推送一个变量,首先需要确定变量所在的节点。如果您不了解数据源节点输出内容的JSON格式,您可以先部署、启动、并用虚拟设备调试服务,便可获得节点日志。从节点日志中,查看输出内容的JSON格式,由此定位变量位置。

    IoT Studio内置了如下全局变量:

    • 来自上个节点的输出数据:payload。
    • 来自服务输入节点的数据:query。
    • 来自指定节点的输出数据:node.节点ID。

    示例:

    使用{{payload.props.PM10.value}},表示上一个节点props(属性)对象中属性PM10的值。

    使用{{query.deviceContext.deviceName}},表示第一个节点的输出内容中deviceContext对象的deviceName变量。

    {
      "msgtype": "text", 
      "text": {
        "content": "空气质量站点{{query.deviceContext.deviceName}}上报PM10浓度,浓度为{{query.props.PM10.value}} ug/m3,空气质量优。"
     }, 
          "isAtAll": false
    }


创建钉钉机器人

  1. 打开钉钉群会话窗口,单击右上角群设置按钮...

  2. 群设置中,选择群机器人

  3. 单击添加机器人按钮+

  4. 选择要添加的机器人为自定义

  5. 单击添加

  6. 输入机器人名称,单击完成

机器人创建成功后,您可以单击复制,复制其webhook地址;或单击设置说明,查看机器人调试等设置说明文档。



节点输出

调用成功的输出数据为钉钉API返回的数据,如下示例。具体钉钉API返回数据,请参见钉钉开发文档

 {
    "errmsg": "ok",
    "errcode": 0
}