企业微信自建应用跳转第三方app是企业微信应用开发中常用的一种方法,许多企业在使用企业微信应用时需要将内部业务系统集成进来,因此需要与第三方应用进行跳转交互。以下是原理和详细介绍:
一、企业微信自建应用简介
企业微信自建应用是指企业在企业微信开放平台上创建的应用,可以通过企业微信访问企业内部的业务系统。自建应用可以自定义应用名称、图标、菜单、权限、API等,为应用开发提供了更大的灵活度。
二、企业微信自建应用跳转第三方app原理
企业微信自建应用可以通过访问第三方的URL来跳转到第三方APP。企业微信跳转到APP的具体流程如下:
1. 自建应用获取第三方APP的schema
Schema是一种特殊的URL协议,用于唤起APP组件。获取第三方APP的schema,可以通过第三方APP提供的开放接口、文档或者网站获取。
2. 自建应用生成跳转链接
自建应用通过schema,生成跳转链接,并加上需要传递的参数值。这些参数可以是身份验证信息、业务信息等,可以自定义传递参数的名称和值。
3. 调用企业微信API
自建应用通过调用企业微信官方API,将跳转链接传递给企业微信,等待企业微信处理。
4. 企业微信处理
企业微信在处理完跳转链接后,将会跳转到第三方APP。如果当前用户没有安装第三方APP,系统会直接提示用户下载安装。
三、企业微信自建应用跳转第三方app详细介绍
企业微信自建应用跳转第三方app需要配合企业微信官方API进行路由转发,其详细流程如下:
1. 获取第三方APP的schema
第三方APP的schema需要在第三方APP里面定义,可以通过开放接口或者官方文档获取。以支付宝为例,支付宝的schema可通过以下链接获取:
https://opendocs.alipay.com/apis/api_9/alipay.trade.pay
2. 生成跳转链接
自建应用通过schema,生成跳转链接。例如,跳转链接可生成为:
alipays://platformapi/startapp?appId=20000067&url=https%3A%2F%2Fwww.baidu.com%3FuserId%3D123
其中,schema名称为alipays,跳转到appId为20000067的应用,数据传递的URL是https://www.baidu.com,其中包含userId参数值为123。
3. 调用企业微信API
调用企业微信官方API,将跳转链接传递给企业微信。企业微信API有很多种,以调用API方式为例,示例如下:
```
curl -X POST \
-H "Content-Type: application/json" \
"https://qyapi.weixin.qq.com/cgi-bin/message/send?access_token=ACCESS_TOKEN" \
-d '{"touser": "USERID","msgtype": "text","agentid": AGENTID,"text": {"content": "跳转到支付宝","assistant_type": "标准","app_type": 2,"app_id": "", "content_source_url": ""},"enable_id_trans": 0,"enable_duplicate_check": 0,"duplicate_check_interval": 1800}'
```
其中,ACCESS_TOKEN是企业微信API的凭证,USERID是调用用户的ID号,AGENTID是自建应用的ID号。请求内容中的app_type为2,表示为业务APP类型。
4. 企业微信处理
企业微信在处理完跳转链接后,将会跳转到第三方APP。如果当前用户没有安装第三方APP,系统会直接提示用户下载安装。
总结:
企业微信自建应用跳转第三方APP是企业微信应用开发中常用的方法,步骤简单,灵活性高。企业根据实际业务需要,通过自建应用来进行集成,方便了企业内部业务的开发和管理,提高了企业内部信息的传递和应用效率。