钉钉对接指南

UMS 当前支持对接钉钉的工作通知,钉钉消息一般用于企业内部员工的通知,需要先在企业组织下创建一个应用。发送的消息均展示在「工作通知」会话中。

申请钉钉应用

详见官方文档

1、登陆钉钉管理后台

应用开发页面,选择应用类型,然后单击创建应用。应用创建后,在应用详情页可获取 AppKey 和 AppSecret,这两个信息需要填写到 UMS 钉钉通道信息中。

2、权限申请

  • 在应用开发页面,单击目标应用进入应用详情页面。
  • 在应用详情页,单击接口权限,然后单击添加接口权限。
  • 添加消息通知和企业会话接口权限。

jpush_web

3、配置 IP 白名单

将极光系统的 IP:119.3.213.183 配置在开发管理-服务器出口 IP 中。

jpush_web

上传 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次。
  • 超出以上限制次数后,接口返回成功,但用户无法接收到

Copyright 2011-2020, jiguang.cn, All Rights Reserved.
粤ICP备12056275号-13 深圳市和讯华谷信息技术有限公司

Documentation built with MkDocs.