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

节点配置

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

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

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