# 微信就医助手消息能力

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

## 就医助手介绍

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

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

## 开通就医助手

### 可以开通就医助手的主体

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

### 开通路径

医院服务号：登陆「服务号公众平台」，选择侧边栏功能中的「广告与服务」-「城市服务」-「行业能力」-「就医助手」，点击“开通功能”即可，开通后，医院服务号即有就医助手所有接口调用权限。如果未找到城市服务入口，请在侧边栏「新的功能」中先寻找「城市服务」并添加。

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

## 就医助手能力说明

### 模版申请与使用

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

### 消息接收

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

### 就医助手落地页各项目配置方式

**顶部就医场景配置**

如果同一个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组合外，其他组合方式，由于无法确定本次就医场景，均会展示为“本次就医流程”

**姓名与就诊卡号**

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

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

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

**页面底部服务号与小程序跳转位**

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

## 开发方式

### 接口调用方式

文档所有接口请求方式均为HTTPS-POST请求，UTF-8编码，请求和相应参数仅支持JSON数据格式，所有接口的调用均需要获取[access_token](/doc/subscription/api/base/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)。

### 消息推送接口

就医助手消息下发接口请求，由 通用消息接口+子状态status 的参数组合而成，通用消息接口是调用每种消息都必须填写的接口参数，子状态status是调用每种不同业务流程消息所需要填写的接口参数

| 接口名称 | 请求路径 | 描述 |
| --- | --- | --- |
| [消息推送接口](/doc/subscription/api/medicalassistant/api_cityservice_sendchannelmsg.md) | /cityservice/sendchannelmsg | 用于下发就医助手消息，结合通用参数和不同子状态status参数组合实现各类业务消息推送，要获取所有status参数，请查看微信就医助手开发文档 |