대화형 Google Chat 앱 빌드
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
이 페이지에서는 대화형 Google Chat 앱을 빌드하는 데 사용할 수 있는 프레임워크를 간략하게 설명합니다.
대화형 채팅 앱을 사용하면 사용자가 다음 작업을 할 수 있습니다.
- Chat 스페이스 또는 쪽지에 Chat 앱을 추가합니다.
- Chat 앱에 메시지를 보내거나 Chat 앱에서 메시지를 받습니다.
- 명령어로 Chat 앱에 프롬프트합니다.
- 외부 서비스 또는 시스템의 링크를 미리 봅니다.
- 대화상자 또는 카드 메시지에 텍스트를 입력하는 등 Chat 앱에 정보를 제출합니다.
사용자가 대화형 Chat 앱을 검색하고 사용하는 방법
사용자는 다음과 같은 다양한 방법으로 Marketplace에 게시된 Chat 앱을 검색하고 사용할 수 있습니다.
- Google Chat 또는 Marketplace에서 Chat 앱을 검색하고 설치합니다.
- Chat 스페이스에 추가된 Chat 앱과 상호작용
- Google Workspace 관리자가 사용자를 대신하여 Chat 앱을 설치한 후 채팅 메시지 패널에서 Chat 앱을 찾을 수 있습니다.
Google Chat 사용자는 Chat 앱을 사용하기 위해 Chat 앱으로 채팅 메시지를 시작하거나 스페이스에 추가할 수 있습니다. 사용자는 @멘션하여 Chat 앱을 추가할 수도 있습니다. 자세한 내용은 Chat 앱 사용하기를 참고하세요.
다음 예는 사용자가 Chat 앱을 @멘션하여 스페이스에 추가하는 방법을 보여줍니다.

