EventBridge を使用してイベントを WeCom にプッシュする - EventBridge

EventBridge でカスタムイベントバスを作成した後、特定のイベントソースによって生成されたイベントを WeCom グループにプッシュするようにカスタムイベントルールを設定できます。このトピックでは、イベントソースによって生成されたイベントを公開し、そのイベントを WeCom グループにプッシュする方法について説明します。

背景情報

カスタムチャットボットは、現在のチャットグループにアラートまたはリマインダー通知を送信するために使用できる専用のツールです。カスタムチャットボットは、テナント管理者の承認を必要とせずに、webhook URL を呼び出すことで、現在のチャットグループにメッセージをプッシュできます。

EventBridge は、HTTP タイプのイベントターゲットをサポートしています。 EventBridge を使用してイベントを WeCom チャットボットにプッシュし、webhook URL を使用して変更ベースのアラート機能を実装できます。 HTTP タイプのイベントターゲットは、インターネットおよび Alibaba Cloud 仮想プライベートクラウド (VPC) を介してアクセスできる HTTP および HTTPS URL をサポートしています。 webhook URL をさまざまなアプリケーションに統合して、さまざまなビジネス要件に対応できます。

詳細については、「HTTP エンドポイントへのイベントのルーティング」をご参照ください。

シナリオ

以下のシナリオでは、WeCom チャットボットを EventBridge に接続できます。

カスタムチャットボットを使用してイベント情報を取得する場合のシナリオ。カスタムチャットボットを使用してエンタープライズシステムを WeCom に統合し、ワンストップのユーザーエクスペリエンスを実現できます。
低コストの開発が必要なシナリオ。低コストの開発が必要なシナリオでは、チャットボットとの優れたインタラクションを実現するために、サーバー側のコードのみを開発する必要があります。チャットボットを WeCom と統合すると、企業内の他のメンバーがチャットボットを簡単に使用できるようになります。

このトピックでは、EventBridge を使用して WeCom にイベントを公開する方法について説明します。

プロセス

カスタムイベントバスを作成して、カスタムアプリケーションによって生成されたイベントを受信するか、既存のメッセージを処理します。
WeCom チャットボットを作成して、カスタムイベントバスからイベントを受信し、WeCom グループに通知を送信します。
作成したカスタムイベントバスのイベントルールを設定します。
結果を確認して、WeCom チャットボットがイベントを受信できるかどうかを確認します。

前提条件

WeCom アカウントが登録されており、WeCom グループが作成されている。
EventBridge が有効化されており、必要な権限が Resource Access Management (RAM) ユーザーに付与されている。詳細については、「EventBridge を有効化し、RAM ユーザーに権限を付与する」をご参照ください。

手順 1：カスタムイベントバスを作成する

EventBridge コンソールにログインします。
左側のナビゲーションペインで、[イベントバス] をクリックします。 [イベントバス] ページで、上部のナビゲーションバーでリージョンを選択し、[カスタムイベントバス] セクションの [クイック作成] をクリックします。
[カスタムイベントバスの作成] ウィザードで、次の手順を実行します。
1. [イベントバス] ステップで、[名前] パラメーターと [説明] パラメーターを設定し、[次のステップ] をクリックします。
2. [イベントソース] ステップで、[イベントソース名] パラメーターを設定し、[イベントプロバイダー] パラメーターを [カスタムアプリケーション] に設定して、[次のステップ] をクリックします。
3. [イベントルール] ステップで、[スキップ] をクリックします。 [後続の手順をスキップ] メッセージで、[OK] をクリックします。
  説明
  この例では、イベントルールとイベントターゲットはカスタムイベントバスに作成されません。
作成したカスタムイベントバスを表示します。

手順 2： WeCom チャットボットを作成する

PC 版 WeCom にログインし、チャットボットを追加する WeCom グループを選択します。
[グループボットの追加] ページで、[ボットの作成] をクリックします。
[ボットの作成] ダイアログボックスで、チャットボットの名前を入力し、webhook URL をコピーします。

手順 3：イベントルールを設定する

作成したカスタムイベントバスの [概要] ページに移動し、[ルールの追加] をクリックします。
[ルールの作成] ウィザードで、次の手順を実行します。
1. [基本情報の構成] ステップで、ルールの名前を指定し、[次のステップ] をクリックします。
2. [イベントパターンの構成] ステップで、[次のステップ] をクリックします。
  重要
  この例では、イベントパターンは構成されていません。本番環境では、ビジネス要件に基づいて、[イベントパターンの構成] ステップで [イベントソース] パラメーターと [イベントタイプ] パラメーターを構成する必要があります。
3. [ターゲットの構成] ステップで、[サービスタイプ] パラメーターを [HTTPS] に設定し、[URL] パラメーターを手順 2 でコピーした webhook URL に設定し、[本文] パラメーターを [テンプレート] に設定し、[変数] および [テンプレート] コードエディターでパラメーターを構成して、[作成] をクリックします。
  説明
  テンプレートの構成方法については、「テンプレート」をご参照ください。
  変数:
```
{
  "msg_source":"$.source", // メッセージソース
  "msg_type":"$.type" // メッセージタイプ
}
```
  テンプレート:
```
{
  "msgtype": "text",
  "text": {
    "content": "Event source: ${msg_source}. Event Type: ${msg_type}" // イベントソース: ${msg_source}。イベントタイプ: ${msg_type}
  }
}
```
  説明
  この例では、テンプレートの構成は簡略化されています。本番環境では、ビジネス要件に基づいてテンプレートを構成する必要があります。

手順 4：結果を確認する

作成したカスタムイベントバスの [概要] ページで、[イベントの公開] をクリックします。
[カスタムイベントバスへのイベントの公開] パネルで、[カスタムイベントソース] ドロップダウンリストから作成したカスタムイベントソースを選択し、[イベント本文] コードエディターでパラメーターを構成して、[OK] をクリックします。
WeCom グループでプッシュされたイベントを表示します。