יצירת אפליקציית Google Chat כ-webhook

Python

• חשבון Google Workspace במהדורת Business או Enterprise עם גישה ל-Google Chat. בארגון שלכם ב-Google Workspace, המשתמשים צריכים לקבל הרשאה להוסיף webhooks נכנסים ולהשתמש בהם.
• ‫Python 3.6 ואילך
• כלי ניהול החבילות pip

• הספרייה של httplib2. כדי להתקין את הספרייה, מריצים את הפקודה הבאה בממשק שורת הפקודה:

  pip install httplib2

• מרחב ב-Google Chat. במאמר יצירת מרחב מוסבר איך ליצור מרחב באמצעות Google Chat API. כדי ליצור מרחב ב-Chat, אפשר לעיין במסמכי מרכז העזרה.

Node.js

• חשבון Google Workspace במהדורת Business או Enterprise עם גישה ל-Google Chat. בארגון שלכם ב-Google Workspace, המשתמשים צריכים לקבל הרשאה להוסיף webhooks נכנסים ולהשתמש בהם.
• ‫Node.js מגרסה 14 ואילך
• הכלי לניהול חבילות npm
• מרחב ב-Google Chat. במאמר יצירת מרחב מוסבר איך ליצור מרחב באמצעות Google Chat API. כדי ליצור מרחב ב-Chat, אפשר לעיין במסמכי מרכז העזרה.

Java

• חשבון Google Workspace במהדורת Business או Enterprise עם גישה ל-Google Chat. בארגון שלכם ב-Google Workspace, המשתמשים צריכים לקבל הרשאה להוסיף webhooks נכנסים ולהשתמש בהם.
• ‫Java 11 ואילך
• כלי ניהול החבילות Maven
• מרחב ב-Google Chat. במאמר יצירת מרחב מוסבר איך ליצור מרחב באמצעות Google Chat API. כדי ליצור מרחב ב-Chat, אפשר לעיין במסמכי מרכז העזרה.

Apps Script

• חשבון Google Workspace במהדורת Business או Enterprise עם גישה ל-Google Chat. בארגון שלכם ב-Google Workspace, המשתמשים צריכים לקבל הרשאה להוסיף webhooks נכנסים ולהשתמש בהם.
• יוצרים פרויקט עצמאי של Apps Script ומפעילים את שירות Chat מתקדם.
• מרחב ב-Google Chat. במאמר יצירת מרחב מוסבר איך ליצור מרחב באמצעות Google Chat API. כדי ליצור מרחב ב-Chat, אפשר לעיין במסמכי מרכז העזרה.

Python

1. בספריית העבודה, יוצרים קובץ בשם quickstart.py.

2. ב-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()

3. מחליפים את הערך של המשתנה url בכתובת ה-URL של ה-webhook שהעתקתם כשנרשמתם ל-webhook.

Node.js

1. בספריית העבודה, יוצרים קובץ בשם index.js.

2. ב-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));

3. מחליפים את הערך של המשתנה url בכתובת ה-URL של ה-webhook שהעתקתם כשנרשמתם ל-webhook.

Java

1. בספריית העבודה, יוצרים קובץ בשם pom.xml.

2. ב-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>

3. בספריית העבודה, יוצרים את מבנה הספרייה הבא src/main/java.

4. בספרייה src/main/java, יוצרים קובץ בשם App.java.

5. ב-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());
     }
   }

6. מחליפים את הערך של המשתנה URL בכתובת ה-URL של ה-webhook שהעתקתם כשנרשמתם ל-webhook.

Apps Script

1. בדפדפן, עוברים אל Apps Script.

2. לוחצים על פרויקט חדש.

3. מדביקים את הקוד הבא:

   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);
   }

4. מחליפים את הערך של המשתנה url בכתובת ה-URL של ה-webhook שהעתקתם כשנרשמתם ל-webhook.

Python

  python3 quickstart.py

Node.js

  node index.js

Java

  mvn compile exec:java -Dexec.mainClass=App

Apps Script

• לוחצים על Run.

Python

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

/**
 * 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

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);
}