このページでは、非同期メッセージを 外部トリガーを使用した Chat スペース。たとえば モニタリング アプリケーションを構成して、オンコール担当者に サーバーがダウンしたときにチャットする。同期メッセージを送信するには 使用方法については、 メッセージを送信する。
このタイプのアーキテクチャでは ユーザーが Webhook や接続された外部 IP アドレス 通信は一方向であるためです。Webhook は会話型ではありません。 ユーザーやチャット メッセージに Chat 用アプリのインタラクション イベント。 メッセージに返信するには、 構築する 使用します。
Webhook は技術的に Webhook は、標準 HTTP リクエスト - このページでは、これを Chat 用アプリと 簡素化します。各 Webhook は、 あります。着信 Webhook はダイレクト メッセージ内で動作しますが、 すべてのユーザーが 有効な Chat アプリ。 Webhook を Google Workspace Marketplace に公開することはできません。
次の図は、Kubernetes に接続された Webhook のアーキテクチャを示しています。 チャット:
上の図で、Chat 用アプリには次のものが含まれます。 情報のフロー:
- Chat アプリのロジックは、Google Chat のメッセージ アプリで サードパーティのサービス(プロジェクト管理システム、 チケット発行ツールを使用します
- Chat 用アプリのロジックは、クラウドまたは Webhook URL を使用してメッセージを送信できる 割り当てることができます。
- ユーザーは次の場所で Chat アプリのメッセージを受信できます: その特定の Chat スペースにはアクセスできないものの、 Chat アプリ。
前提条件
Python
- 企業または大企業 以下へのアクセス権を持つ Google Workspace アカウント Google Chat。 Google Workspace の組織では、ユーザーが Google Workspace の 着信 Webhook を追加して使用する
- Python 3.6 以降
- pip パッケージ管理ツール
httplib2
ライブラリ。ライブラリをインストールするには、コマンドライン インターフェースで次のコマンドを実行します。pip install httplib2
Google Chat スペース。Google Chat API を使用して作成する方法については、以下をご覧ください。 スペースを作成します。Chat で作成するには、 詳しくは、 ヘルプセンターの記事をご覧ください。
Node.js
- 企業または大企業 以下へのアクセス権を持つ Google Workspace アカウント Google Chat。 Google Workspace の組織では、ユーザーが Google Workspace の 着信 Webhook を追加して使用する
- Node.js 14 以降
- npm パッケージ管理ツール
- Google Chat スペース。Google Chat API を使用して作成する方法については、以下をご覧ください。 スペースを作成します。Chat で作成するには、 詳しくは、 ヘルプセンターの記事をご覧ください。
Java
- 企業または大企業 以下へのアクセス権を持つ Google Workspace アカウント Google Chat。 Google Workspace の組織では、ユーザーが Google Workspace の 着信 Webhook を追加して使用する
- Java 11 以降
- Maven パッケージ管理ツール
- Google Chat スペース。Google Chat API を使用して作成する方法については、以下をご覧ください。 スペースを作成します。Chat で作成するには、 詳しくは、 ヘルプセンターの記事をご覧ください。
Apps Script
- 企業または大企業 以下へのアクセス権を持つ Google Workspace アカウント Google Chat。 Google Workspace の組織では、ユーザーが Google Workspace の 着信 Webhook を追加して使用する
- スタンドアロンの Apps Script プロジェクトを作成する [高度なチャット サービス] をオンにします。
- Google Chat スペース。Google Chat API を使用して作成する方法については、以下をご覧ください。 スペースを作成します。Chat で作成するには、 詳しくは、 ヘルプセンターの記事をご覧ください。
Webhook を作成する
Webhook を作成するには、目的の Chat スペースに Webhook を登録します。 メッセージを受信し、メッセージを送信するスクリプトを作成します。
着信 Webhook を登録する
- ブラウザで Google Chat。 Chat モバイルアプリから Webhook を構成することはできません。
- Webhook を追加するスペースに移動します。
- スペースのタイトルの横にある その他アイコンを展開して、[アプリと統合をご覧ください。
[
Webhook を追加] をクリックします。[名前] フィールドに「
Quickstart Webhook
」と入力します。[アバターの URL] フィールドに、次のように入力します。
https://developers.google.com/chat/images/chat-product-icon.png
。[保存] をクリックします。
Webhook URL をコピーするには、
[その他] をクリックし、 リンクをコピー。
Webhook スクリプトを作成する
サンプルの Webhook スクリプトは、Webhook が構成されているスペースにメッセージを送信します。
POST
リクエストを Webhook URL に送信して登録します。「
Chat API は
Message
。
言語を選択すると、Webhook スクリプトの作成方法を確認できます。
Python
作業ディレクトリに、
quickstart.py
という名前のファイルを作成します。quickstart.py
に次のコードを貼り付けます。url
変数の値を、次の Webhook URL に置き換えます。 Webhook の登録時にコピーしたものを使用します。
Node.js
作業ディレクトリに、
index.js
という名前のファイルを作成します。index.js
に次のコードを貼り付けます。url
変数の値を、次の Webhook URL に置き換えます。 Webhook の登録時にコピーしたものを使用します。
Java
作業ディレクトリに、
pom.xml
という名前のファイルを作成します。pom.xml
に、次のコードをコピーして貼り付けます。作業ディレクトリで、次のディレクトリ構造を作成します。
src/main/java
。src/main/java
ディレクトリに、App.java
という名前のファイルを作成します。App.java
に次のコードを貼り付けます。URL
変数の値は、先ほど作成した Webhook URL に置き換えます。 Webhook を登録したときにコピーされた名前を使用します。
Apps Script
ブラウザで Apps Script。
[新しいプロジェクト] をクリックします。
次のコードを貼り付けます。
url
変数の値は、先ほど作成した Webhook URL に置き換えます。 Webhook を登録したときにコピーされた名前を使用します。
Webhook スクリプトを実行する
CLI でスクリプトを実行します。
Python
python3 quickstart.py
Node.js
node index.js
Java
mvn compile exec:java -Dexec.mainClass=App
Apps Script
- [実行] をクリックします。
コードを実行すると、Webhook はユーザーが操作しているスペースにメッセージを送信します。 登録しました。
メッセージ スレッドを開始または返信する
具体的にご記入ください
spaces.messages.thread.threadKey
メッセージリクエストの本文に指定します。Google Cloud コンソールから スレッドに返信する場合は、threadKey
に次の値を使用します。スレッドを開始する場合は、
threadKey
を任意の文字列に設定します。ただし、 スレッドに返信するには、この値をメモしておきます。スレッドに返信する場合は、スレッドへの返信時に設定された
threadKey
を 開始されました。たとえば、スペースが 最初のメッセージにMY-THREAD
が使用されました。MY-THREAD
を設定します。
指定された
threadKey
が見つからない場合のスレッドの動作を定義します。スレッドに返信したり、新しいスレッドを開始したりします。追加
messageReplyOption=REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD
パラメータを Webhook URL を入力します。この URL パラメータを渡すと、Chat が 指定したthreadKey
を使用して既存のスレッドを検索します。1 つ そのスレッドへの返信としてメッセージが投稿されます。いずれも そのスレッドに対応する新しいスレッドがthreadKey
。スレッドに返信するか、何もしません。追加 Webhook URL に
messageReplyOption=REPLY_MESSAGE_OR_FAIL
パラメータを追加します。 この URL パラメータを渡すと、Chat が 指定したthreadKey
を使用して既存のスレッドを検索します。1 つ そのスレッドへの返信としてメッセージが投稿されます。いずれも メールは送信されません。
詳しくは、
messageReplyOption
をご覧ください。
次のコードサンプルは、メッセージ スレッドの開始または返信を行います。