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

节点配置

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

需创建一个自定义钉钉机器人,并复制其Webhook地址。详细内容请参见创建钉钉机器人

配置方法 选择以下方法对发送内容进行格式化处理:
  • 使用模板:
    • 设备上下线通知:仅支持 上报类型选择了 上下线监听的设备触发节点作为数据源。
    • 设备属性告警:系统根据选择的数据源,自动生成相关的告警推送信息,支持编辑修改。目前,仅支持设备触发和产品节点作为数据源。
    • 固定文案:需输入固定的消息内容。可用于与设备物模型无关信息,只做消息提醒的场景。
  • 自定义:系统提供了text、link、整体跳转ActionCard、独立跳转ActionCard、FeedCard五种自定义消息类型及对应的内容配置模板,您只需修改模板中配置项对应值。

    如果您需要推送某节点的一个变量信息,可通过部署、调试查看节点日志中输出内容的JSON格式,定位变量位置。

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

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

    示例:

    使用{{query.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. 勾选我已阅读并同意《自定义机器人服务及免责条款》,并单击完成

机器人创建成功后,单击复制,获取webhook地址。

机器人

节点输出

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

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

机器人发送消息频率限制

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

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