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

节点配置

钉钉机器人
配置项 说明
节点名称 设置节点名称。支持中文汉字、英文字母、数字和下划线(_),长度不超过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. 单击添加添加
  7. 输入机器人名称,同时可以为机器人设置机器人头像。设置
  8. 完成安全设置(至少选择一种)。有关安全配置详细内容,请参见机器人开发的安全配置节点。安全配置
  9. 勾选我已阅读并同意《自定义机器人服务及免责条款》,并单击完成

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

机器人

节点输出

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

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

机器人发送消息频率限制

每个机器人每分钟最多发送20条。如果超过20条,会限流10分钟。

说明 出于系统保护的考虑,钉钉对接口的调用做了频率限制。更多详细内容请参见主动调用的频率限制