Google Chat 앱을 웹훅으로 빌드하기

Python

• Google Chat에 액세스할 수 있는 비즈니스 또는 엔터프라이즈 Google Workspace 계정 Google Workspace 조직에서 사용자가 수신 웹훅을 추가하고 사용하도록 허용해야 합니다.
• Python 3.6 이상
• pip 패키지 관리 도구

• httplib2 라이브러리 라이브러리를 설치하려면 명령줄 인터페이스에서 다음 명령어를 실행합니다.

  pip install httplib2

• Google Chat 스페이스 Google Chat API를 사용하여 스페이스를 만들려면 스페이스 만들기를 참고하세요. Chat에서 계정을 만들려면 고객센터 문서를 방문하세요.

Node.js

• Google Chat에 액세스할 수 있는 비즈니스 또는 엔터프라이즈 Google Workspace 계정 Google Workspace 조직에서 사용자가 수신 웹훅을 추가하고 사용하도록 허용해야 합니다.
• Node.js 14 이상
• npm 패키지 관리 도구
• Google Chat 스페이스 Google Chat API를 사용하여 스페이스를 만들려면 스페이스 만들기를 참고하세요. Chat에서 계정을 만들려면 고객센터 문서를 방문하세요.

자바

• Google Chat에 액세스할 수 있는 비즈니스 또는 엔터프라이즈 Google Workspace 계정 Google Workspace 조직에서 사용자가 수신 웹훅을 추가하고 사용하도록 허용해야 합니다.
• Java 11 이상
• Maven 패키지 관리 도구
• Google Chat 스페이스 Google Chat API를 사용하여 스페이스를 만들려면 스페이스 만들기를 참고하세요. Chat에서 템플릿을 만들려면 고객센터 문서를 참고하세요.

Apps Script

• Google Chat에 액세스할 수 있는 비즈니스 또는 엔터프라이즈 Google Workspace 계정 Google Workspace 조직에서 사용자가 수신 웹훅을 추가하고 사용하도록 허용해야 합니다.
• 독립형 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로 바꿉니다.

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로 바꿉니다.

자바

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로 바꿉니다.

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로 바꿉니다.

Python

  python3 quickstart.py

Node.js

  node index.js

자바

  mvn compile exec:java -Dexec.mainClass=App

Apps Script

• 실행을 클릭합니다.

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