钉钉对接指南
UMS 当前支持对接钉钉的工作通知,钉钉消息一般用于企业内部员工的通知,需要先在企业组织下创建一个应用。发送的消息均展示在「工作通知」会话中。
申请钉钉应用
详见官方文档
1、登陆钉钉管理后台
在应用开发页面,选择应用类型,然后单击创建应用。应用创建后,在应用详情页可获取 AppKey 和 AppSecret,这两个信息需要填写到 UMS 钉钉通道信息中。
2、权限申请
- 在应用开发页面,单击目标应用进入应用详情页面。
- 在应用详情页,单击接口权限,然后单击添加接口权限。
- 添加消息通知和企业会话接口权限。
3、配置 IP 白名单
将极光系统的 IP:119.3.213.183 配置在开发管理-服务器出口 IP 中。
上传 userID
1、钉钉的 userID 在企业创建用户时,可以自行设定,如果未指定会随机生成,因此如果未指定,还需要申请权限获取 userID。
2、钉钉的 userID 在一个企业内部是唯一的,无论创建多少个应用,均可使用同一个 userID 发送消息。因此在上传信息时,绑定标识 bind_id 为 all。
3、极光提供了一个程序可协助开发者根据手机号码获取 userID,下载 pushtools 工具( Linux 版本或 Mac 版本),在控制台输入如下命令,填写上具体的 AppKey 、 AppSecret 和手机号码即可
./pushtool dingtalk -appkey xxx -secret xxx -phone xxx
注意事项
- 同一个应用相同消息的内容同一个用户一天只能接收一次。
- 同一个应用给同一个用户发送消息,企业内部应用一天不得超过500次。
- 超出以上限制次数后,接口返回成功,但用户无法接收到