# 微信长辈就医开发文档

# 一、功能介绍

微信长辈就医是微信官方提供的医疗行业适老化版本建设方案，医院公众号或小程序均可接入以实现适老化版开发，为老年患者提供友好的线上诊疗服务。

微信长辈就医主要包括三个功能：

1. 页面适老化改造标准方案，提供两种方式，接入微信长辈就医SDK或按微信长辈就医设计规范设计全流程；
2. 快捷建档接口，医院调用后可获得老年患者实名信息（姓名、身份证、手机号），免去建档填写的繁琐流程；
3. 门诊主流程消息推送接口，底层对接就医助手消息方案，为医院提供一整套消息能力，可按需调用生成可视化门诊就诊流程。

微信长辈就医体验路径：扫描下方二维码，按公众号引导开通后，点击“我的医院”菜单，查找含关怀版标志的医院进行挂号体验即可。

图1 微信长辈就医体验路径示意图

# 二、产品开发

# 2.1 调用方式

文档所有接口请求方式均为HTTPS-POST请求，UTF-8编码，请求和相应参数仅支持JSON数据格式，所有接口的调用均需要获取access_token授权。

服务商获取access_token，走微信开放平台-第三方平台的模式，由医院为第三方服务商授权134 微信长辈就医权限集，授权流程操作指引点击这里查看。

# 2.2 开发前的准备

开发准备清单如下，收集完备后提供给我们工作人员协助配置测试环境：

• 开发测试的公众号appid；
• 开发人员微信账号；
• 用来测试获取wxmed_authcode的测试路径，H5链接或者小程序路径均可；
• 医院信息，字段如下：

# 2.3 页面适老化改造标准方案

医院适老化建设中，微信长辈就医提供两种页面适老化改造标准方案，分别为微信长辈就医SDK或按微信长辈就医设计规范设计全流程，下面会详细介绍两种方案，医院可按需选择。

# 2.3.1 微信长辈就医SDK

# 1. SDK文档

参见微信长辈就医SDK方案

# 2. 方案介绍

本方案由微信提供一套包含门诊挂号、缴费、查询、个人中心（挂号、缴费记录）功能的标准化前端SDK，医院只需要类似于接入 VUE 一样提供一个 div 的选择器进行初始化后，在不同的页面步骤中传入对应的协议字段， SDK 就会在对应 div 中渲染出对应状态的适老化后的页面，轻松实现线上字体放大、按钮放大、对比度加深、页面交互简化，便捷老年患者操作。

页面样式以及交互全部由 SDK 进行处理，接入方只需要处理页面的逻辑部分（数据接口拉取、事件钩子回调逻辑等）。

图2-1 微信长辈就医SDK挂号流程

图2-2 微信长辈就医SDK挂号流程

图3 微信长辈就医SDK缴费流程

图4 微信长辈就医SDK报告查询流程

# 3. 方案说明

本SDK方案目前支持H5形式，若医院计划使用H5提供适老化服务，可直接参照微信长辈就医SDK方案 文档开发。

若医院计划采用小程序形式开发，也可接入本方案，通过小程序内嵌webview实现。因小程序内嵌webview不支持拉起支付，故此处支付流程需切换为小程序支付实现。

# 4. 就医公告接口（选用）

部分医院挂号过程中，可能需要向患者展示来院就诊前的注意事项，我们把这类信息称为就医公告，如下图。

图5 医院就医须知demo

SDK支持医院按既定样式展示就医公告，可通过本接口进行内容设置。设置步骤为：添加草稿->编辑人员线上预览草稿->确认发布，医院也可以直接跳过预览步骤，将公告直接发布。

步骤一：添加公告草稿

图6 医院就医公告富文本demo

步骤二：公告草稿预览设置

步骤三：正式发布公告

步骤四：查询所有公告

# 2.3.2 微信长辈就医设计规范

# 1. 规范文档

参见微信长辈就医开发文档

# 2. 规范介绍

微信长辈就医设计规范 由微信提供一套页面适老化设计规范，医院可参考规范，遵循可感知性、可可操作性、理解性、兼容性和安全性设计老年用户访问的界面功能，功能开发完毕后经微信团队验收通过即可发布上线。本方案设计、前后端均由医院实现。

