发送服务群消息
POST
/v1.0/serviceGroup/messages/send最后修改时间:: 2 年前
责任人: 未设置
说明
调用本接口发送服务群消息。
服务地址:api.dingtalk.com
权限
要调用此API,需要以下权限之一。
应用类型 | 是否支持 | 权限 | API Explorer调试 |
---|---|---|---|
企业内部应用 | 支持 | 场景服务群发送消息权限 | API Explorer |
第三方企业应用 | 暂不支持 | 场景服务群发送消息权限 | 暂不支持 |
第三方个人应用 | 暂不支持 | 场景服务群发送消息权限 | 暂不支持 |
错误码
HttpCode | 错误码 | 错误信息 | 说明 |
---|---|---|---|
400 | illegalPama | 参数非法 | 参数非法 |
500 | systemError | 系统异常 | 系统异常 |
请求参数
Header 参数
x-acs-dingtalk-access-token
string
必需
调用该接口的访问凭证。如何获取不同应用的凭证请参考访问凭证概述。
Body 参数application/json
targetOpenConversationId
string
必需
开放群ID。
调用创建服务群接口获取。
title
string
标题。
content
string
消息内容。
atMobiles
array[string]
可选
被@人的手机号列表。
atDingtalkIds
array[string]
可选
被@人的dingtalkId列表。
atUnionIds
array[string]
可选
被@人的unionId列表。
receiverMobiles
array[string]
手机号接收者列表。
receiverDingtalkIds
array[string]
可选
dingtalkId接收者列表。
receiverUnionIds
array[string]
可选
unionId接收者列表。
messageType
string
消息类型,取值。
btnOrientation
string
排列方式,取值。
btns
array [object {2}]
可选
actionCard按钮。
actionURL
string
按钮跳转地址。
title
string
按钮名称。
示例
{}
示例代码
返回响应
成功(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
openMsgTaskId
string
开放消息任务ID。
示例
{
"openMsgTaskId": "string"
}
最后修改时间: 2 年前