# 微信就医助手消息能力
微信就医助手是为医院和医疗机构提供的定制化消息能力,它能够满足公立医院在微信中下发各就医场景全流程消息的需求,触达用户更高效,同时还有更丰富的扩展能力和接口。
# 就医助手介绍
微信就医助手功能,依托微信消息能力,为医院提供在服务通知中下发就医流程消息的能力,同时支持生成就诊流程可视化页面。
# 开通就医助手
# 可以开通就医助手的主体
目前,就医助手支持主体类型为事业单位的公立医院,主体类型为政府的卫健委的公众号与小程序开通使用。
# 开通路径
医院公众号:登陆「公众号公众平台」,选择侧边栏功能中的「广告与服务」-「城市服务」-「行业能力」-「就医助手」,点击“开通功能”即可,开通后,医院公众号即有就医助手所有接口调用权限。如果未找到城市服务入口,请在侧边栏「新的功能」中先寻找「城市服务」并添加。
医院小程序:需要同主体的公众号按照上述流程开通,开通后即可使用小程序用户openid下发消息
# 就医助手能力说明
# 模版申请与使用
微信公众平台账号,开通就医助手能力后, 可使用就医助手模版库内的所有模版,无需额外申请。
# 消息接收
就医助手消息将下发至每位用户的微信服务通知中,以医院主体下发,且可以在微信对话栏中显示通知条数。
# 就医助手落地页各项目配置方式
顶部就医场景配置
如果同一个order_id下的消息
全部为status“15010xx”的门诊就医流程消息(该order_id内可添加“15050xx”的诊后提醒,不影响就医场景判断),则此时会顶部展示此次就医为“本次门诊流程”
全部为status“15020xx”的住院就医流程消息(该order_id内可添加“15050xx”的诊后提醒,不影响就医场景判断),则此时会顶部展示此次就医为“本次住院流程”
全部为status“15030xx”的体检就医流程消息(该order_id内可添加“15050xx”的诊后提醒,不影响就医场景判断),则此时会顶部展示此次就医为“本次体检流程”
全部为status“15040xx”的体检就医流程消息(该order_id内可添加“15050xx”的诊后提醒,不影响就医场景判断),则此时会顶部展示此次就医为“本次线上问诊流程”
除上述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授权。
服务商获取access_token,走微信开放平台-第三方平台的模式,由医院为第三方服务商授权[22城市服务]+[113就医助手]权限集,授权流程操作指引点击这里查看。
# 消息推送接口
就医助手消息下发接口请求,由 通用消息接口+子状态status 的参数组合而成,通用消息接口是调用每种消息都必须填写的接口参数,子状态status是调用每种不同业务流程消息所需要填写的接口参数
接口名称 | 英文名 | 请求路径 |
---|---|---|
就医助手通用消息推送接口 | cityservice_sendchannelmsg | /cityservice/sendchannelmsg |