钉钉内部工作消息通知

一、创建应用

登录钉钉后台管理系统，创建一个适合自己需求的项目，
因为我本次做的是企业内部的工作通知接口，所以选择企业内部开发H5应用

image.png

这里需要填写自主开发

第二部选择开发应该，微应用，服务器出口IP就是IP白名单用，隔开就可以传多个，填写完成点击创建即可。

image.png

创建完成之后再点击h5微应用就可以看到刚才创建的项目了，点击项目查看详情，就可以看到你项目的AgentId、AppKey、AppSecret了

image.png

二、实现消息推送

1、获取access_token

【注意】正常情况下access_token有效期为7200秒，有效期内重复获取返回相同结果，并自动续期。
请求方式：GET（HTTPS）
请求地址：https://oapi.dingtalk.com/gettoken?appkey=key&appsecret=secret

参数	参数类型	必须	说明
appkey	String	是	应用的唯一标识key
appsecret	String	是	应用的密钥

请求示范

DefaultDingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/gettoken");
OapiGettokenRequest request = new OapiGettokenRequest();
request.setAppkey("appkey"); //替换刚才项目的appkey
request.setAppsecret("appsecret");
request.setHttpMethod("GET");
OapiGettokenResponse response = client.execute(request);

2、发送工作通知

请求方式：POST（HTTPS）

请求地址：https://oapi.dingtalk.com/topapi/message/corpconversation/asyncsend_v2?access_token=ACCESS_TOKEN
参数说明：

名称	类型	是否必须	示例值	描述
agent_id	Number	必须	1234	应用
agentId	String	可选(userid_list,dept_id_list, to_all_user必须有一个不能为空)	zhangsan,lisi	接收者的用户userid列表，最大列表长度：100
dept_id_list	String	可选（可不传，若传不能为空）	123,456	接收者的部门id列表，最大列表长度：20, 接收者是部门id下(包括子部门下)的所有用户
to_all_user	Boolean	可选	false	是否发送给企业全部用户
msg	json对象	必须	{"msgtype":"text","text":{"content":"消息内容"}}	消息内容，消息类型和样例参考“消息类型与数据格式”。最长不超过2048个字节