跳转到主要内容
本文档介绍发送的工作通知消息,如何点击实现跳转进入钉钉微应用

前提条件

完成创建应用的流程。

操作步骤

  1. 选择目标应用,进入应用详情页,单击基础信息 > 凭证与基础信息
  2. 获取应用 Client ID 和 Client Secret。
  3. 企业内部应用已经默认开通工作通知接口权限,无需再手动提交申请。
  4. 获取应用访问凭证获取企业内部应用的access_token。调用接口时,通过accessToken鉴权调用者身份。
  5. 调用发送工作通知接口,给目标用户发送工作消息通知,需要用户点击消息进行跳转,所以适合的消息类型有link消息、OA消息和卡片消息,具体可参考消息通知类型

点击工作通知跳转网页应用(H5 微应用)

  1. 调用发送工作通知接口,工作消息的格式选择link消息、OA消息或者卡片消息,这三种类型消息可以进行跳转。
  2. 跳转链接的构造参考消息链接说明,如下提供这三种类型消息中链接的构造示例,完整的消息发送格式请参考消息通知类型
    参数描述
    corpid- 企业内部应用-网页应用(H5 微应用),该参数为当前微应用所在企业的corpid值 - 第三方企业应用-网页应用(H5 微应用),该参数为授权开通当前应用的授权企业corpid值
    container_type使用哪种方式打开链接(固定值): - work_platform:表示用工作台打开
    app_id- 企业内部应用-H5微应用,该参数填写0_agentId,由数字0、下划线和agentId拼接组成,agentId查看请参考AgentId。 - 第三方企业应用-H5微应用,该参数填写当前三方微应用的appId值,appId查看请参考App ID。
    redirect_type此场景下输入jump(固定值)。
    redirect_url要跳转的地址,必须urlEncode

示例

dingtalk://dingtalkclient/action/openapp?corpid=企业的corpid&container_type=work_platform&app_id=appId&redirect_type=jump&redirect_url=跳转url

Link消息跳转链接构造示例

"messageUrl": "dingtalk://dingtalkclient/action/openapp?corpid=企业的corpid&container_type=work_platform&app_id=appId&redirect_type=jump&redirect_url=跳转url"

OA消息跳转链接构造示例

"message_url": "dingtalk://dingtalkclient/action/openapp?corpid=企业的corpid&container_type=work_platform&app_id=appId&redirect_type=jump&redirect_url=跳转url"

卡片消息跳转链接构造示例

卡片消息支持整体跳转ActionCard样式和独立跳转ActionCard样式:
  • 整体跳转ActionCard样式
    "single_url": "dingtalk://dingtalkclient/action/openapp?corpid=企业的corpid&container_type=work_platform&app_id=appId&redirect_type=jump&redirect_url=跳转url"
    
  • 独立跳转ActionCard样式
    "action_url": "dingtalk://dingtalkclient/action/openapp?corpid=企业的corpid&container_type=work_platform&app_id=appId&redirect_type=jump&redirect_url=跳转url"