대화형 Chat 앱의 프레임워크 선택
사용자와 상호작용하는 Chat 앱을 빌드하려면 다음 프레임워크 중에서 선택하면 됩니다.
- Google Workspace 부가기능: 다른 Google Workspace 애플리케이션을 확장하고 Google Workspace Marketplace에 다른 유형의 앱과 함께 Chat 앱을 등록할 수 있습니다.
자세한 내용은 Google Workspace 부가기능 문서의 Google Chat 확장을 참고하세요.
- Chat API 상호작용 이벤트: Chat 앱 홈페이지와 같은 추가 기능을 빌드하고 Pub/Sub 및 Dialogflow CX와 같은 다른 아키텍처를 사용할 수 있습니다. 자세한 내용은 상호작용 이벤트 수신 및 응답을 참고하세요.
각 프레임워크의 경우 다음 표에는 각 Google Chat 앱 아키텍처를 구성하고 기본 양방향 Chat 앱을 만드는 방법에 관한 문서가 나와 있습니다.
구성 |
부가기능 |
Chat API 상호작용 이벤트 |
Chat API 구성 |
문서 |
문서 |
빠른 시작 |
|
Apps Script |
문서 |
문서 |
HTTP 서비스 |
문서 |
문서 |
Dialogflow CX |
부가기능에는 사용할 수 없습니다. |
문서 |
Pub/Sub |
부가기능에는 사용할 수 없습니다. |
문서 |
양방향 기능 빌드
각 프레임워크의 경우 다음 표에 대화형 기능을 빌드하기 위한 문서가 표시됩니다.
기능 |
부가기능 |
Chat API 상호작용 이벤트 |
메시지 보내기 |
문서 |
|
명령에 응답 |
문서 |
문서 |
대화형 대화상자 빌드 |
문서 |
문서 |
정보 수집 및 처리 |
문서 |
문서 |
Chat 메시지에서 링크 미리보기 |
문서 |
문서 |
Chat 앱의 홈페이지 빌드 |
부가기능에는 사용할 수 없습니다. |
문서 |
외부 시스템 및 도구에 연결 |
문서 |
문서 |
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-08(UTC)
[null,null,["최종 업데이트: 2025-08-08(UTC)"],[],[],null,["# Build an interactive Google Chat app\n\nThis page provides an overview of the frameworks that you can use to build an\ninteractive Google Chat app. \n\nInteractive Chat apps let users do any of the following:\n\n- Add Chat apps to Chat spaces or direct messages.\n- Send messages to or receive messages from Chat apps.\n- Prompt Chat apps with a command.\n- Preview links from an external service or system.\n- Submit information to Chat apps, such as entering text into a dialog or card message.\n\nHow users discover and use interactive Chat apps\n------------------------------------------------\n\nUsers can discover and use Chat apps published to the\nMarketplace in many ways, including the following:\n\n- Search and install Chat apps from Google Chat or the Marketplace.\n- Interact with a Chat app that's been added to a Chat space.\n- Discover the Chat app in their direct messages panel after a Google Workspace administrator installed the Chat app on their behalf.\n\nTo start using a Chat app, Google Chat users can\nstart a direct message with the Chat app or add it to a\nspace. Users can also add the Chat app by @mentioning\nit. For more information, see\n[Use Chat apps](https://support.google.com/chat/answer/7655820).\n\nThe following example shows how a user @mentions a\nChat app to add it to a space:\n\nChoose a framework for your interactive Chat app\n------------------------------------------------\n\nTo build a Chat app that interacts with users, you\ncan choose between the following frameworks:\n\n- **Google Workspace add-on** : Lets you extend other Google Workspace applications and list your Chat app with other types of apps on the Google Workspace Marketplace. To learn more, see [Extend Google Chat](/workspace/add-ons/chat) in the Google Workspace add-on documentation.\n- **Chat API interaction event** : Lets you build additional features such as a [Chat app homepage](/workspace/chat/send-app-home-card-message) and use other architectures such as Pub/Sub and Dialogflow CX. To learn more, see [Receive and respond to interaction events](/workspace/chat/receive-respond-interactions).\n\n### Configure an interactive Chat app\n\nFor each framework, the following table shows the documentation for configuring\nand creating a basic interactive Chat app for each\n[Google Chat app architecture](/workspace/chat/structure):\n\n| Configuration | Add-on | Chat API interaction events |\n|------------------------|-----------------------------------------------------------------|-----------------------------------------------------------------------------|---|\n| Configure the Chat API | [Documentation](/workspace/add-ons/chat/configure) | [Documentation](/workspace/chat/configure-chat-api) |\n| **Quickstarts** | |||\n| Apps Script | [Documentation](/workspace/add-ons/chat/quickstart-apps-script) | [Documentation](/workspace/chat/quickstart/apps-script-app) |\n| HTTP service | [Documentation](/workspace/add-ons/chat/quickstart-http) | [Documentation](/workspace/chat/quickstart/gcf-app) |\n| Dialogflow CX | Unavailable for add-ons. | [Documentation](/workspace/chat/build-dialogflow-chat-app-natural-language) |\n| Pub/Sub | Unavailable for add-ons. | [Documentation](/workspace/chat/quickstart/pub-sub) |\n\n### Build interactive features\n\nFor each framework, the following table shows the documentation for\nbuilding interactive features:\n\n| Feature | Add-on | Chat API interaction events |\n|---------------------------------------|------------------------------------------------------------------------|-------------------------------------------------------------|\n| Send messages | [Documentation](/workspace/add-ons/chat/send-messages) | |\n| Respond to commands | [Documentation](/workspace/add-ons/chat/commands) | [Documentation](/workspace/chat/commands) |\n| Build interactive dialogs | [Documentation](/workspace/add-ons/chat/dialogs) | [Documentation](/workspace/chat/dialogs) |\n| Collect and process information | [Documentation](/workspace/add-ons/chat/collect-information) | [Documentation](/workspace/chat/read-form-data) |\n| Preview links in Chat messages | [Documentation](/workspace/add-ons/chat/preview-links) | [Documentation](/workspace/chat/preview-links) |\n| Build a homepage for your Chat app | Unavailable for add-ons. | [Documentation](/workspace/chat/send-app-home-card-message) |\n| Connect to external systems and tools | [Documentation](/workspace/add-ons/guides/connect-third-party-service) | [Documentation](/workspace/chat/connect-web-services-tools) |\n\nRelated topics\n--------------\n\n- [Build a Google Chat app as a Google Workspace add-on](/workspace/add-ons/chat)\n- [Receive and respond to interaction events](/workspace/chat/receive-respond-interactions)\n- [Choose a Google Chat app architecture](/workspace/chat/structure)"]]