# 3. 开通组件

医院可在适老化入口调用本组件，调用后用户进入微信长辈就医标准化开通流程，开通后医院可调用3.3.2下文提及的实名组件，获取用户实名信息。

图7 微信长辈就医开通组件

H5开通组件

H5的跳转链接为：

https://mp.weixin.qq.com/insurance/template/eldermedical/open.html?appid={appid}#wechat_redirect

链接上的 {appid} 需要替换成公众号的appid。

小程序开通组件

wx.navigateToMiniProgram({
    appId: 'wx308bd2aeb83d3345',
    path: '/subPages/medical-mvp/auth/main?from=hospital&appid={appid}',
    complete: (res) => {
      console.log('onTapToEldmOpen res', res)
    }
});

# 4. 实名组件

医院可在挂号时按需调用实名组件，调用后将唤起微信名授权弹窗经用户同意，微信将生成长辈就医信息授权码wxmed_authcode并传递给医院页面，医院可调用3.4.1查询用户实名API进行解密并帮助老年患者完成后台建档，免去填写个人信息的繁琐工作。

图8 微信长辈就医实名组件

H5实名组件

H5的跳转链接为：

https://mp.weixin.qq.com/insurance/template/eldermedical/auth-realname.html?appid={appid}&returnUrl={returnUrl}#wechat_redirect

说明：链接上的参数 {returnUrl} -> 授权后会返回此 {returnUrl}，注意链接必须经过 encodeURIComponent，授权获得的 wxamedAuthcode 会携带在此参数上返回。 参数 {appid} 需要替换成公众号的 appid。

小程序实名组件

wx.openBusinessView({
    businessType: 'eldermedicalAuthRealname',
    queryString: 'appid={appid}',
    complete: (res) => {
      console.log('onTapToEldmAuth res code', res.extraData.wxamedAuthcode)
    }
});

# 2.4 API接口列表

# 2.4.1 查询用户实名API

# 1. 接口说明

为降低老年患者建档门槛，微信向公立医院免费提供本接口。老年患者挂号时，医院可通过本接口查询用户实名信息（姓名、身份证、手机号），并获取上述信息在后台为用户创建诊疗卡，后续老年患者挂号时无需再次建档，可直接挂号。

上述流程示例：

用户访问医院适老版主页时，实名开通微信长辈就医服务。使用医院关怀版服务时，院方可请求查询用户实名API获取实名信息，完成后台建档**（说明：下图全部流程由微信提供，医院无需开发前端界面）。**

图9 微信长辈就医获取用户实名授权流程（若用户已在别处开通长辈就医，则点击图一服务直接拉起第五张图的实名弹窗）

用户点击医院服务后，医院获取实名的时序图如下：

图10 微信长辈就医获取用户实名时序图

时序图说明：

1. 用户进入医院适老版主页，点击医院挂号服务;

2. 用户同意授权将实名信息传递给医院；

3. 微信生成长辈就医信息授权码wxmed_authcode；

4. 跳转医院的挂号页面，wxmed_authcode通过url query传递给医院，示例如下：

    小程序path: /pages/registerpage?wxmed_authcode=xxx
    h5链接：https://registerpage.hospital.com?wxmed_authcode=xxx
   

5. 进入医院的建档流程；

6. 医院后台通过查询用户实名API和wxmed_authcode，查询用户的身份信息和手机号；

7. 微信返回加密后的用户身份信息和手机号；

8. 微信给每家医院分配了各自的实名信息解密KEY， 解密后可获得用户实名信息；开发者提供本文档2.2要求的信息后由微信工作人员提供解密密钥；

9. 医院完成后续的建档和挂号流程。

# 2. 接口详情

请查看 查询用户实名API 文档

# 2.4.2 门诊主流程消息推送

# 1. 接口说明

医院调用本接口推送4条门诊主流程消息（挂号成功通知、待缴费订单通知、检验检查报告、取药提醒）给用户，用户点击可访问医院相关服务的适老化页面。

