亿联文档帮助中心

发送带Applink的消息卡片

注意：若卡片消息跳转地址需要携带code的话必须使用AppLink格式进行跳转
AppLink协议就是一个URL协议，用于打开应用或者应用其中的一个界面，AppLink详细介绍介绍见 AppLink协议介绍
AppLink的URL结构如下所示
其中path+query部分通常格式为 /ume/client/模块/事件?参数

构造AppLink卡片消息结构体的详细步骤：

调用接口获取AppLink所需的host信息如下所示具体调用接口见获取AppLink所需的host

需要注意的是，因为当前有接口请求调用的频率限制并且服务器域名不会经常改变，不需要每次发送AppLink卡片消息时，都来请求获取host信息，在第一次查询时，可在本地进行缓存host信息。否则可能获取不到host信息从而导致卡片消息发送失败。

请求消息示例
```
GET /open/api/v2/messages/app-link/host HTTP/1.1
Content-Type: application/json

Header
Authorization: Bearer [access_token]
timestamp: 1610544682145
nonce: aac64aa63454457294d440d8be191254
```
响应消息示例
```
HTTP/1.1 200 
Content-Type: application/json;charset=UTF-8

{
   "host": "https://10.200.112.133.xip.io:443/ume/client" //具体host信息
}
```
拼接完整AppLink的URL，将第一步获取的host信息拼接上path与query部分即可。

以拼接跳转至问卷详情页面为例
- 如需跳转至应用网页，需带上参数 clientId 、 mode(打开方式) 、path(跳转的具体页面地址)
- 跳转的页面地址为 /ume/survey/pc/detail?id=d6864
- 注意：若跳转的页面地址包含参数，需将参数连接符？改为 & 后进行拼接即 /ume/survey/pc/detail&id=d6864
- 拼接后的URL https://10.200.112.133.xip.io:443/ume/client/webapp/open?clientId=12e3&mode=browser&path=/ume/survey/pc/detail&id=d6864
- 点击该卡片消息即可跳转至问卷详情页面 https://uc20.yealink.com:18443/ume/survey/pc/detail?clientId=12e3&id=d686407523aa4be9b95e7b5b8a89441d&code=529a8a9
- https://uc20.yealink.com:18443 为配置的主页跳转地址（通过参数clientId可自动转换）
- 如需进行免登，需在应用管理主页跳转配置界面打开 应用免登 按钮,即可将code拼接在跳转的URL中

包含AppLink的卡片消息结构体如下 (示例只包含AppLink组件的必填参数)

{
"elements": [
	{
		"tag": "markdown",
		"content": "[跳转至应用页面]($urlVal)",
		"href": {
			"urlVal": {
				"tag": "url",
				"url": "https://10.200.112.133.xip.io:443/ume/client/webapp/open?clientId=12e3&mode=browser&path=/ume/survey/pc/detail&id=d6864",
				"pcUrl": "https://10.200.112.133.xip.io:443/ume/client/webapp/open?clientId=12e3&mode=browser&path=/ume/survey/pc/detail&id=d6864"
			}
		}
	}
]
}