配置亚马逊 EventBridge 集成

安装亚马逊 EventBridge 后，Genesys 云管理员必须添加和配置亚马逊 EventBridge 源集成。 管理员必须先添加集成，然后配置并激活新添加的集成。

添加集成

1. 单击 管理员。
2. 在 “ 集成” 下，单击 “ 集成”。
3. 单击 添加集成。 
4. 在搜索框中，键入 EventBridge。
5. 找到标题为 亚马逊 EventBridge 来源的卡片。
6. 单击 “ 安装”。 将显示有关集成的详细信息。

配置并激活 

接下来，配置并激活亚马逊 EventBridge 集成：

1. 在详细信息选项卡中，接受默认名称（Amazon EventBridge 源）或键入其他名称。
2. （可选）在提供的框中输入备注。
3. 选择 “配 置 ” 选项卡。
4. 将您的合作伙伴事件源连接到事件总线。
5. 输入您的 12 位数 AWS 账户 ID 以及必须在其中创建合作伙伴事件源的地区。 对于您所在的地区，请使用带连字符的形式，例如 us-east-1 或 us-west-2。 有关更多信息，请参阅 AWS 文档 中 支持的区域代码列表。
6. 提供唯一的 事件源后缀 以附加到 AWS 账户中的事件源。 后缀最多可包含 64 个字符，由小写和大写字母、数字或字符 (.、-、_) 组成。 后缀会附加到合作伙伴事件源名称之后，有助于将其与其他 Amazon EventBridge 集成区分开来。
7. 在主 题筛选中，选择要发送到 EventBridge 的通知主题。 输入伙伴事件来源必须接收的通知主题列表。 一些例子包括： v2.users。{id} .presence， v2.users。{id} .routingStatus，依此类推。 有关所有可用通知主题的列表，请参阅 Genesys 云开发人员中心 中的 可用主题。
   
   注意： 主题不包括参数，并提供整个组织的信息。 选择接收 v2.users。{id} .ence 事件不需要指定用户 ID，就像通知 API 那样。 您会收到组织的所有在线状态通知。 请注意您选择的通知主题的数量。 对于每个选定的主题，整个组织的所有匹配事件都将发送到 AWS EventBridge，然后路由到您选择的目标。 此外，如果您未选择任何通知主题，则不会发送任何事件。
   
8. 单击 “ 保存”。
9. 单击 详细信息 选项卡。
10. 单击切换开关以使集成 处于活动状态。
11. 单击 “ 是”。 在大约 5 分钟内，或者在应用程序重新加载之后，将在您的 AWS 账户中自动创建合作伙伴事件源。 成功激活后，Genesys Cloud 会立即开始发送事件。
    
    注意： 您最多可以为一个组织配置 10 个 Amazon EventBridge 集成实例。

在 Genesys Cloud 中配置并激活集成后，在 AWS 的 EventBridge 控制台中设置规则，以便将消息从事件源路由到预期的 AWS 目标。 有关更多信息，请参阅 配置 EventBridge 以接收事件 和 Amazon EventBridge 入门。

修改集成配置

在活动集成上修改以下属性之一会导致停用集成：

• AWS 账户 ID
• AWS 区域
• 事件源后缀

修改集成配置后，必须重新激活集成。 重新激活集成将删除旧的事件源并创建新的事件源。

主题筛选器可以随时更改，但这不会导致集成被停用。 最长等待 1 分钟以使任何更改生效。

禁用这两个集成。

成功激活 EventBridge 集成后，Genesys Cloud 开始向合作伙伴事件源发送匹配的通知。 可以通过停用集成来暂时禁用事件。 这不会以任何方式修改合作伙伴事件源。

如果不再需要集成，则可以将其删除。 删除集成会删除 AWS 中的合作伙伴事件源。

常见错误

以下是尝试激活集成配置时可能出现的一些常见错误：

• 无效的 AWS 账户 ID — 表示指定的 AWS 账户 ID 不是有效的 12 位数字字符串。
• 无效的 AWS 区域 — 表示指定的 AWS 区域不是有效的 EventBridge 区域之一。
• 事件源后缀必须是唯一的 — 表示事件源后缀与组织的其他活动 EventBridge 集成上已定义的后缀匹配。