com.jeecg.dingtalk.api.message

类 JdtMessageAPI

java.lang.Object

com.jeecg.dingtalk.api.message.JdtMessageAPI

public class JdtMessageAPI
extends Object

钉钉消息通知接口

发送工作通知消息需要注意以下事项：

同一个应用相同消息的内容同一个用户一天只能接收一次。

同一个应用给同一个用户发送消息，企业内部应用一天不得超过500次。

通过设置to_all_user参数全员推送消息，一天最多3次。

超出以上限制次数后，接口返回成功，但用户无法接收到。详细的限制说明，请参考工作通知消息限制。

该接口是异步发送消息，接口返回成功并不表示用户一定会收到消息，需要通过获取工作通知消息的发送结果接口查询是否给用户发送成功。

消息类型和样例可参考消息类型与数据格式。

作者:

sunjianlei

构造器概要

构造器

构造器和说明
JdtMessageAPI()

方法概要

限定符和类型	方法和说明
static Response<com.alibaba.fastjson.JSONObject>	recallMessage(int agent_id, String msg_task_id, String accessToken) 撤回消息。
static Response<String>	sendActionCardMessage(Message<ActionCardMessage> message, String accessToken) 发送卡片消息 https://developers.dingtalk.com/document/app/asynchronous-sending-of-enterprise-session-messages
static Response<String>	sendFileMessage(Message<FileMessage> message, String accessToken) 发送文件消息 https://developers.dingtalk.com/document/app/asynchronous-sending-of-enterprise-session-messages
static Response<String>	sendImageMessage(Message<ImageMessage> message, String accessToken) 发送图片消息 https://developers.dingtalk.com/document/app/asynchronous-sending-of-enterprise-session-messages
static Response<String>	sendLinkMessage(Message<LinkMessage> message, String accessToken) 发送链接消息 https://developers.dingtalk.com/document/app/asynchronous-sending-of-enterprise-session-messages
static Response<String>	sendMarkdownMessage(Message<MarkdownMessage> message, String accessToken) 发送Markdown消息 https://developers.dingtalk.com/document/app/asynchronous-sending-of-enterprise-session-messages
static Response<String>	sendTextMessage(Message<TextMessage> message, String accessToken) 发送文本消息 https://developers.dingtalk.com/document/app/asynchronous-sending-of-enterprise-session-messages
static Response<String>	sendVoiceMessage(Message<VoiceMessage> message, String accessToken) 发送语音消息 https://developers.dingtalk.com/document/app/asynchronous-sending-of-enterprise-session-messages

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造器详细资料

JdtMessageAPI

public JdtMessageAPI()

方法详细资料

sendTextMessage

public static Response<String> sendTextMessage(Message<TextMessage> message,
                                               String accessToken)

发送文本消息
https://developers.dingtalk.com/document/app/asynchronous-sending-of-enterprise-session-messages

参数:

message - 文本消息

accessToken - 有效的access_token

返回:

Response<String> 成功返回task_id（任务id，可用于撤回）

sendImageMessage

public static Response<String> sendImageMessage(Message<ImageMessage> message,
                                                String accessToken)

发送图片消息
https://developers.dingtalk.com/document/app/asynchronous-sending-of-enterprise-session-messages

参数:

message - 图片消息

accessToken - 有效的access_token

返回:

Response<String> 成功返回task_id（任务id，可用于撤回）

sendVoiceMessage

public static Response<String> sendVoiceMessage(Message<VoiceMessage> message,
                                                String accessToken)

发送语音消息
https://developers.dingtalk.com/document/app/asynchronous-sending-of-enterprise-session-messages

参数:

message - 语音消息

accessToken - 有效的access_token

返回:

Response<String> 成功返回task_id（任务id，可用于撤回）

sendFileMessage

public static Response<String> sendFileMessage(Message<FileMessage> message,
                                               String accessToken)

发送文件消息
https://developers.dingtalk.com/document/app/asynchronous-sending-of-enterprise-session-messages

参数:

message - 文件消息

accessToken - 有效的access_token

返回:

Response<String> 成功返回task_id（任务id，可用于撤回）

sendLinkMessage

public static Response<String> sendLinkMessage(Message<LinkMessage> message,
                                               String accessToken)

发送链接消息
https://developers.dingtalk.com/document/app/asynchronous-sending-of-enterprise-session-messages

参数:

message - 链接消息

accessToken - 有效的access_token

返回:

Response<String> 成功返回task_id（任务id，可用于撤回）

sendMarkdownMessage

public static Response<String> sendMarkdownMessage(Message<MarkdownMessage> message,
                                                   String accessToken)

发送Markdown消息
https://developers.dingtalk.com/document/app/asynchronous-sending-of-enterprise-session-messages

参数:

message - Markdown消息

accessToken - 有效的access_token

返回:

Response<String> 成功返回task_id（任务id，可用于撤回）

sendActionCardMessage

public static Response<String> sendActionCardMessage(Message<ActionCardMessage> message,
                                                     String accessToken)

发送卡片消息
https://developers.dingtalk.com/document/app/asynchronous-sending-of-enterprise-session-messages

参数:

message - 卡片消息

accessToken - 有效的access_token

返回:

Response<String> 成功返回task_id（任务id，可用于撤回）

recallMessage

public static Response<com.alibaba.fastjson.JSONObject> recallMessage(int agent_id,
                                                                      String msg_task_id,
                                                                      String accessToken)

撤回消息。仅支持撤回24小时内的工作消息通知。
https://developers.dingtalk.com/document/app/notification-of-work-withdrawal

参数:

agent_id - 发送消息时使用的微应用的ID。

msg_task_id - 发送消息时钉钉返回的任务ID。

accessToken - 有效的access_token

返回:

Response<JSONObject>