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

节点配置

在业务逻辑编辑页面的节点中,选择对应功能节点配置业务流,钉钉机器人配置如下。

钉钉机器人
配置项 说明
节点名称 设置节点名称。支持中文汉字、英文字母、数字和下划线(_),长度不超过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分钟。

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