このページは Cloud Translation API によって翻訳されました。

Google Chat アプリを Webhook として作成する

このページでは、非同期メッセージを外部トリガーを使用した Chat スペース。たとえばモニタリングアプリケーションを構成して、オンコール担当者にサーバーがダウンしたときにチャットする。同期メッセージを送信するには使用方法については、メッセージを送信する。

このタイプのアーキテクチャではユーザーが Webhook や接続された外部 IP アドレス通信は一方向であるためです。Webhook は会話型ではありません。ユーザーやチャットメッセージに Chat 用アプリのインタラクションイベント。メッセージに返信するには、構築する使用します。

Webhook は技術的に Webhook は、標準 HTTP リクエスト - このページでは、これを Chat 用アプリと簡素化します。各 Webhook は、あります。着信 Webhook はダイレクトメッセージ内で動作しますが、すべてのユーザーが有効な Chat アプリ。 Webhook を Google Workspace Marketplace に公開することはできません。

次の図は、Kubernetes に接続された Webhook のアーキテクチャを示しています。チャット:

着信 Webhook が Chat に非同期メッセージを送信するためのアーキテクチャ。

上の図で、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 を追加] をクリックします。

注: ボタンをクリックすることができない場合、組織に Webhook の追加や使用が許可されていません。詳しくは、ユーザーに Chat 用アプリのインストールを許可するをご覧ください。
[名前] フィールドに「Quickstart Webhook」と入力します。
[アバターの URL] フィールドに、次のように入力します。 https://developers.google.com/chat/images/chat-product-icon.png。
[保存] をクリックします。
Webhook URL をコピーするには、 [その他] をクリックし、 リンクをコピー。

警告: 公開コードなどで Webhook URL を共有しないでください。セキュリティが侵害されるためです。

Webhook スクリプトを作成する

サンプルの Webhook スクリプトは、Webhook が構成されているスペースにメッセージを送信します。 POST リクエストを Webhook URL に送信して登録します。「 Chat API は Message。

言語を選択すると、Webhook スクリプトの作成方法を確認できます。

Python

作業ディレクトリに、quickstart.py という名前のファイルを作成します。

quickstart.py に次のコードを貼り付けます。

python/webhook/quickstart.py

GitHub で表示

from json import dumps
from httplib2 import Http

# Copy the webhook URL from the Chat space where the webhook is registered.
# The values for SPACE_ID, KEY, and TOKEN are set by Chat, and are included
# when you copy the webhook URL.

def main():
    """Google Chat incoming webhook quickstart."""
    url = "https://chat.googleapis.com/v1/spaces/SPACE_ID/messages?key=KEY&token=TOKEN"
    app_message = {"text": "Hello from a Python script!"}
    message_headers = {"Content-Type": "application/json; charset=UTF-8"}
    http_obj = Http()
    response = http_obj.request(
        uri=url,
        method="POST",
        headers=message_headers,
        body=dumps(app_message),
    )
    print(response)


if __name__ == "__main__":
    main()

url 変数の値を、次の Webhook URL に置き換えます。 Webhook の登録時にコピーしたものを使用します。

Node.js

作業ディレクトリに、index.js という名前のファイルを作成します。
index.js に次のコードを貼り付けます。

node/webhook/index.js

GitHub で表示
```
/**
 * Sends asynchronous message to Google Chat
 * @return {Object} response
 */
async function webhook() {
  const url = "https://chat.googleapis.com/v1/spaces/SPACE_ID/messages"
  const res = await fetch(url, {
    method: "POST",
    headers: {"Content-Type": "application/json; charset=UTF-8"},
    body: JSON.stringify({text: "Hello from a Node script!"})
  });
  return await res.json();
}

webhook().then(res => console.log(res));
```
url 変数の値を、次の Webhook URL に置き換えます。 Webhook の登録時にコピーしたものを使用します。

Java

作業ディレクトリに、pom.xml という名前のファイルを作成します。

pom.xml に、次のコードをコピーして貼り付けます。

java/webhook/pom.xml

GitHub で表示

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
  <modelVersion>4.0.0</modelVersion>

  <groupId>com.google.chat.webhook</groupId>
  <artifactId>java-webhook-app</artifactId>
  <version>0.1.0</version>

  <name>java-webhook-app</name>
  <url>https://github.com/googleworkspace/google-chat-samples/tree/main/java/webhook</url>

  <properties>
    <maven.compiler.target>11</maven.compiler.target>
    <maven.compiler.source>11</maven.compiler.source>
  </properties>

  <dependencies>
    <dependency>
        <groupId>com.google.code.gson</groupId>
        <artifactId>gson</artifactId>
        <version>2.9.1</version>
    </dependency>
  </dependencies>

  <build>
    <pluginManagement>
      <plugins>
        <plugin>
          <artifactId>maven-compiler-plugin</artifactId>
          <version>3.8.0</version>
        </plugin>
      </plugins>
    </pluginManagement>
  </build>
