发送电话DING
更新于 2023-01-18调用本接口，可以通过互动服务窗的服务号发送电话DING。
接口调用流程
调用本接口发送电话DING消息，需要完成以下配置，步骤如下：
步骤一：登录钉钉管理后台。
步骤二：在钉钉管理后台页面，依次单击专属钉钉 > 专属开放 > DING服务 > 电话DING容量，完成如下图所示配置。
说明 
DING电话推送号，需要先在当前组织内的互动服务窗应用中添加，如下图所示。添加完成后，再去钉钉管理后台的电话DING容量页面配置。
权限
要调用此API，需要以下权限之一。
应用类型 | 是否支持 | 权限 | API Explorer调试 |
|---|---|---|---|
| 企业内部应用 | 支持 | 专属钉钉发电话DING权限 | API Explorer |
| 第三方企业应用 | 暂不支持 | 专属钉钉发电话DING权限 | 暂不支持 |
| 第三方个人应用 | 暂不支持 | 专属钉钉发电话DING权限 | 暂不支持 |
请求方法
Loading...
Header参数
名称 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
x-acs-dingtalk-access-token | String | 是 | 调用该接口的访问凭证。
|
Body参数
名称 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
userids | Array of String | 是 | 接收DING消息的用户userId列表，最大值20。 |
content | String | 是 | 消息内容。 |
返回参数
名称 | 类型 | 描述 |
|---|---|---|
success | Boolean | 发送Ding消息是否成功。
|
示例
请求示例
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
返回示例
Loading...
错误码
HttpCode | 错误码 | 错误信息 | 说明 |
|---|---|---|---|
400 | assign.lack | 管理员未签署协议 | 管理员未签署协议 |
400 | message.duplicate | 重复内容，发送失败 | 重复内容，发送失败 |
400 | param.illegal | 参数不合法 | 参数不合法 |
400 | publisher.notexist | 服务号不存在 | 服务号不存在 |
400 | volume.lack | 电话DING额度不足 | 电话DING额度不足 |
400 | batch.toolarge | 每批接受人数超20 | 每批接受人数超20 |
400 | phoneding.reachlimit | 电话DING发送已达上限 | 电话DING发送已达上限 |
400 | send.toofast | 发送频繁，请稍后再试 | 发送频繁，请稍后再试 |
