hubot-dingtalk-bot

Hubot 的dingtalk适配器，让钉钉机器人无缝接入hubot。

注意: 需要先配置好hubot。

目前支持：

• 企业内部机器人（签名sign方式）
• 自定义机器人（token匹配方式）

环境变量：

• HUBOT_DINGTALK_AUTH_TYPE (认证类型：token,sign)
• HUBOT_DINGTALK_TOKEN (认证类型为token时)
• HUBOT_DINGTALK_SECRET (认证类型为sign时)
• HUBOT_DINGTALK_MODE (会话类型，1:全部，2:单聊，3:群聊)
• HUBOT_DINGTALK_BLACKLIST (会话黑名单，格式为cidyyyy==,cidxxxx=，优先极高)
• HUBOT_DINGTALK_WHITELIST (会话白名单，格式为cidyyyy==,cidxxxx=)
• HUBOT_DINGTALK_MSGTYPE (消息类型: text,markdown，默认text)

Adapter 配置

添加自定义机器人

打开钉钉添加机器人页面，在底部找到POST 地址和Token（需要开通Outgoing权限），但是目前Outgoing功能关闭了，企业内部机器人默认是开放Outgoing的。

POST 地址

Adapter在启动之后会创建回调/hubot/dingtalk/message/用于接收消息。

在POST 地址填入域名/hubot/dingtalk/message/

添加企业内部机器人

登录钉钉开放平台创建

应用开发-企业内部开发-机器人-创建老版机器人 也可以 应用开发-企业内部应用-应用详情页-机器人与消息推送创建新版机器人 功能一样，只是创建入口不一样，新版是作为应用的一部分，老版是独立的。

以老版为例 创建成功后在 基础信息-应用信息 复制 AppSecret，在 基础信息-开发管理 配置回调地址

权限认证

1.token比较

配置环境变量：

• HUBOT_DINGTALK_AUTH_TYPE=token
• HUBOT_DINGTALK_TOKEN

HUBOT_DINGTALK_TOKEN对应钉钉自定义机器人outgoing回调token，用于校验POST 地址接收请求的有效性。

2.sign签名

配置环境变量：

• HUBOT_DINGTALK_AUTH_TYPE=sign
• HUBOT_DINGTALK_SECRET

HUBOT_DINGTALK_SECRET在企业机器人配置appSecret一栏。

会话控制

目前支持基础的会话控制，包含会话类型（单聊、群聊），会话黑白名单（基于conversationId）

• HUBOT_DINGTALK_MODE=1
• HUBOT_DINGTALK_BLACKLIST=cidyyyy==,cidxxxx=
• HUBOT_DINGTALK_WHITELIST=cidyyyy==,cidxxxx=

会优先使用黑名单，关于要使用哪种方式可以自由选取。

该方案目前是简单实现，conversationId的获取还没想到比较好的方式，因为时间问题，临时获取方式是在控制台中输出。

配置Webhook主动发送

在机器人目录conf目录（没有请创建），添加dingtalk-room.json文件。

同一个机器人在不同群的access_token是不一样的，所以要主动发送消息到群是要指定access_token。

这里通过维护别名的方式来实现发送到指定群，room是自定义的名称，可以设置成群聊名称一样，env是access_token的环境变量名称。

[
  {
    "room": "room1",
    "env": "HUBOT_DINGTALK_ACCESS_TOKEN"
  },
  {
    "room": "room2",
    "env": "HUBOT_DINGTALK_ACCESS_TOKEN2"
  }
]

如何发送？

调用robot.messageRoom时，传入你想要发送的群聊别名即可。

module.exports = (robot) ->
  robot.hear "dingtalk", (params) ->
    robot.messageRoom 'room1', "response"

这段代码使用了coffeescript，所以建立的文件扩展名必须是.coffee，当然你也可以转换为js语法，然后放到.js的文件里。

Todo

• [x] 接入主动发消息webhook
• [ ] 优化消息显示

鸣谢

• https://github.com/ineo6/hubot-dingtalk