|

Zoom の着信 Webhook チャットボットの使用

Incoming Webhook アプリを使用して、任意の Zoom チャット チャネルから Amazon CloudWatch などの外部サービスに直接メッセージを送信できます。 チャット アプリを使用すると、選択した任意のチャネルで一意のエンドポイントと検証トークンを生成できます。 この資格情報を使用すると、これらの資格情報を使用して、HTTP POST リクエストを介して Zoom チャット チャネルにメッセージを送信できます。

着信 Webhook の前提条件

  • アカウントの所有権または管理者権限

  • アカウントの種類: Professional、Business、Education、または Enterprise

  • HTTP POST に精通したトークンとエンドポイントを使用して HTTP POST リクエストを送信する機能

  • Zoom アプリ マーケットプレイスは、Incoming Webhook チャットボットをマーケットプレイスに含めることを事前承認しました
    ノート: アプリが事前承認されていない場合は、Zoom 管理者に連絡する必要があります。

Incoming Webhook を追加して構成する方法

Zoomアプリマーケットプレイスから追加

ノート: 管理者権限がない場合は、受信 Webhook チャットボットを Zoom アカウントに追加して構成する必要があります。

  1. Zoom アプリ マーケットプレイスで、Zoom アカウントの管理者としてログインしていることを確認します。

  2. Incoming Webhook アプリは、画面の右上にある検索ボックスにあります。 ボックスにアプリの名前を入力するだけです。

  3. 検索結果に Incoming Webhook アプリが表示されます。 アプリをクリックして開きます。
    ノート: アプリがアカウントで事前承認されていない場合は、Zoom 管理者に連絡して承認を受けることをお勧めします。

  4. 追加ボタンをクリックしてください。

  5. アプリに必要なアクセス許可が必要であることを確認したら、[承認]をクリックします。
    着信 Webhook 用のアプリをストアに追加しました。

着信 Webhook チャットボットを構成する

  1. Zoom のデスクトップ クライアントは、サインインすることでアクセスできます。

  2. 画面の左側に[チャット]タブがあります。

  3. Incoming Webhooks は BOTS セクションにあります。
    また、特定のチャット チャネルでメッセージを受信したい場合は、そのチャネルに移動できます。

  4. 接続に接続するには、タイプ /inc connect connectionName>。
    この操作の結果、接続され、次の詳細を含む 1 対 1 のチャット メッセージが届きます。

    • 終点

    • 検証トークン

    • カール リクエスト。

  5. この情報を使用して、サーバーに POST 要求を送信できます。
    ノート: Incoming Webhook チャットボットから選択したチャネルにメッセージを送信するには、選択したチャネルごとに次の手順に従う必要があります。

Zoom チャットにメッセージを送信する方法

接続を作成したら、統合のエンドポイントに POST リクエストを送信できるようにするには、まず接続を作成する必要があります。 認証ヘッダーに検証トークンを含めるように構成した場合は、検証トークンを含める必要があります。
ノート注: POST 要求は、エンドポイントによって受け入れられる唯一の要求の種類です。

ターミナルで接続をテストするには、git-bash (または cURL コマンドを実行できる同等のもの) を実行することをお勧めします。 着信 Webhook チャットボットから送信されます 最初の 1:1 チャット メッセージの例の cURL に基づく cURL 要求。 サンプル cURL をコピーして、cURL 要求に貼り付けることができます。 指定したチャネルで、送信したテスト メッセージが送信されていることを確認できます。 HTTP 200 OK 応答は、テストが成功したことを示します。

メッセージのタイプとメッセージの複雑さは、次の 4 つのオプションから選択して、受信 Webhook チャットボットで設定できます。

  • シンプルなフォーマット:それは私の重要性この形式を使用すると、作成された接続からプレーンテキストを送信できることを知っている必要はありません。 このフォーマットを使用する場合は、パラメータなしでエンドポイントを使用できます。 メッセージの本文には、送信するコンテンツを含む文字列を含める必要があります。

POST <endpoint>
Authorization: <verificationToken>
Body: "This is a test message."
  • 田畑 フォーマット: この形式のフィールド形式では、単純な書式をフィールドに入力できます。 たとえば、メッセージを入力可能なフィールドのリストにフォーマットできます。このフォーマットを機能させるには、クエリ パラメーター (?format=fields) にフォーマットとしてフィールドを追加する必要があります。

POST <endpoint>?format=fields
Authorization: <verificationToken>
Content-Type: application/json
Body:
{
    "Field 1": "bar",
    "Field 2": "qux"
}
  • リスト形式: この形式を使用すると、単純な形式のアイテムのリストを送信できます。 たとえば、メッセージをこの形式で表示する場合は、リストを使用してメッセージをフォーマットできます。 このフォーマットを使用するには、クエリ パラメータをリスト (?format=list) に設定する必要があります。 使用 このフォーマット。

POST <endpoint>?format=list
Authorization: <verificationToken>
Content-Type: application/json
Body:
{
    "Item 1": "Item 1",
    "Item 2": "Item 2"
}
  • フルフォーマット: このフォーマットを利用して、リッチ メッセージ フォーマットを生成し、Zoom チャット メッセージ内で送信することもできます。 このようなフォーマットを使用すると、ヘッダーとサブヘッダー、リンク、ボタン、ドロップダウン、添付ファイルなどを使用するなど、さまざまな方法でチャットボット メッセージを作成できます。 このフォーマットを利用するには、パラメーター ?format=full をクエリ パラメーターに追加して、full がフォーマットになるようにします。 サポートされている JSON オブジェクトの詳細については、次のドキュメントを参照してください。

Incoming Webhook チャットボットの使用方法

利用可能なコマンド

  • 接続:トークンを獲得して接続を作成するには、最初のステップとして /inc connect connectionName>を入力する必要があります。 トークンは、現在のチャット チャネルにメッセージを直接送信するために使用されます。 このチャットボットで使用できる 1 対 1 のダイレクト メッセージとチャネルの両方があります。

  • 再生するケン: 追加情報については、確認トークンの生成に使用される接続名を確認してください。

  • 切断する注: /inc 切断オプションを使用している場合、指定した名前に関連付けられているすべての接続を削除する必要があります。

  • すべて切断: Incoming Webhook Chatbot は、コマンド /inc disconnect all を使用してすべての接続を削除することで削除できます。

  • 構成、設定: 現在のチャット チャネルの接続のリストについては、ターミナルで /inc configure と入力します。

  • すべてを構成: 各チャネルのすべての接続のリストを表示するには、「/inc configure all」と入力します。

Incoming Webhook チャットボットを削除する方法

  1. Zoom アプリ マーケットプレイスで、Zoom アカウントの管理者としてログインしていることを確認します。

  2. アカウントを管理するには、画面の右上隅にある[管理]ボタンをクリックします。

  3. ページ上部のナビゲーション メニューから[アプリの追加]オプションを選択します。

  4. Incoming WebHook アプリの右側にある[削除]をクリックすると、アプリが削除されます。

  5. 確認後、「削除」ボタンをクリック ダイアログ。
    ノート: このステップの一環として、すべてのアクティブな接続 Zoomチャットも削除されます。

Zoom サポートは、必要に応じて追加の支援を提供できます。

Similar Posts