# 微信就医助手消息能力

微信就医助手是为医院和医疗机构提供的定制化消息能力，它能够满足公立医院在微信中下发各就医场景全流程消息的需求，触达用户更高效，同时还有更丰富的扩展能力和接口。

## 一、就医助手介绍

微信就医助手功能，依托微信消息能力，为医院提供在服务通知中下发就医流程消息的能力，同时支持生成就诊流程可视化页面。

![](https://res.wx.qq.com/op_res/O67SEr1dbPDtyc-X5uyuVHsuGEXXBLEQECuhEmeq2i-dJ3A1QHoxchMJ9_7yEeqsN66n5RbKpv2KOovO1wbecQ)

## 二、开通就医助手

### 2.1 开通条件就医助手的主体

目前，就医助手支持主体类型为事业单位的公立医院，主体类型为政府的卫健委的公众号与小程序开通使用。

### 2.2 开通路径

医院公众号：登陆「公众号公众平台」，选择侧边栏功能中的「广告与服务」-「城市服务」-「行业能力」-「就医助手」，点击“开通功能”即可。

开通后，医院公众号即有就医助手所有接口调用权限。如果未找到城市服务入口，请在侧边栏「新的功能」中先寻找「城市服务」并添加。

医院小程序：需要同主体的公众号按照上述流程开通，开通后即可使用小程序用户openid下发消息

## 三、就医助手能力说明

### 3.1 模版申请与使用申请与使用

微信公众平台账号，开通就医助手能力后， 可使用[就医助手模版库](https://docs.qq.com/sheet/DQVFRd1N0VUtyVGtX?tab=BB08J2)内的所有模版，无需额外申请。

### 3.2 消息接收接收

就医助手消息将下发至每位用户的微信服务通知中，以医院主体下发，且可以在微信对话栏中显示通知条数。

### 3.3 落地页配置各项目配置方式

#### 3.3.1 顶部就医场景配置

如果同一个order_id下的消息

1. 全部为status“15010xx”的门诊就医流程消息（该order_id内可添加“15050xx”的诊后提醒，不影响就医场景判断），则此时会顶部展示此次就医为“本次门诊流程”
2. 全部为status“15020xx”的住院就医流程消息（该order_id内可添加“15050xx”的诊后提醒，不影响就医场景判断），则此时会顶部展示此次就医为“本次住院流程”
3. 全部为status“15030xx”的体检就医流程消息（该order_id内可添加“15050xx”的诊后提醒，不影响就医场景判断），则此时会顶部展示此次就医为“本次体检流程”
4. 全部为status“15040xx”的体检就医流程消息（该order_id内可添加“15050xx”的诊后提醒，不影响就医场景判断），则此时会顶部展示此次就医为“本次线上问诊流程”
5. 除上述order_id内的status组合外，其他组合方式，由于无法确定本次就医场景，均会展示为“本次就医流程”

#### 3.3.2 姓名与就诊卡号

用户姓名与就诊卡号来自于同一个order_id下status接口参数中的传参

#### 3.3.3 门诊流程中就医节点及其顺序

每一个新的order_id下的可视化页面，如果是门诊流程，门诊流程预设默认展示 挂号——诊前准备——门诊缴费——检验检查——诊后提醒 几个模块。每个status所属模块的对应关系请查看[此文档](https://docs.qq.com/sheet/DQVFRd1N0VUtyVGtX?tab=BB08J2)

#### 3.3.4 页面底部公众号与小程序跳转位

默认展示公众号，如果需要展示小程序跳转，则需要在通用消息接口的参数pageinfo中传入小程序的appid与路径，系统自动识别后展示该小程序的跳转位。公众号和小程序的跳转位均只有一个。

## 四、开发方式

### 4.1 接口调用方式方式

文档所有接口请求方式均为HTTPS-POST请求，UTF-8编码，请求和相应参数仅支持JSON数据格式，所有接口的调用均需要获取[access_token](/miniprogram/dev/server/API/mp-access-token/api_getaccesstoken.md)授权。

服务商获取access_token，走[微信开放平台-第三方平台](/doc/oplatform/Third-party_Platforms/2.0/product/Third_party_platform_appid.md)的模式，由医院为第三方服务商授权[「22城市服务」+「113就医助手」权限集](/doc/oplatform/Third-party_Platforms/2.0/product/offical_account_authority.md)，授权流程操作指引点击[这里](/doc/oplatform/Third-party_Platforms/2.0/operation/authorization/authorization_management.md)查看。

### 4.2 消息推送接口接口

就医助手 [消息推送接口](/miniprogram/dev/server/API/cityservice/medicalassistant/api_cityservice_sendchannelmsg.md)
