# 将 Wallet 凭证连接到 Apple Messages

为客户提供一张可保存并随时打开的凭证，用于预约、活动或服务。将签发的凭证连接到拥有其详细信息的记录，然后添加一个 Messages 入口以便就该任务获取帮助。

## 前提条件

准备好企业的凭证签发方和签名配置、预约或服务系统，以及已获批准的 Apple Messages 企业。指定负责凭证签发、更新和客户支持的人员。使用获授权的测试环境和测试设备。

## 1. 选择服务记录

从一条已确认的预订或服务开始。确定需要显示在凭证上的字段：可识别的商家名称、日期、时间、地点和有用的参考编号。从拥有该服务的记录中获取这些值。

将待确认的预订与已确认的预订区分开。凭证应反映客户可以信赖的状态。当凭证代表一个预约时，请遵循[预约指南](/docs/guides/apple-messages/appointments)。

## 2. 准备签发和更新

将凭证签发方连接到服务记录，并保留原始凭证与该记录之间的关联。配置品牌信息以及客户在使用时需要的详细内容。遵循 Apple 的[凭证标识符和签名要求](https://developer.apple.com/help/account/capabilities/create-wallet-identifiers-and-certificates)以及签发方的分发工作流。配置[凭证更新服务](https://developer.apple.com/documentation/walletpasses/adding-a-web-service-to-update-passes)，以便变更能推送到现有凭证。

在目标设备上测试已签发的凭证。确认显示的详细信息与服务记录一致，并在正常文字大小下保持可读。

## 3. 添加对话入口

将凭证连接到已获批准的 Apple Messages 企业，并设置相关服务意图和接收组。为任务使用安全的引用标识；公开 URL 中不得包含账户凭据或受保护的详情。

打开凭证入口，发送第一条消息，并确认目标团队收到了对话。通过正常的身份验证流程获取受保护的预订或账户信息。使用[入口指南](/docs/guides/apple-messages/entry-points)了解上下文和路由。

## 4. 在业务操作成功后更新

当客户更改预约时，验证可用性并在预订系统中确认变更。使用记录的时间和地点更新现有凭证。保存的凭证和对话现在应描述同一个预约。

如果预订结果不确定，在发出新的更新之前检查原始操作。不要用未确认的请求替换已确认的时间。

## 5. 测试取消和支持

取消一个测试预订，确认凭证反映了已取消的状态。检查过期、地点变更、更新服务不可用以及客户通过其他渠道继续操作的情况。保留一种联系服务团队的有效方式。

保存凭证并不构成发送邀请消息的许可。将[邀请同意和审批流程](/docs/guides/apple-messages/invitations)与凭证分发分开管理。

## 端到端验证凭证更新

保存一张经授权的示例凭证，然后在预订系统中更改预约。通过凭证服务使用相同的凭证标识发布新的凭证内容，并在设备上验证更新后的详细信息。同时检查 Messages 中面向客户的确认信息；它应描述预订系统所记录的变更。

| 测试用例             | 操作                               | 预期结果                                             |
| -------------------- | ---------------------------------- | ---------------------------------------------------- |
| 客户未保存凭证       | 在对话中保留已确认的预约详细信息。 | 客户无需添加凭证即可使用服务。                       |
| 签发后预约发生变更   | 在预订变更成功后更新现有凭证。     | 凭证保留其标识并显示新的已确认详细信息。             |
| 客户打开商家联系入口 | 将相应的服务上下文带入对话。       | 接收团队可以识别该次访问，而不会暴露无关的账户数据。 |

## 故障排查

如果凭证内容不是最新的，在生成替代凭证前先比较业务记录、签发方状态和更新结果。如果其 Messages 链接连接到错误的团队，请检查企业身份和入口上下文。如果客户无法添加凭证，通过适当的其他方式提供已确认的服务详情。

## 后续步骤

- [探索 Wallet 凭证与 Messages](/products/apple-messages/wallet)。
- [连接预约预订](/docs/guides/apple-messages/appointments)。
- [构建完整流程](/docs/guides/apple-messages/journeys)。

## Related resources

- [What is Apple Messages for Business?](/explained/apple-messages/what-is-apple-messages-for-business) (answer)
- [Apple Messages for Business](/products/apple-messages) (product)
- [Integrate an Apple Messages customer journey](/docs/guides/apple-messages/api) (docs)

[Get an implementation brief](/learn/workspace?topic=apple-messages)