本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 设置 WhatsApp 企业消息
本节中的主题说明了如何设置和测试 Amazon Connect 的 WhatsApp 企业消息。您可以使用 [AWS 最终用户消息社交](https://docs.aws.amazon.com/social-messaging/latest/userguide/what-is-service.html)将 WhatsApp 企业账户和电话号码关联到 Amazon Connect 实例，然后将关联的电话号码导入 Amazon Connect。然后，客户可以使用 WhatsApp 向您的呼叫中心发送消息。
您还可以使用 Amazon Lex 自动回复客户的问题，从而节省座席的时间和精力。有关更多信息，请参阅《Amazon Lex 开发人员指南》**中的 [Amazon Lex 入门](https://docs.aws.amazon.com/lexv2/latest/dg/getting-started.html)。
**Topics**
+ [前提条件](#whatsapp-prerequisites)
+ [步骤 1：启用 Amazon Connect 作为事件目标](#enable-connect-destination)
+ [步骤 2：在您的电话号码上配置入站联系流](#inbound-contact-flow)
+ [步骤 3：发送和接收测试消息](#send-receive-test-messages)
+ [后续步骤：准备上线](#whatsapp-next-steps)
+ [对常见问题进行排查](#whatsapp-troubleshooting)
+ [WhatsApp Amazon Connect 的商业消息功能和限制](whatsapp-messaging-capabilities.md)
## 前提条件
在 WhatsApp 与 Amazon Connect 集成之前，您必须具备以下物品：
+ WhatsApp 企业账户。
+ 一个 WhatsApp 电话号码。该号码必须能够接听语音通话或短信，才能完成 Meta 的 WhatsApp 商务消息电话号码验证流程。您可以使用 Amazon Connect 语音 AWS End User Messaging SMS 号码或号码作为 WhatsApp 电话号码。您也可以使用自己在外部拥有的电话号码 AWS。
使用 Amazon Connect 语音 AWS End User Messaging SMS 号码或号码时，我们建议您申请一个未用于实时语音或短信流量的新号码，以免服务中断。
您可以使用 AWS 最终用户消息社交控制台[https://console.aws.amazon.com/social-messaging/](https://console.aws.amazon.com/social-messaging/)来创建 WhatsApp 企业账户和电话号码。有关更多信息，请参阅 *AWS 最终用户消息社交用户指南 WhatsApp*中的[注册](https://docs.aws.amazon.com/social-messaging/latest/userguide/getting-started.html#getting-started-embedded)。
**重要**
WhatsApp 具有自动业务验证流程，最长可能需要 2 周才能完成。 我们建议您尽早开始此过程。 WhatsApp 如果违反了 WhatsApp 企业政策或无法验证 WhatsApp 企业身份，则可以禁用企业账户。
此外，我们强烈建议您在创建和关联 WhatsApp 资源之前查看 [AWS 最终用户消息社交WhatsApp ](https://docs.aws.amazon.com/social-messaging/latest/userguide/best-practices.html)[的最佳实践和最佳实践](https://business.whatsapp.com/policy#best_practices)。
在创建账户和电话号码后，按所列顺序完成以下各节中的步骤。
## 步骤 1：启用 Amazon Connect 作为事件目标
以下步骤说明了如何使用 AWS 最终用户消息社交来启用 Amazon Connect 作为关联 WhatsApp 企业账户的事件目的地。这使系统能够导入您的 WhatsApp 电话号码。
您可以使用[AWS 最终用户消息社交控制台](https://console.aws.amazon.com/social-messaging/)或 AWS CLI 来完成此任务。要使用 AWS CLI，请参阅[https://docs.aws.amazon.com/connect/latest/APIReference/API_ImportPhoneNumber.html](https://docs.aws.amazon.com/connect/latest/APIReference/API_ImportPhoneNumber.html)《*Amazon Connect API 参考*》和[https://docs.aws.amazon.com/social-messaging/latest/APIReference/API_PutWhatsAppBusinessAccountEventDestinations.html](https://docs.aws.amazon.com/social-messaging/latest/APIReference/API_PutWhatsAppBusinessAccountEventDestinations.html)《*AWS 最终用户消息社交 API 参考*》。
以下几个步骤说明了如何使用该控制台。
**要使用 控制台**
1. 登录 AWS 最终用户消息社交控制台，网址为[https://console.aws.amazon.com/social-messaging/](https://console.aws.amazon.com/social-messaging/)。
1. 在导航窗格中，选择**WhatsApp 企业账户**，然后选择所需的账户。
1. 在**事件目标**选项卡上，选择**编辑目标**。
1. 对于**目标类型**，选择 **Amazon Connect**。
1. 对于 **Connect 实例**，请从下拉列表中选择您的 Amazon Connect 实例。
1. 对于**角色 ARN**，请选择一个 IAM 角色，该角色会授予传递消息和事件以及导入电话号码的权限。对于示例 IAM 策略，请参阅《AWS 最终用户社交消息用户指南》**中的[将消息和事件目标添加到 AWS 最终用户社交消息中](https://docs.aws.amazon.com/social-messaging/latest/userguide/managing-event-destinations-add.html#managing-event-destinations-amazon-connect-policies)。
1. 选择**保存更改**。
这样会开始将电话号码导入 Amazon Connect 的过程。
该操作完成后，该号码将显示在 Amazon Connect 管理员网站中。
**查看号码**
+ 在导航窗格上，选择**渠道**，然后再选择**电话号码**。
显示所有 WhatsApp 号码的 “**活动频道**” **WhatsApp**列。
## 步骤 2：在您的电话号码上配置入站联系流
您可以创建用于 WhatsApp 电话号码的入站联系流，也可以重复使用现有流程。如果您重复使用某个流，则可以添加 `CheckContactAttribute` 数据块并为该流启用分支。该屏蔽允许您将 WhatsApp 联系人发送到特定队列或采取其他操作。
有关构建联系流的更多信息（包括互动式消息和富链接预览），请参阅本节后面的 [WhatsApp Amazon Connect 的商业消息功能和限制](whatsapp-messaging-capabilities.md)。
以下几组步骤说明了如何配置入站联系流并向该流中添加 `CheckContactAttribute` 数据块。
**配置流**
1. 在以下位置启动 Amazon Connect 控制台 [https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/)
1. 在导航窗格上，选择**渠道**，然后再选择**电话号码**。
1. 选择 WhatsApp 数字，然后选择 “**编辑”**。
1. 在**流/IVR** 下，选择您更新的流。
1. 选择**保存**。
**添加 CheckContactAttribute 数据块**
1. 请按照[前面部分中](#enable-connect-destination)的步骤 1–4 执行操作。
1. 打开流的**属性**页面。
1. 在**要检查的属性**部分，将**命名空间**设置为**分段属性**，并将**键**设置为**子类型**。有关分段属性的更多信息，请参阅本指南后面的 [SegmentAttributes](ctr-data-model.md#segmentattributes)。
1. 在 “**要检查的条件**” 部分中，将**条件**设置为 “**等于**”，**将连接**值**设置为：WhatsApp**。
1. 选择**保存**。
## 步骤 3：发送和接收测试消息
在此步骤中，您将使用联系人控制面板 (CCP) 和移动电话发送和接收 WhatsApp 测试消息。
**测试集成**
1. 在 CCP 中将您的状态设置为**可用**。
1. WhatsApp 在移动电话上使用，输入之前添加的电话号码开始对话。
下图显示了一条带有**选项**的消息，以及由此产生的选项列表。
## 后续步骤：准备上线
在您测试集成之后，我们建议您在 WhatsApp 消息渠道中添加以下特性和功能。
### 添加 Amazon Connect 功能
以下列表中的链接将带您了解有关 Amazon Connect 功能的信息，您可以将这些功能添加到您的客户和座席体验中。
+ 了解有关 [WhatsApp Amazon Connect 的商业消息功能和限制](whatsapp-messaging-capabilities.md)的更多信息。
+ [让客户能够在 Amazon Connect 中恢复聊天对话](chat-persistence.md) – 客户可以继续之前的对话，同时保留上下文、元数据和转录。客户回到聊天时无需重复之前的话，座席可以访问整个对话历史记录。
+ [创建供 Amazon Connect 中的聊天和电子邮件联系人使用的快速响应](create-quick-responses.md) – 为座席提供对常见客户询问的预先撰写的响应，供他们在与客户聊天时使用。快速响应使座席可以更快地响应客户。
### 添加入口点
以下列表中的链接将带您了解有关添加不同类型客户入口点的信息。
+ 切入点：[引导潜在客户和客户进行业务消息对话的 5 种方法](https://business.whatsapp.com/blog/messaging-app-entry-points)（WhatsApp博客文章）
+ 二维码：[管理您的 WhatsApp 企业平台二维码](https://business.facebook.com/business/help/890732351439459)（Meta 帮助文章）
+ Click-to-WhatsApp广告：在[广告管理器 WhatsApp 中创建可点击的广告](https://business.facebook.com/business/help/447934475640650?id=371525583593535)（Meta 帮助文章）
### 在您的电话号码中添加显示名称
要添加客户看到的经过验证的显示名称，请在 Meta 帮助中查看[关于 WhatsApp 企业显示名称](https://business.facebook.com/business/help/338047025165344)。
### 扩展流量
在将实时流量引 WhatsApp 入集成后，我们建议您监控以下配额。
**Amazon Connect 配额**
有关默认配额以及提高默认配额的更多信息，请参阅 [Connect Customer 服务配额](amazon-connect-service-limits.md)。
+ [每个实例的并发活动聊天数](amazon-connect-service-limits.md#concurrent-active-chats)配额。有关监控此配额的信息，请参阅[使用监控您的 Amazon Connect 实例 CloudWatch](monitoring-cloudwatch.md)。
+ [StartChatContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartChatContact.html) 限制配额。
+ [SendChatIntegrationEvent](https://docs.aws.amazon.com/connect/latest/APIReference/API_SendChatIntegrationEvent.html) 限制配额。
+ `SendIntegrationEvent` 限制配额。AWS 最终用户消息社交使用的一种仅限权限的 API，用于发布入站 WhatsApp 事件。
**最终用户社交消息配额**
AWS 最终用户消息社交对多条消息 APIs强制执行速率限制。监控以下内容 APIs ，查看是否需要更改一个或多个配额。这些链接会带您进入 *AWS 最终用户社交消息 API 参考*。
+ [SendWhatsAppMessage](https://docs.aws.amazon.com/social-messaging/latest/APIReference/API_SendWhatsAppMessage.html)
+ [PostWhatsAppMessageMedia](https://docs.aws.amazon.com/social-messaging/latest/APIReference/API_PostWhatsAppMessageMedia.html)
+ [GetWhatsAppMessageMedia](https://docs.aws.amazon.com/social-messaging/latest/APIReference/API_GetWhatsAppMessageMedia.html)
有关增加 AWS 最终用户社交消息配额的更多信息，请参阅《AWS 最终用户社交消息用户指南》**中的以下主题：
+ [AWS 最终用户社交消息的配额](https://docs.aws.amazon.com/social-messaging/latest/userguide/quotas.html)
+ [提高消息对话限制 WhatsApp](https://docs.aws.amazon.com/social-messaging/latest/userguide/increase-message-limit.html)
+ [提高消息吞吐量 WhatsApp](https://docs.aws.amazon.com/social-messaging/latest/userguide/increase-message-throughput.html)
## 对常见问题进行排查
使用以下信息对 WhatsApp集成的常见问题进行故障排除。
**Topics**
+ [无法在您的 Amazon Connect 实例中看到导入的电话号码](#no-imported-number)
+ [来自客户的入站消息未送达](#whatsapp-messages-not-delivered)
### 无法在您的 Amazon Connect 实例中看到导入的电话号码
如果您导入的号码未能显示在 Amazon Connect 管理员网站上，请按照以下步骤操作：
+ 确保事件目标 IAM 角色具有必要的权限。有关更多信息，请参阅 [步骤 1：启用 Amazon Connect 作为事件目标](#enable-connect-destination)。
+ 查看是否需要提高*每个实例的电话号码数*配额。有关更多信息，请参阅 [Connect Customer 服务配额](amazon-connect-service-limits.md)。
+ 要将关联的 WhatsApp 企业账户重新分配给其他 Amazon Connect 实例，您必须先释放从原始 Amazon Connect 实例导入的电话号码。电话号码发布后，您可以将关联的 WhatsApp 企业账户上的活动目的地更新为另一个 Amazon Connect 实例。
**重要**
请勿发布处理实时客户流量的号码。相反，应[申请新的电话号码](https://docs.aws.amazon.com/connect/latest/adminguide/claim-and-manage-phonenumbers.html)。
+ 为了帮助确定导入问题的原因，请在 CloudTrail 日志中搜索`ImportPhoneNumber`事件并查看错误详情。如果 `ImportPhoneNumber` 调用成功，您可以调用 `DescribePhoneNumber` 以获取其他错误详情。
如果您进行了修复，则必须重新导入相应电话号码。为此，请重复[步骤 1：启用 Amazon Connect 作为事件目标](#enable-connect-destination)。
### 来自客户的入站消息未送达
如果 WhatsApp 入站邮件停止传送，请在 AWS CloudTrail 日志中`SendChatIntegrationEvent`搜索错误详情。`SendIntegrationEvent`
您还可以检查以下常见情境：
+ 确保您在 AWS 最终用户消息社交中关联的 WhatsApp 企业账户已启用 Amazon Connect 事件目的地。
+ 确保您的事件目标 IAM 角色具有必要的权限。有关更多信息，请参阅本部分前面的[步骤 1：启用 Amazon Connect 作为事件目标](#enable-connect-destination)。如果 API CloudTrail 引发`AccessDeniedException`错误，则您的角色配置不正确。`SendIntegrationEvent`
+ 确保您的 WhatsApp 电话号码成功导入到您的 Amazon Connect 实例，并且该号码具有关联的入站联系流程。有关更多信息，请参阅 [步骤 2：在您的电话号码上配置入站联系流](#inbound-contact-flow)。
+ 入站消息已被删除，因为它们尚不受支持。有关更多信息，请参阅 [WhatsApp Amazon Connect 的商业消息功能和限制](whatsapp-messaging-capabilities.md)。