Developer OpenAPI
首页Apifox官网钉钉openAPI
企业微信openAPI
  • openAPI文档
  • 官方文档
首页Apifox官网钉钉openAPI
企业微信openAPI
  • openAPI文档
  • 官方文档
服务端API
  • 历史文档(不推荐)
  • 开发钉钉应用
  • 服务端API
  • 新版服务端API(DingTalk OpenAPI)
  • 生态伙伴API
获取凭证(access_token)身份验证(免登)应用授权通讯录管理互联平台群会话管理消息通知智能工作流智能填表智能人事考勤日志签到公告钉钉运动应用管理文件存储钉盘新教育专属钉钉智能办公电话应用市场项目管理客户管理(官方CRM)培训智能硬件
获取凭证(access_token)身份验证(免登)应用授权通讯录管理互联平台群会话管理消息通知智能工作流智能填表智能人事考勤日志签到公告钉钉运动应用管理文件存储钉盘新教育专属钉钉智能办公电话应用市场项目管理客户管理(官方CRM)培训智能硬件
  1. 工作通知
  • 使用模版发送工作通知
    • 使用模板发送工作通知消息
      POST
  • 工作通知
    • 发送工作通知
      POST
    • 更新工作通知状态栏
      POST
    • 获取工作通知消息的发送进度
      POST
    • 获取工作通知消息的发送结果
      POST
    • 撤回工作通知消息
      POST
  • 企业群消息
    • 发送消息到企业群
      POST
    • 查询群消息已读人员列表
      GET
  • 普通消息
    • 发送普通消息
      POST
  1. 工作通知

发送工作通知

POST
http://127.0.0.1/topapi/message/corpconversation/asyncsend_v2
最后修改时间:2022-08-30 09:19:22
责任人:未设置

说明#

调用本接口发送工作通知消息。
服务地址:https://oapi.dingtalk.com

权限#

服务端API是以应用维度授权的,在创建应用时,系统已默认添加了消息通知权限。
应用类型是否支持调用权限申请方式API Explorer调试
企业内部应用是无需申请调试
第三方企业应用是无需申请调试
第三方个人应用否——

请求参数

Query 参数

Body 参数application/json

示例
{
    "msg": {
        "voice": {
            "duration": "100",
            "media_id": "100"
        },
        "image": {
            "media_id": "@123"
        },
        "oa": {
            "head": {
                "bgcolor": "bgcolor",
                "text": "text"
            },
            "pc_message_url": "pc_message_url",
            "status_bar": {
                "status_value": "进行中",
                "status_bg": "0xFFF65E5E"
            },
            "body": {
                "file_count": "file_count",
                "image": "image",
                "form": {
                    "value": "value",
                    "key": "key"
                },
                "author": "author",
                "rich": {
                    "unit": "unit",
                    "num": "num"
                },
                "title": "title",
                "content": "content"
            },
            "message_url": "message_url"
        },
        "file": {
            "media_id": "media_id"
        },
        "action_card": {
            "btn_json_list": {
                "action_url": "action_url",
                "title": "title"
            },
            "single_url": "single_url",
            "btn_orientation": "btn_orientation",
            "single_title": "single_title",
            "markdown": "markdown",
            "title": "title"
        },
        "link": {
            "picUrl": "picUrl",
            "messageUrl": "messageUrl",
            "text": "text",
            "title": "title"
        },
        "markdown": {
            "text": "text",
            "title": "title"
        },
        "text": {
            "content": "123"
        },
        "msgtype": "text"
    },
    "to_all_user": "false",
    "agent_id": "123",
    "dept_id_list": "123,456",
    "userid_list": "123,456"
}

请求示例代码

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/topapi/message/corpconversation/asyncsend_v2?access_token=6d1bxxxx' \
--header 'Content-Type: application/json' \
--data-raw '{
    "msg": {
        "voice": {
            "duration": "100",
            "media_id": "100"
        },
        "image": {
            "media_id": "@123"
        },
        "oa": {
            "head": {
                "bgcolor": "bgcolor",
                "text": "text"
            },
            "pc_message_url": "pc_message_url",
            "status_bar": {
                "status_value": "进行中",
                "status_bg": "0xFFF65E5E"
            },
            "body": {
                "file_count": "file_count",
                "image": "image",
                "form": {
                    "value": "value",
                    "key": "key"
                },
                "author": "author",
                "rich": {
                    "unit": "unit",
                    "num": "num"
                },
                "title": "title",
                "content": "content"
            },
            "message_url": "message_url"
        },
        "file": {
            "media_id": "media_id"
        },
        "action_card": {
            "btn_json_list": {
                "action_url": "action_url",
                "title": "title"
            },
            "single_url": "single_url",
            "btn_orientation": "btn_orientation",
            "single_title": "single_title",
            "markdown": "markdown",
            "title": "title"
        },
        "link": {
            "picUrl": "picUrl",
            "messageUrl": "messageUrl",
            "text": "text",
            "title": "title"
        },
        "markdown": {
            "text": "text",
            "title": "title"
        },
        "text": {
            "content": "123"
        },
        "msgtype": "text"
    },
    "to_all_user": "false",
    "agent_id": "123",
    "dept_id_list": "123,456",
    "userid_list": "123,456"
}'

返回响应

🟢200成功
application/json
Body

示例
{
    "request_id": "string",
    "errmsg": "string",
    "errcode": 0,
    "task_id": 0
}
修改于 2022-08-30 09:19:22
上一页
使用模板发送工作通知消息
下一页
更新工作通知状态栏
Built with