Amazon EventBridge統合の構成

Amazon EventBridgeをインストールした後、Genesys Cloudの管理者はAmazon EventBridgeソース統合を追加および構成する必要があります。 管理者は、最初に統合を追加してから、新しく追加された統合を構成してアクティブ化する必要があります。

統合を追加する

1. [管理]をクリックします。
2. 統合で統合をクリックします。
3. 統合の追加をクリックします。
4. [検索] ボックスに、 イベントブリッジ.
5. 標題のカードを見つけます Amazon EventBridge ソース.
6. インストールをクリックします。 統合に関する詳細が表示されます。

構成およびアクティブ化 

次に、Amazon EventBridge統合を構成してアクティブ化します。

1. [詳細]タブで、デフォルト名(Amazon EventBridgeソース)を受け入れるか、別の名前を入力します。
2. オプション指定されたボックスにメモを入力します。
3. 選択し、 構成 ] タブ。
4. パートナーのイベントソースをイベントバスに接続します。
5. 12桁のAWSアカウントIDと、パートナーイベントソースを作成する必要があるリージョンを入力します。 お住まいの地域では、次のようなハイフン付きの形式を使用してください us-east-1 また us-west-2。 詳細については、のリストを参照してください。 サポートされているリージョンコード AWSのドキュメントに記載されています。
6. 独自の イベントソースサフィックス AWSアカウントでイベントソースに追加します。 サフィックスは、小文字と大文字、数字、または文字(.、-、_)で構成された最大64文字まで使用できます。 サフィックスはパートナーイベントソース名に追加され、他のAmazonEventBridge統合と区別するのに役立ちます。
7. イン トピックのフィルタリング、EventBridgeに送信する通知トピックを選択します。 パートナーイベントソースが受信する必要のある通知トピックのリストを入力します。 例： v2.users。{id} .presence、 v2.users。{id} .routingStatus、 等々。 利用可能なすべての通知トピックのリストについては、を参照してください。 利用可能なトピック Genesys Cloud DeveloperCenterにあります。
   
   メモ：   トピックにはパラメータが含まれず、組織全体の情報が提供されます。 受け取ることを選択する v2.users。{id} .presence イベントは、Notifications APIの場合のように、ユーザーIDを指定する必要はありません。 所属組織のすべてのプレゼンス通知を受信します。 選択する通知トピックの数に注意してください。 選択したトピックごとに、組織全体で一致するすべてのイベントがAWS EventBridgeに送信され、選択したターゲットにルーティングされます。 また、通知トピックを選択しない場合、イベントは送信されません。
   
8. 保存するをクリックします。
9. クリック 詳細 タブ。
10. トグルをクリックして、統合が アクティブ.
11. [はい] をクリックします。  約5分後、またはアプリケーションのリロード後、パートナーイベントソースがAWSアカウントに自動的に作成されます。 Genesys Cloudは、アクティベーションが成功するとすぐにイベントの送信を開始します。
    
    注意： 組織に対して最大10個のAmazonEventBridge統合インスタンスを設定できます。

Genesys Cloudで統合を構成してアクティブ化したら、AWSのEventBridgeコンソールでルールを設定し、イベントソースから目的のAWSターゲットにメッセージをルーティングします。 詳細については、以下を参照してください。 イベントを受信するようにEventBridgeを構成する および Amazon EventBridgeを使ってみる.

統合構成を変更する

アクティブな統合で次の属性のいずれかを変更すると、統合が非アクティブになります。

• AWSアカウントID
• AWSリージョン
• イベントソースサフィックス

統合構成を変更した後、統合を再アクティブ化する必要があります。 統合を再アクティブ化すると、古いイベントソースが削除され、新しいイベントソースが作成されます。

トピックフィルターはいつでも変更できますが、これによって統合が非アクティブ化されることはありません。 変更が有効になるまで最大1分かかります。

両方の統合を無効にします。

EventBridge統合が正常にアクティブ化されると、GenesysCloudは一致する通知をパートナーイベントソースに送信し始めます。 統合を非アクティブ化することにより、イベントを一時的に無効にすることができます。 これにより、パートナーのイベントソースが変更されることはありません。

統合が不要になった場合は、削除できます。 統合を削除すると、AWSのパートナーイベントソースが削除されます。

起きやすいエラー：

以下は、統合構成をアクティブ化しようとしたときに表示される可能性のあるいくつかの一般的なエラーです。

• 無効なAWSアカウントID –指定されたAWSアカウントIDが有効な12桁の文字列ではないことを示します。
• 無効なAWSリージョン– 指定されたAWSリージョンが有効なリージョンの1つではないことを示します EventBridgeリージョン。
• イベントソースサフィックスは一意である必要があります –イベントソースサフィックスが、組織の別のアクティブなEventBridge統合ですでに定義されているサフィックスと一致することを示します。