此外，为了便利患者，我们也建议医院通过长辈就医下发停诊通知、排队候诊提醒、检验检查排队提醒、取消预约挂号通知和缴费成功通知。

注意事项：

1. 接口中status 值1501001、1501018、1501030、1501031、1501034分别对应预约挂号成功通知、门诊待缴费提醒、检查结果通知、检验结果通知、取药提醒这5条消息，是门诊就医主流程消息，必须下发；

2. status 值1501010、1501014、1501026、1501027、1501004、1501019分别对应停诊通知、排队候诊提醒、检查排号提醒、检验排号提醒、取消预约挂号通知、门诊缴费成功通知，是门诊就医体验优化类消息，建议下发；

3. 为给医院提供丰富的模板消息，同时减少医院对接的工作，本接口和就医助手共用同一套消息接口和模板库。曾经对接过就医助手的医院只需在原就医助手的基础上，提供适老化的网页链接或小程序页面路径，即可完成改造。

Demo示例：

医院调用本接口后，老年患者可在【微信长辈就医】公众号中收到院方下发的就医主流程消息，消息跳转到院方服务。

图11 微信长辈就医消息下发流程

# 2. 接口详情

参见微信就医助手消息能力

# 2.4.3 查询用户是否开通长辈就医功能

# 1. 接口说明

微信长辈就医功能需用户简单开通，用户有多种开通方式，包括：

路径1 访问医院公众号、小程序的适老版主页时开通，适老版主页生成方式参见2.5；

图12 医院公众号/小程序入口访问长辈就医服务

路径2 访问「微信」-「我」-「服务」-「城市服务」-「医疗」-「长辈就医」进行开通；

图13 微信城市服务入口访问长辈就医服务

路径3 关注“微信长辈就医”公众号，按指引开通。

图14 微信长辈就医公众号访问长辈就医服务

医院调用本接口可查询用户开通状态。

请注意：

1. 该开通流程无需医院开发，为微信统一流程；
2. 用户开通状态为“已开通”时，才可以获取用户实名信息和推送门诊主流程消息。

# 2. 接口详情

查询用户是否开通

# 2.5 医院适老版主页

医院参照文档完成前述流程开发后，可将适老化版本放在公众号、小程序上供老年用户访问，具体如下：

# 2.5.1 放置入口

为降低老年患者查找成本，建议将适老版入口放在医院微信公众号菜单或小程序首页。入口文案由医院自定义，可参考名称：长辈模式、长辈服务、关怀版。

图15 医院微信公众号/小程序长辈就医入口示例图

# 2.5.2 医院适老版主页生成

微信提供快速生成医院适老版主页的能力，无需额外开发，医院提供已开发好的挂号、缴费、查询报告、个人中心（挂号、缴费记录）功能链接/路径，即可快速生成适老版主页，供用户访问。

适老版主页主色调可自适应医院公众号主色值。

图16 医院适老版主页示例图

# 1. 公众号适老版主页生成方式

H5 的跳转链接为：

https://mp.weixin.qq.com/insurance/template/eldermedical/hospital-homepage.html?appid={appid}#wechat_redirect

链接上的 {appid} 需要替换成公众号的 appid。

# 2. 小程序适老版主页生成方式

wx.navigateToMiniProgram({
    appId: 'wx308bd2aeb83d3345',
    path: '/subPages/medical-mvp/hospital-homepage/main?appid={appid}',
    complete: (res) => {
      console.log('onTapToEldmHomePage res', res)
    }
});

# 三、验收材料和宣传物料

# 3.1 验收要求

为确保微信老年用户就医体验，微信团队将对本功能进行验收，可通过第五点联系我们获取验收指引。

# 3.2 宣传物料

为便利医院线下推广本功能，我们准备了易拉宝、桌贴、海报的源文件，医院可下载并二次制作，点击查看微信长辈就医宣传物料。

# 五、联系我们

对上述产品有任何疑问，欢迎联系我们。

# 六、修订记录

• 2024年03月20 日：消息推送接口与就医助手合并，原长辈就医消息接口即将下线；
• 2024年4月23 日：新增医院适老版主页调用说明，详见2.5；新增按视觉规范设计开发方式，详见2.3.2；