开放平台
生活号产品介绍
生活号是支付宝为企业、组织和个人提供的直接触达用户的服务平台，是用户连接世界的交互视窗。入驻的服务提供者可以通过此平台对用户进行信息推送、服务输出、交易场景打通和会员关系管理。
生活号拥有庞大的消费者群体，在每个支付宝账户的背后，都有着完善的资金渠道、充足的消费行为习惯数据，他们需要您来提供优质的商品和服务。
生活号主页样式如下：
产品特色
生活号的核心能力：
1. 精准的消息触达能力：生活号向目标用户精准推送各类信息服务，如业务待办、业务通知、营销活动、公告等；
2. 高度扩展的服务输出能力：生活号通过自定义菜单+H5实现高扩展性的服务能力输出，覆盖全行业的业务办理、信息查询、下单支付等各类功能服务；
生活号包含以下几大主要功能：
1）消息发送
2）商家会员号
3）事件订阅
4）基础信息设置
5）推广支持
6）获取用户信息
7）标签管理
8）自定义菜单
9）自定义扩展区
10）分组管理
下面就逐一针对这些主要功能进行详细说明。
消息发送功能
该功能解决服务提供者向用户精准推送各类信息服务的需求。生活号可以向目标用户推送业务待办、业务通知、营销活动、公告等消息。
1. 根据消息样式区分，生活号会推送以下类型的消息：
图文消息：可选择发送单图文或多图文
单图文 多图文
模板消息：仅用于生活号向用户发送重要的服务通知，只能用于符合其要求的服务场景中，如银行卡动帐通知，商品购买成功通知等（下图仅做为产品功能展示，不做为服务提供承诺）。
2. 根据消息发送对象区分，服务窗会推送以下类型的消息：
| 公开消息 |
所有访问生活号主页的用户均可见 |
| 群发消息 |
向全体粉丝发送的消息 |
| 组发消息 |
向粉丝中圈定的某一个或多个组粉丝发送的消息 |
| 单发消息 |
向某一个粉丝发送的消息 |
| 异步单发消息（客服消息） |
在有用户生活号操作的48小时内，与用户进行消息互动的接口。可以实现类似客服回复用户问题类的即时沟通功能。 |
3. 生活号消息收发规则
1）每天可以发送5条公开消息，未发送的不累积到第二天。
2）每周（周一~周日）可以向所有用户群组发送1条广播，但未发送的不累积到下周，下同。
3）每周（周一~周日）可以向分组用户发送5条广播。
4）每周最多可以发送6条广播（所有群发+分组发送），但是为防止对用户造成骚扰。您的粉丝每周仅能收到您发送给他的第一条广播。
5）通过生活号平台已经群发的广播内容（包括群发成功、或群发中的内容），发送30天内可以撤回、不支持修改，将永久保存。
（撤回的广播仍计算进本周的发送次数。）
4. 使用说明
生活号消息发送功能提供生活号后台配置发送及接口调用发送两种功能实现方式，具体使用方式如下表描述：
| 群发消息 |
|
| 单发模版消息 |
使用前提 相关接口：
|
| 异步单发消息（客服消息） |
|
调用该功能服务的业务输入/输出如下：
- 业务输入：用户身份标识(userid)+消息体内容+模板id
- 业务输出：生活号内模板消息
商家会员号功能
该功能用于将商家、机构的会员体系与生活号进行绑定，快速实现针对特定会员号的业务办理和信息查询功能。
商家会员号名称根据商家（生活号）的类型会有不同的展示，如银行类生活号的会员号名称一般为银行卡或者信用卡，运营商类生活号的会员号名称一般为手机号码，医疗机构生活号的会员号名称一般为就诊卡。
生活号目前只支持一个生活号绑定一个商家会员号。
1. 适用范围
该功能适用于比较大型的具有完善的会员体系的生活号，如银行机构、运营商、缴费机构、医院等，中小商家不建议使用该功能。中小商家如需实现会员绑定功能，只需要用户在登录商家网页时，记录用户的支付宝唯一身份标识userid即可，后续针对该用户标识进行免登处理。
2. 使用说明
用户在生活号中点击“添加商家会员号”菜单或服务窗入口，支付宝系统收到操作请求后将该动作通知给商家，商家根据此通知调用回复消息接口（其中须包含Url链接地址），支付宝收到商家的回复消息中的链接地址后，自动跳转至商家平台的商家会员绑定界面中，让用户完成账户绑定。 当用户有效完成账户绑定后，商家调用绑定商家会员号相关接口通知支付宝业务结果。
该功能涉及调用的接口如下：
事件订阅功能
该功能用于开发者根据业务需要选择性订阅支付宝网关推送的事件消息，从而简化业务模型，降低服务器负载。
开发者也可以订阅用户事件，针对事件返回相应消息，更好的服务用户。
1. 可供开发者订阅的事件类型
在下述场景中，生活号会向开发者网关发送消息。
1）事件消息
用户在与生活号交互的过程中会产生以下4种事件：
- 关注事件——用户关注生活号
- 取消关注事件——用户取消关注生活号
- 进入事件——用户进入生活号页面，包括用户点击和扫描二维码等方式进入生活号
- 菜单点击事件——用户点击某个菜单项
当开发者网关接收消息成功之后，请回复一条接收成功消息，详见消息交互体系。
2）文本消息
接收用户主动发送的纯文本消息，开发者可以使用异步单发消息功能向用户回复消息，实现诸如查询余额、推送最新优惠消息、客服等业务逻辑。
3）图片消息
接收用户主动发送的图片消息，开发者可以使用异步单发消息功能向用户回复消息，实现诸如查询余额、推送最新优惠消息、客服等业务逻辑。
2. 事件订阅设置：
- 进入开放平台管理中心，进入生活号应用配置详情页，找到“事件订阅与重试机制”；
- 点击“设置”按钮，在弹出的浮层上选择需要订阅的事件消息，去除不需要订阅的事件消息，点击“确定”即可完成订阅；
- 订阅完成之后立即生效，支付宝网关不再向开发者网关发送取消订阅的事件消息，比如取消订阅了图片消息，用户在服务窗中发送图片消息时，支付宝网关不再通知开发者网关；菜单点击事件及接入验证消息为特殊事件，不能取消订阅。
基础信息设置
该功能用于生活号基础信息设置，包括头像、名称等信息。
开发者可查询生活号名称、头像等基础信息，也可以修改服务窗名称、头像等基础信息，修改名称、头像需要上传相关资质材料，触发风控审核。
1. 使用说明
商家可以在服务窗后台配置或修改生活号基础信息，开发者也可以通过调用以下接口设置生活号基础信息：
推广支持
该功能用于服务提供者推广自己的生活号，获得有效的用户流量。服务窗平台提供以下几种推广手段，服务提供者可以根据自身需要进行选择使用。
- 推广短链接
- 二维码物料推广
- 支付成功推荐
1. 推广短链接
该功能用于在短信、H5活动页面上引导用户关注生活号，帮助生活号获得新增粉丝。
| 使用场景 | 备注 |
|---|---|
| 短信 | 服务提供者可以发短信给用户，在短信中附带推广短链接，引导用户关注生活号。 |
| 运营活动H5页面 | 线上活动页面如果需要跳转到生活号的链接，可以通过短链接自动生成。 用户点击跳转按钮后，会唤起支付宝，指向相应生活号。 |
| 运营活动H5页面——好友扩散 | 商家配置营销活动规则，在商品购买页面，用户每邀请一个用户购买该商品，将向用户返利。商家可以通过将带参短链接设在邀请好友按钮上，好友收到分享消息点击链接会在进入事件中带上邀请者的标志参数，从而判定当前访问用户是由哪个用户邀请过来的。 |
使用说明：
- 生活号后台配置
- 使用接口——带参推广短链接
2. 二维码物料推广
二维码可布设在线下物料宣传中，可以引导用户关注生活号及使用其功能。
3. 支付成功推荐
支付成功推荐指商户可以设置一些收款账号，当用户通过当面付或者在支付宝钱包中的h5页面通过手机网站支付（使用支付宝钱包自带的支付成功页）向这些收款账号付款后，将根据规则推荐用户关注该生活号。
使用说明：
- 生活号后台配置
- 使用接口——带参推广二维码
获取用户信息
该功能用于生活号商家获取用户的相关信息，便于生活号进行精准营销，提升用户体验，实现更多业务功能。
开发者可以通过国际标准的OAuth2.0授权机制，在用户授权的情况下，得到用于换取用户信息的令牌（详见获取用户信息）。在拿到用户的授权令牌后，可以调用用户信息共享接口，获取用户信息，包括用户ID、昵称、性别、省份、城市、用户头像信息等，便于开发者实现针对特定人群的精准化营销； 也可以调用通讯录信息接口，得到基于用户手机通讯录的好友信息（仅限同时关注该生活号的好友），便于在生活号内让两位好友进行互动。生活号还提供了用户进入生活号时的地理位置信息，可以帮助商家提供基于用户地理位置的服务。
1. 应用案例
顺丰速运生活号在快递寄送服务中调用获取用户收货地址接口(JS接口)，用户无需手动录入，直接选择存储在支付宝端的收货地址，快递寄送体验大为改善。
2. 使用说明
获取用户信息涉及的接口如下：
标签管理
标签用于描述支付宝用户的各种特征，包括自定义标签(开发者自主创建维护的标签)与通用标签(支付宝给每个用户指定的标签，如性别、职业等)。生活号开发者可以通过标签管理相关接口创建、修改、删除自定义标签，也可以批量给用户添加标签值或者删除标签值。每个支付宝用户对应每个标签最多只有一个标签值，通过自定义标签，开发者可以预先将与自己相关的用户打上各种标签值，来进行后续的个性化操作，如个性化菜单展示、个性化扩展区展示、用户分组创建等。
使用范围
若商户需要实现不同的用户在自己的生活号中看到不同的菜单与扩展区，享受不同的功能，或者需要使用接口对用户进行分组，推送分组消息，可以使用此类接口实现。
使用实例
某银行商户生活号调用创建标签接口创建了“开卡省份”标签，然后该商户调用个性化菜单创建接口创建了一套菜单，该菜单指定“开卡省份”为“浙江”的用户可见，再用个性化扩展区创建接口创建了一套个性化扩展区，该套扩展区也指定“开卡省份”为“浙江”的用户可见。
用户张三在浙江省该银行某网点办理了一张银行卡，办卡时填写了自己的手机号码和身份证号码，之后商户调用用户打标接口指定该用户的“开卡省份”标签值为“浙江”。若该用户进入此银行生活号，则会看到之前创建的个性化菜单与扩展区，另一用户进入此生活号，未匹配到任何个性化菜单与扩展区，则会展示默认的菜单与扩展区。
该功能涉及调用的接口如下：
自定义菜单功能
该功能解决服务提供者向用户提供各类功能服务的需求，如各类业务办理、信息查询等。设置合理的菜单能够让用户更方便的使用您提供的服务，也可以让用户更便捷的了解到您的营销信息、帮助信息。
生活号菜单分为文本菜单和icon菜单2种，在客户端展示效果分别如下图：
默认菜单与个性化菜单
- 默认菜单：在生活号后台（fuwu.alipay.com）“菜单管理”页面手动设置的菜单或者通过默认菜单创建接口创建的菜单。每个生活号必须有一条发布的默认菜单，否则生活号将无法上架。商户可以选择创建一套文本或者icon菜单作为生活号的默认菜单，当普通用户进入生活号主页后，若未命中个性化菜单，将展示当前的默认菜单。
- 个性化菜单：开发者可通过个性化菜单创建接口创建个性化菜单，开发者需要先通过标签管理相关接口来创建自定义标签并给指定的用户打上对应的标签值，然后创建展现给某个指定标签值用户的个性化菜单，当满足这一标签条件的用户进入该生活号主页时，会展示该条个性化菜单，通过这些接口，开发者可以实现不同特点的用户看到不同菜单的功能。
菜单配置规则
- 最多可添加4个主菜单。如开通对话功能，则最多只能添加3个主菜单；每个主菜单下最多可以添加5个主菜单。
- 对话功能首次设置菜单时，是默认打开的，用户可以取消或再开启；
- 无子菜单时，主菜单可以设置对应的功能；有子菜单时，主菜单无功能，仅能够展开显示子菜单项功能；
- 菜单支持跳转到指定网址，拨打手机号码，发送一条图文广播，在地图中显示您的门店，转账给您，显示用户与您的支付宝消费记录。如果您具有开发能力，还可以设置“调用服务”类型的菜单，用户点击这种菜单时，会触发菜单点击事件，支付宝会将用户的点击行为推送到商户的应用网关，商户可以根据这一通知实现自己的业务逻辑；
- 菜单发布后，不可取消，只能再编辑。
- 在有必要的情况下，例如服务更新、活动更新，需要您同步更新菜单。
- 若当前生效的菜单为icon菜单，但是用户客户端版本低于0.12时，我们会自动将该套icon菜单转换成对应的文本菜单。
- 以前的服务窗样式只支持文本菜单。
菜单配置方法
自定义扩展区功能
生活号扩展区是生活号菜单下的一片区域，是供商户自主配置的广告位，商户可以将自己的广告活动以及网页等配置在扩展区域，来更好的吸引用户点击，扩展区分为h5与图片扩展区两种，在客户端的效果图如下：
默认扩展区与个性化扩展区
- 默认扩展区：在生活号后台（fuwu.alipay.com）设置的扩展区或者通过默认扩展区创建接口创建的扩展区，和默认菜单不同，生活号不要求必须设置扩展区。
- 个性化扩展区：开发者可通过个性化扩展区创建接口创建个性化扩展区，开发者需要先通过标签管理相关接口来创建自定义标签并给指定的用户打上对应的标签值，然后创建展现给某个指定标签值用户的个性化扩展区，当满足这一标签条件的用户进入该生活号主页时，会展示该条个性化扩展区，通过这些接口，开发者可以实现不同特点的用户看到不同扩展区的功能。
扩展区配置规则
- 每套扩展区最多只能有3条。
- 生活号后台操作的扩展区是默认扩展区，且是一条一条操作的，接口可以操作默认扩展区或个性化扩展区，且是一套一套操作的。
- 生活号后台创建的扩展区需要点击上线之后才生效，通过接口创建的扩展区，创建完成之后即生效。
扩展区配置方法
- 生活号后台设置
- 扩展区接口设置
分组管理功能
用户分组可以理解为一个圈人规则，是基于标签进行构建的，目前已经同时支持支付宝通用标签和商户自定义标签。商户利用分组可以在粉丝中圈出符合该圈人规则的人群，进行精准营销。开发者可以对用户分组进行查询、修改、创建、删除、查询分组人群数量等操作，还可以针对分组人群发送消息。
分组消息发送
用户消息发送接口可以根据分组实时圈定人群并发送消息，消息类型支持纯文本、纯图片、图文消息。
每周每个生活号只能发送5条分组消息和一条群发消息，且每个用户只能收到一条分组或群发消息，若商户既需要发送分组消息又需要群发消息，建议先发送分组消息，再发送群发消息。
分组配置方法
准入条件
您只需要完成以下三步，即可开启生活号之旅，如下图所示：
生活号产品需要签约使用，签约准入说明如下：
若您是企业账号，授权运营为可选填项，当需要使用其他公司持有的品牌或商标作为生活号名称时，需要上传对应资料；生活号暂时不支持以下类别商家入驻（如有疑问可联系客服咨询）：
- 彩票类；
- 一般媒体（电视、广播、报纸、周刊杂志、户外媒体和自媒体）类；
- 火车票；
- P2P、基金公司、券商。
若您是个人账号，由于生活号平台是一个商业化平台，所以目前仅支持个体工商家、电商网站所有者和应用所有者入驻，需要提供以下资质证明任意之一：
- 淘宝、1688同名店铺链接；
- 有备案一致的商业网站；
- 线下实体店铺提供个体工商家营业执照及实体店照片三张（招牌、门牌号、内景）；
- 已经在应用市场上架的App应用开发者。
计费模式
生活号为免费产品，如您在生活号中需要使用支付宝的支付服务，需要签约对应的支付宝产品。生活号常用的支付产品为手机网站支付。
服务窗升级为生活号
服务窗可升级为生活号，在 fuwu.alipay.com 进行升级，升级为生活号的服务窗不能再回退到服务窗。
具体升级流程如下：
1. 登录 fuwu.alipay.com 选择升级
2. 浏览升级说明页，确认升级
3. 补充信息完成升级
本接口及文档资料由支付宝提供。您使用本接口，需要遵守开放平台相关协议及支付宝要求。