</project>

作業ディレクトリで、次のディレクトリ構造を作成します。 src/main/java。
src/main/java ディレクトリに、App.java という名前のファイルを作成します。

App.java に次のコードを貼り付けます。

java/webhook/src/main/java/com/google/chat/webhook/App.java

GitHub で表示

import com.google.gson.Gson;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.util.Map;
import java.net.URI;

public class App {
  private static final String URL = "https://chat.googleapis.com/v1/spaces/AAAAGCYeSRY/messages";
  private static final Gson gson = new Gson();
  private static final HttpClient client = HttpClient.newHttpClient();

  public static void main(String[] args) throws Exception {
    String message = gson.toJson(Map.of("text", "Hello from Java!"));

    HttpRequest request = HttpRequest.newBuilder(
        URI.create(URL))
        .header("accept", "application/json; charset=UTF-8")
        .POST(HttpRequest.BodyPublishers.ofString(message))
        .build();

    HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

    System.out.println(response.body());
  }
}

URL 変数の値は、先ほど作成した Webhook URL に置き換えます。 Webhook を登録したときにコピーされた名前を使用します。

Apps Script

ブラウザで Apps Script。
[新しいプロジェクト] をクリックします。
次のコードを貼り付けます。

apps-script/webhook/webhook.gs

GitHub で表示
```
function webhook() {
  const url = "https://chat.googleapis.com/v1/spaces/SPACE_ID/messages"
  const options = {
    "method": "post",
    "headers": {"Content-Type": "application/json; charset=UTF-8"},
    "payload": JSON.stringify({"text": "Hello from Apps Script!"})
  };
  const response = UrlFetchApp.fetch(url, options);
  console.log(response);
}
```
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 をご覧ください。

次のコードサンプルは、メッセージスレッドの開始または返信を行います。

Python

python/webhook/thread-reply.py

GitHub で表示

from json import dumps
from httplib2 import Http

# Copy the webhook URL from the Chat space where the webhook is registered.
# The values for SPACE_ID, KEY, and TOKEN are set by Chat, and are included
# when you copy the webhook URL.
#
# Then, append messageReplyOption=REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD to the
# webhook URL.


def main():
    """Google Chat incoming webhook that starts or replies to a message thread."""
    url = "https://chat.googleapis.com/v1/spaces/SPACE_ID/messages?key=KEY&token=TOKEN&messageReplyOption=REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD"
    app_message = {
        "text": "Hello from a Python script!",
        # To start a thread, set threadKey to an arbitratry string.
        # To reply to a thread, specify that thread's threadKey value.
        "thread": {"threadKey": "THREAD_KEY_VALUE"},
    }
    message_headers = {"Content-Type": "application/json; charset=UTF-8"}
    http_obj = Http()
    response = http_obj.request(
        uri=url,
        method="POST",
        headers=message_headers,
        body=dumps(app_message),
    )
    print(response)


if __name__ == "__main__":
    main()

Node.js

node/webhook/thread-reply.js

GitHub で表示

/**
 * Sends asynchronous message to Google Chat
 * @return {Object} response
 */
async function webhook() {
  const url = "https://chat.googleapis.com/v1/spaces/SPACE_ID/messages?key=KEY&token=TOKEN&messageReplyOption=REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD"
  const res = await fetch(url, {
    method: "POST",
    headers: {"Content-Type": "application/json; charset=UTF-8"},
    body: JSON.stringify({
      text: "Hello from a Node script!",
      thread: {threadKey: "THREAD_KEY_VALUE"}
    })
  });
  return await res.json();
}

webhook().then(res => console.log(res));

Apps Script

apps-script/webhook/thread-reply.gs

GitHub で表示

function webhook() {
  const url = "https://chat.googleapis.com/v1/spaces/SPACE_ID/messages?key=KEY&token=TOKEN&messageReplyOption=REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD"
  const options = {
    "method": "post",
    "headers": {"Content-Type": "application/json; charset=UTF-8"},
    "payload": JSON.stringify({
      "text": "Hello from Apps Script!",
      "thread": {"threadKey": "THREAD_KEY_VALUE"}
    })
  };
  const response = UrlFetchApp.fetch(url, options);
  console.log(response);
}

Google Chat アプリを Webhook として作成する

前提条件

Python

Node.js

Java

Apps Script

Webhook を作成する

着信 Webhook を登録する

Webhook スクリプトを作成する

Python

Node.js

Java

Apps Script

Webhook スクリプトを実行する

Python

Node.js

Java

Apps Script

メッセージ スレッドを開始または返信する

Python

Node.js

Apps Script

関連トピック

メッセージスレッドを開始または返信する