支付宝生活号对接指南

UMS 目前支持支付宝生活号的模板消息，图文消息类型在后续计划中，敬请期待。

申请生活号

详细步骤参考官方接入文档

1、支付宝仅支持企业账号（如企业、政府/社会组织、个体工商户）创建生活号，使用企业的支付宝账号登录生活号平台进行创建，创建成功后将获取到 APPID。（登录生活号平台后，在首页右上角即可查看 APPID）

2、生成 RSA 秘钥，其中 Private Key 私钥需要填写至 UMS 支付宝生活号的通道信息中。

3、激活开发者模式，详细步骤参考官方接入文档

4、获取生活号接口权限 进入支付宝开放平台，在应用列表找到该生活号，点击进入管理页面，添加生活号能力

添加模板

在生活号管理平台，选择「模板消息」，在模板库中添加消息的模板，如果没有需要的，也可以申请新的模板，审核周期为 3-7 天。

添加模板后，查看模板的详情，复制「模板ID」「模板名称」「关键字段」，粘贴至 UMS 即可导入模板，以便于在推送时选择。

因支付宝未提供查询获取模板列表信息的 API，因此在支付宝平台删除模板后，UMS 无法检测到状态改变，只有当 UMS 在使用该模板推送消息时，若支付宝平台反馈模板不存在，才会将该模板状态变为无效。

上传 userID

1、使用支付宝的会员能力获取 userID，并将 userID 上传至 UMS。

2、上传支付宝 userID 时，绑定标识 bind_id 为通道编码。

• 极光提供了一个程序可协助开发者获取用户列表，下载 pushtools 工具（ Linux 版本或 Mac 版本），在控制台输入如下命令，填写上具体的 AppID 和 PrivateKey 即可

          ./pushtool alipay -appid xxx -privatekey xxx

        

3、假设在 UMS 创建通道时设置的通道编码为：alipaylife123，则上传信息至 UMS 平台的示例如下：

• 在 UMS 控制台上点击文件上传，支付宝生活号 userID 在 UMS 中的命名是：alipaylife_userid，Excel 内容参考：
  
  
• 调用 rest API 上传的 JSON 示例如下，详情请参考 rest API - 用户管理
  [{ "userid": "zhangsan", "set":{ "alipaylife": { "alipaylife123":"123456" } } }]

            [{
    "userid": "zhangsan",
    "set":{
        "alipaylife": {
            "alipaylife123":"123456"
        }
    }
  }]
  
          

  此代码块在浮窗中显示

发送消息

配置成功后即可开始使用官网控制台发送消息，阅读控制台操作指南

还可以调用 API 进行发送，阅读 REST API 文档