Developer OpenAPI
首页Apifox官网钉钉openAPI
企业微信openAPI
  • openAPI文档
  • 官方文档
首页Apifox官网钉钉openAPI
企业微信openAPI
  • openAPI文档
  • 官方文档
新版服务端API(DingTalk OpenAPI)
  • 历史文档(不推荐)
  • 开发钉钉应用
  • 服务端API
  • 新版服务端API(DingTalk OpenAPI)
  • 生态伙伴API
获取访问凭证通讯录应用市场客户管理服务群考勤待办任务日程钉盘会议专属钉钉合作空间钉工牌数据目录制造业数字化管理师宜搭应用开发文档
获取访问凭证通讯录应用市场客户管理服务群考勤待办任务日程钉盘会议专属钉钉合作空间钉工牌数据目录制造业数字化管理师宜搭应用开发文档
  1. 服务群
  • 创建场景服务群
    POST
  • 发送服务群消息
    POST
  • 查询服务群活跃用户
    GET
  • 升级云客服服务群为钉钉智能服务群
    POST
  • 升级普通群为服务群
    POST
  1. 服务群

发送服务群消息

POST
http://127.0.0.1/v1.0/serviceGroup/messages/send
新版服务端API(DingTalk OpenAPI)/服务群
最后修改时间:2022-08-30 09:19:21
责任人:未设置

说明#

调用本接口发送服务群消息。
服务地址:api.dingtalk.com

权限#

要调用此API,需要以下权限之一。
应用类型是否支持权限API Explorer调试
企业内部应用支持场景服务群发送消息权限API Explorer
第三方企业应用暂不支持场景服务群发送消息权限暂不支持
第三方个人应用暂不支持场景服务群发送消息权限暂不支持

错误码#

HttpCode错误码错误信息说明
400illegalPama参数非法参数非法
500systemError系统异常系统异常

请求参数

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 
按钮名称。
可选
示例
{}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://127.0.0.1/v1.0/serviceGroup/messages/send' \
--header 'x-acs-dingtalk-access-token;' \
--header 'Content-Type: application/json' \
--data-raw '{}'

返回响应

🟢200成功
application/json
Body
openMsgTaskId
string 
开放消息任务ID。
可选
示例
{
  "openMsgTaskId": "string"
}
上一页
创建场景服务群
下一页
查询服务群活跃用户
Built with