设置快捷入口（群插件）URL

​

跳转到一个页面

dingtalk://dingtalkclient/page/link?dd_mode=present&pc_slide=true&url=https%3A%2F%2Fwww.dingtalk.io

​

跳转到网页应用（H5 微应用）

dingtalk://dingtalkclient/action/openapp?corpid=$CORPID$&container_type=work_platform&app_id=0_1234&redirect_type=jump&redirect_url=https%3A%2F%2Fwww.dingtalk.io

​

跳转到小程序

1. ddMode=float 浮窗时，可支持的参数

   参数	是否必填	说明
   panelHeight	否	浮窗高度，可以是屏幕占比百分比，也可以是确定的高度。 - percent50，含义是占比屏幕的50%，数字在(0-100]之间，大于小于边界按边界处理。 - 1000，含义是确切的高度单位为pt(非px)。 - 如果不设置或者设置为0，则显示效果为全屏浮窗。
   containerType	否	此场景下额外增加两个值： - miniApp（默认）：小程序 - online：在线H5
   miniAppId	配合containerType决定	小程序appId。
   page	配合containerType决定	URL encode后的页面地址。 如果是小程序，则是小程序的page。 如果是在线H5，则是url地址。
   coverVisible	否，默认显示，配置false，不显示	- true（默认）：显示遮罩层 - false：不显示遮罩层默认显示

​

ddMode=pop 弹层时，可支持的参数

2. 打开应用 scheme（企业小程序专用 scheme） scheme：dingtalk://dingtalkclient/action/open_micro_app 基本参数同通用参数列表。 灰度控制逻辑应该放在这个 scheme 的 handler 里​

   参数	是否必填	说明
   corpId	是	企业的corpid。 重要 优先级高，会覆盖掉query里的corpId。
   appId	和 agent_id 二选一 如果同时存在，优先用appid	微应用id，注意不是小程序ID，isv应用用此id。
   agentId	和 app_id 二选一	企业自建应用的agent_id。
   fallbackUrl	否 不支持 H5 的微应用，不用填此参数，在 H5 和小程序灰度阶段的，必填此参数	H5 的地址，不支持小程序的微应用，直接使用这个地址。
   ddFocus	否	如果配置为true，容器会在初始化时先禁止内部元素获取焦点的行为，默认为false。
   ddForceAsync	否	是否强制异步启动。强制异步启动时，如果本地有离线包，则不会触发同步更新，强制异步更新启动（解决断网环境启动问题）。

   PC端测试case：
   • 在slide panel打开url，无title
     dingtalk://dingtalkclient/action/open_micro_app?corpId=11233&app_id=123&fallback_url=https%3A%2F%2Fwww.dingtalk.io&container_type=slide_panel
     
   • 在slide panel打开url，无title
     dingtalk://dingtalkclient/action/open_micro_app?corpId=11233&app_id=123&fallback_url=https%3A%2F%2Fwww.dingtalk.io
     
   • 在browser打开url
     dingtalk://dingtalkclient/action/open_micro_app?corpId=11233&app_id=123&fallback_url=https%3A%2F%2Fwww.dingtalk.io&container_type=browser
     
   • 在slide panel打开url，有title
     https://www.dingtalk.io?micro_app_scheme=dingtalk%3A%2F%2Fdingtalkclient%2Faction%2Fopen_micro_app%3F%0AcorpId%3D11233%26app_id%3D123%26container_type%3Dslide_panel%26title%3Dtest_title
     
   • 在browser打开url
     https://www.dingtalk.io?micro_app_scheme=dingtalk%3A%2F%2Fdingtalkclient%2Faction%2Fopen_micro_app%3F%0AcorpId%3D11233%26app_id%3D123%26container_type%3Dbrowser%26title%3Dtest_title
     
3. 开启小程序schema (个人小程序专用 scheme) scheme：dingtalk://dingtalkclient/action/open_mini_app 基本参数同通用参数列表。

   参数	是否必填	说明
   miniAppId	是	小程序id。

4. 小程序调试scheme scheme：dingtalk://dingtalkclient/action/dev_mini_app 主要用于调试小程序，以及appx框架开发。通过此方式打开的小程序，直接通过url启动主文档。不会进入包管理流程，也不会触发保活逻辑。miniAppId仅用于做接口校验等。

​

重要

​

如何通过链接获取来源群信息

• 指定特殊打开方式 快捷入口（群插件）为一个带有业务能力的dingtalk链接，开发者需要基于自己微应用的实际场景和在群内用户使用时的具体需求来拼装一个群插件链接出来。插件名字最多支持4个字，插件链接里面所具有的能力非常多，但需要开发者通过链接参数来组装。例如从移动端页面的打开方式(推入页面、弹出页面等)，到PC端的页面跳转逻辑(打开新容器或者左滑页面)，都是通过链接参数的配置来实现的。 以下以项目群的快捷入口为例，详细说明一个快捷入口链接是如何拼装出来的。 dingtalk://dingtalkclient/page/link?url=https%3a%2f%2fding-doc.dingtalk.io%2fdoc%23%2fpqkq0u%2feluagw%2f$CORPID$%2f$DOUBLE_ENCCID$
  • 开发者的目标页面地址：https%3a%2f%2fding-doc.dingtalk.io%2fdoc%23%2fpqkq0u%2feluagw
    • 当你使用了钉钉统一跳转协议，这一部分将作为“钉钉统一跳转协议”地址的入参，所以需要经过urlEncode。
    • 当你没有使用钉钉统一跳转协议，可直接使用原始Url作为快捷入口的地址。不需要urlEncode。
  • **钉钉统一跳转协议（可选）**dingtalk://dingtalkclient/page/link?url=
    • 这个部分决定了会以什么方式打开你指定的页面。目前支持的有“浏览器打开”、“侧边栏打开”等，每种方式对应的统一跳转协议的path不一样。
    • 部分统一跳转协议path，只在部分平台客户端可用，比如侧边栏打开只在pc和mac端可用。
  • 快捷入口地址动参（可选） $CORPID$ $DOUBLE_ENCCID$
    • 设置了这个动参，当用户点击这个快捷入口访问开发者的地址时，url里的这部分动参可以替换为群上下文的信息，比如corpid和 openConversationId。 目前可支持的动参如下：

      只有通过快捷入口（群插件）打开，才支持识别以下动态参数。

      参数	说明
      $CORPID$	动态替换企业ID（corpId）
      $ENCCID$	动态替换成开放群ID（openConversationId）。 仅当不使用钉钉统一跳转协议时使用该动参。
      $DOUBLE_ENCCID$	动态替换成开放群ID（openConversationId），区别在于二次urlencode，用于多次协议透传跳转urldecode。 仅当使用钉钉统一跳转协议时使用该动参。

      $DOUBLE_ENCCID$二次url加解密是因为：钉钉以“dingtalk://”有一层内部协议，在解析这层协议需要加密一次；url参数后面的业务https协议透传给下游容器使用的时候也需要加解密一次；由于消费方2次解析需要，所以产生url时候也需要2次加密。 示例产生url： urlencode（钉钉url？xxx=xxx & url = urlencode（业务url）） 示例解析url： a、urldecode（钉钉url）-> 得到业务url；b、urldecode（业务url）-> 可用参数