启用多用户应用内通话、Web 通话和视频通话

Amazon Connect 支持在现有通话中添加其他用户以加入应用内通话、网络通话和视频通话。您最多可以在一个正在进行的或预定的应用内通话、Web 通话或视频通话中再添加四名用户，达到总共六个参与者：座席、第一个用户和四个其他参与者（用户或座席）。

如何将参与者添加到多用户通话中

要启用多用户通话，您需要从 Amazon Connect 控制台启用增强的多方联系人监控。
完成后，您可以利用现有 Amazon Connect StartWebRTCContactAPI 创建联系人，并将此联系人路由给代理。
要添加其他参与者，请先创建一个ContactId从 StartWebRTCContactAPI 响应传入 API 的CreateParticipant参与者。 CreateParticipant在原始呼叫者连接到代理之前，不会成功。可以在 ParticipantDetails.ParticipantCapabilities 字段中为参与者设置视频和屏幕共享功能。
成功CreateParticipant完成后，它将返回参与者令牌。此令牌可以在Type设置为的请求中使用WEBRTC_CONNECTION。CreateParticipantConnection响应中包含ConnectionData哪些可用来加入会议的 Amazon Chime SDK 客户端库为创建的其他参与者创建的会议。按照集成说明进行操作，以允许您的应用程序最终用户加入会议。

注意
CreateParticipant如果代理尚未连接到联系人，则返回 Bad Request 错误。有关用户可能试图在连接座席之前加入的业务应用程序，请参阅处理并发用户加入。
其他客户可以在CreateParticipantConnection退货后随时连接。参与者加入后，所有其他语音和录音行为都与多方通话功能类似。如果请求中启用了新参与者的视频和屏幕共享功能，则他们可以启用他们的视频和屏幕共享。CreateParticipant

注意
任何时候总共只有 6 名参与者（客户和座席）可以加入正在进行的通话中。如果在加入会议过程中发生了添加超出限制的额外参与者的操作，则 Amazon Chime SDK 客户端库会返回一个状态码，指示该通话已满员。
在参与者连接到通话之后，如果他们正常断开连接，或者非正常断开连接持续了一段预配置的时间，则他们的参与者凭证将不再有效。如果客户端库onAudioVideoDidStop旁听者收到指示与会者不再有效的状态码，则应用程序可以触发CreateParticipant与CreateParticipantConnection您的业务后端的新呼叫以重新加入该呼叫。
每增加一个用户连接， Amazon Connect 就会创建一个新的联系人和联系人记录。所有其他联系人均已 PreviousContactId 设置为 InitialContactId （即由 StartWebRTCContactAPI 创建的联系人），以便将其追踪到原始联系人。每个联系记录具有以下特点：
- 有一个” InitiationMethod “:” WEBR TC_API”
- 包含以下分段属性：
```
   "SegmentAttributes": {
      "connect:Subtype": {
        "ValueString": "connect:WebRTC"
      }
    },
```
此外，每个联系记录都包含 CreateParticipant 中提供的显示名称。对于任何额外用户联系，不会填充座席信息。这是为了避免座席信息重复。

下图说明了在网络、应用程序内或视频通话中添加多个参与者和代理的场景中，如何映射上一个和下一个联系 IDs 人。

处理并发用户加入

企业可能希望创建允许用户以任何顺序、在任何时间加入的应用程序。例如，您的应用程序可能会向多个用户发送一封包含外部预约 ID 的链接的电子邮件，该链接应在预定时间被用户用于加入通话。为实现此行为，业务后端必须确保：

第一个加入的用户会触发 StartWebRTCContact 请求。
所有其他用户都使用 CreateParticipant 和， CreateParticipantConnection但仅在第一个用户连接到代理之后。

本节描述一个可能的实现，该实现假设您的业务后端包含一个存储（如 DynamoDB），用于保存关于预约会议的元数据。请注意，预约不是示例实现的功能 Amazon Connect，而是其中的一项功能。

当用户导航到该页面时，他们应该向后端发送一个请求。后端检查：

用户是否能够开始预约，以及时间是否正确。
Amazon Connect 联系人是否已通过呼叫创建StartWebRTCContact。

如果尚未创建联系人，则客户应使用自定义流程调用 StartWebRTCContactAPI，并提供一个属性，该属性表示预计将加入呼叫的相应座席的座席队列。该流应包含一个设置工作队列数据块，该数据块配置为使用属性中提供的座席队列。然后，该流应以转接到队列数据块来终止。在调用 API 之前，后端应以原子方式更新存储区，将调用从“无”状态移至“正在创建”状态，并处理任何并发修改异常。

StartWebRTCContact应将来自的凭证退还给客户，他们应立即加入通话。应在业务存储中将该联系标记为“已创建”，并保存其联系 ID。此业务 API 需要在所有可能加入的参会者之间实现同步。这可以通过使用数据库提供的原子操作来实现。

如果联系处于“正在创建”状态，则应该将该状态返回给额外用户，显示相关信息，并在短暂等待后重新尝试加入。

如果联系人已创建：他们应检索联系人 ID，然后调用 DescribeContactAPI。业务后端应查找 Contact.AgentInfo.ConnectedToAgentTimestamp 字段。如果该字段不存在，则表示第一个用户尚未连接到座席，并且额外用户应显示相关信息，在短暂等待后重新尝试。

如果该字段存在，则后端应调用 CreateParticipant CreateParticipantConnection，然后调用 get ConnectionData，如前几节所述。

后端工作流应看起来像下面这样。