组织云钉钉API
  1. 消息通知
组织云钉钉API
  • 服务端API
    • 如何调用服务端API
    • 服务端SDK下载
    • 获取凭证(access_token)
      • 获取企业内部应用的access_token
      • 获取jsapi_ticket
    • 身份验证(免登)
      • 企业内部应用免登
      • 免登常见问题
    • 通讯录管理
      • 通讯录事件
      • 用户管理
        • 创建用户
        • 更新用户信息
        • 删除用户
        • 根据userid获取用户详情
        • 获取部门用户基础信息
        • 获取部门用户userid列表
        • 获取部门用户详情
        • 获取员工人数
        • 获取未登录钉钉的员工列表
        • 根据手机号获取userid
        • 根据unionid获取用户userid
        • 获取管理员列表
        • 获取管理员通讯录权限范围
        • 获取管理员的应用管理权限
      • 部门管理
        • 获取部门详情
        • 获取部门列表
        • 获取子部门ID列表
        • 获取指定部门的所有父部门列表
        • 获取指定用户的所有父部门列表
      • 角色管理
        • 删除角色
        • 创建角色
        • 创建角色组
        • 更新角色
        • 批量增加员工角色
        • 批量删除员工角色
        • 设定角色成员管理范围
        • 获取角色组列表
        • 获取角色列表
        • 获取角色详情
        • 获取指定角色的员工列表
    • 消息通知
      • 消息通知概述
      • 消息类型与数据格式
      • 消息链接说明
      • 工作通知
        • 发送工作通知
        • 更新工作通知状态栏
        • 获取工作通知消息的发送进度
        • 获取工作通知消息的发送结果
        • 撤回工作通知消息
      • 普通消息
        • 发送普通消息
  • 钉钉回调相关
    • 钉钉Stream回调
    • 事件订阅列表
  1. 消息通知

消息链接说明

本文介绍了消息链接的打开方式。

消息链接在PC端侧边栏打开#

在PC客户端点击消息中的URL链接时,希望控制链接的打开方式,可以使用以下方式:
dingtalk://dingtalkclient/page/link?url=http%3A%2F%2Fwww.dingtalk.com&pc_slide=true
参数说明:
参数描述
url要打开的链接,必须urlEncode。
pc_slide
  • true:表示在PC客户端侧边栏打开
  • false:表示在浏览器打开

消息链接在PC端工作台打开#

当消息中的URL链接是某个微应用链接时,希望在PC端工作台打开,可以使用以下方式:
dingtalk://dingtalkclient/action/openapp?corpid=免登企业corpId&container_type=work_platform&app_id=0_{应用agentid}&redirect_type=jump&redirect_url=跳转url
参数说明:
参数描述
corpid免登微应用用户的所属企业。
container_type使用哪种方式打开链接:
  • work_platform:表示用工作台打开
app_id第三方企业应用应填写appId,企业自建应用填写0_agentId,由数字0、下划线和agentId拼接组成。其中appId,agentId可在应用详情中查看。
redirect_type此场景下输入jump。
redirect_url要跳转的地址,必须urlEncode。

小程序链接#

小程序发送消息,点击消息链接跳转到小程序,支持的应用场景如下:
应用类型工作通知消息企业群消息普通消息
企业内部应用支持不支持不支持
第三方企业应用支持不支持不支持
第三方个人应用——支持
跳转到小程序的消息链接格式如下:
 eapp://page?query
例如:eapp://pages/index/index?param1=aa&param2=bb
参数说明:
只有在小程序发送消息时才支持该链接,微应用发送消息时不支持。
跳转的目标小程序,需要发布线上版本,才可以保证能正常跳转。
page表示小程序的页面地址, 例如pages/index/index, 这个page必须是app.json配置中pages下的路径。
说明
跳转的目标小程序,需要发布线上版本,才可以保证能正常跳转。
page参数
query表示page页面onLoad的query参数。例如param1=aa&param2=bb, 当参数值有特殊字符时需要使用urlEncode进行编码处理。
修改于 2023-12-26 06:53:26
上一页
消息类型与数据格式
下一页
发送工作通知
Built with