Chat 앱의 수명 주기 각 단계에서 안전하게 테스트하려면 개발, 스테이징, 프로덕션을 위한 별도의 환경을 설정하는 것이 좋습니다. 각 환경에서 다른 Chat 앱을 만들고 배포해야 합니다. 환경을 설정하는 방법을 알아보려면 Google Chat 앱의 배포 만들기 및 관리하기를 참고하세요.
기본 요건
상호작용 이벤트를 수신하고 이에 응답하도록 구성된 Google Chat 앱 대화형 Chat 앱을 만들려면 사용하려는 앱 아키텍처에 따라 다음 빠른 시작 중 하나를 완료하세요.
Chat 앱을 테스트하는 사용자는 Chat 앱이 구성된 동일한 Google Workspace 조직에 속해야 합니다.
Google Workspace 조직에서 Chat 앱을 테스트하고 설치할 수 있는지 확인합니다. 자세한 내용은 Google Workspace Marketplace 문서의 Google Workspace 조직의 액세스 권한 구성하기를 참고하세요.
신뢰할 수 있는 테스터 추가
대화형 Chat 앱의 경우 Chat API를 사용하면 Google Workspace 조직의 특정 사용자와 Chat 앱을 공유할 수 있습니다. 지정한 사용자는 Marketplace에 게시하기 전에 스페이스에 Chat 앱을 추가하고 기능을 테스트할 수 있습니다. 자체 Chat 앱을 테스트하려면 본인을 신뢰할 수 있는 테스터로 추가해야 합니다.
테스트 Chat 앱을 조직의 사용자가 사용할 수 있도록 하려면 Google Cloud 콘솔에서 Chat API 공개 상태 설정을 업데이트하세요.
인터랙티브 기능 > 공개 상태로 이동한 다음 GOOGLE_WORKSPACE_ORGANIZATION의 특정 사용자 및 그룹에서 이 채팅 앱을 사용할 수 있도록 설정을 선택합니다. 여기서 GOOGLE_WORKSPACE_ORGANIZATION은 조직의 이름입니다.
체크박스를 선택한 후 표시되는 필드에 Chat 앱에 액세스할 사용자 또는 Google 그룹의 이메일 주소를 쉼표로 구분하여 입력합니다. 자체 Chat 앱을 테스트하려면 Google Chat에 액세스하는 데 사용하는 이메일 주소를 입력합니다.
저장을 클릭합니다.
스페이스에 채팅 앱 추가하기
대화형 기능 테스트를 시작하려면 채팅 앱을 채팅 메시지, 그룹 메시지, 이름이 지정된 스페이스와 같은 하나 이상의 스페이스에 추가해야 합니다. 스페이스의 모든 구성원을 신뢰할 수 있는 테스터로 추가하지 않은 경우 스페이스에서 Chat 앱을 볼 수는 있지만 직접 상호작용할 수는 없습니다.
게시되지 않은 채팅 앱은 Google Workspace Marketplace의 등록정보 결과에 표시되지 않습니다. Google Chat에서 게시되지 않은 Chat 앱을 찾으려면 Chat 앱을 검색하거나, 메시지를 작성하는 동안
add_circle_outline Google Workspace 도구에서 찾거나, 메시지에서 Chat 앱을 @멘션하면 됩니다.
스페이스에 Chat 앱을 추가하려면 다음 단계를 따르세요.
신뢰할 수 있는 테스터로 자신을 추가할 때 제공한 Google Workspace 계정을 사용하여 Google Chat을 엽니다.
Chat 스페이스의 새 메시지 필드에 @ 및 Chat 앱 이름을 입력합니다. 검색 결과에서 Chat 앱을 선택합니다.
Enter 키를 누르거나 send 보내기를 클릭합니다.
추가 대상 스페이스 이름 창이 표시되면 스페이스에 추가를 클릭합니다. @멘션이 포함된 메시지가 Chat 스페이스에 게시됩니다.
스페이스에 Chat 앱을 추가했다는 설명이 포함된 텍스트도 표시됩니다.
이제 스페이스에서 Chat 앱을 테스트할 수 있습니다.
Chat 앱을 테스트할 때는 모든 기능을 검토한 다음 발견된 오류를 기록하고 수정해야 합니다. 오류 메시지를 이해하고 해결하려면 Google Chat 오류 문제 해결 및 수정을 참고하세요.
Google Workspace Marketplace용 Chat 앱 검토 및 테스트
신뢰할 수 있는 테스터로 등록되지 않은 사용자에게 채팅 앱을 배포하고 공유하려면 Google Workspace Marketplace에 채팅 앱을 구성하고 게시해야 합니다. 자세한 내용은 Google Workspace Marketplace에 앱 게시하기를 참고하세요.
Google Workspace Marketplace에 채팅 앱을 공개적으로 게시하려면 채팅 앱을 제출하여 검토를 받아야 합니다. Google에서는 Chat 앱이 모든 Marketplace 요구사항을 충족하는지 검토합니다. 절차 및 요구사항에 관해 알아보려면 Google Workspace Marketplace의 앱 검토 절차 및 요구사항을 참고하세요.
[null,null,["최종 업데이트: 2025-08-04(UTC)"],[[["\u003cp\u003eThis guide explains how to set up a test version of your Google Chat app to try out interactive features before releasing it to users.\u003c/p\u003e\n"],["\u003cp\u003eYou can add trusted testers within your organization to access and provide feedback on your Chat app before public release.\u003c/p\u003e\n"],["\u003cp\u003eTo test your app, you need to add it to a space in Google Chat, like a direct message or a group chat, where you can interact with its features.\u003c/p\u003e\n"],["\u003cp\u003eBefore publishing your Chat app to the Google Workspace Marketplace, ensure it's thoroughly tested and reviewed to meet all requirements for a smooth user experience.\u003c/p\u003e\n"],["\u003cp\u003eIf you intend to publish your app publicly, it will be subject to a review process by Google to ensure it aligns with Marketplace guidelines.\u003c/p\u003e\n"]]],["To test a Google Chat app with interactive features, configure the app's visibility in the Google Cloud console to make it available to specific testers within your organization. Add testers' email addresses or Google Groups. Then, add the app to Google Chat spaces, either via direct message or by @mentioning it in an existing space. Testers should use the organization's Google Workspace account. Finally, thoroughly test the app's features, troubleshoot errors, and, if applicable, prepare it for publishing on the Google Workspace Marketplace.\n"],null,["| **Note:** This guide explains how to build an interactive Chat app\n| using *Chat API interaction events* . You can also build your\n| Chat app as a Google Workspace add-on. To learn about which framework\n| to use, see [Build an interactive\n| Google Chat app](/workspace/chat/interact-users-overview).\n\n\u003cbr /\u003e\n\nThis page explains how to configure and install a test version of your\nGoogle Chat app so that you can try out interactive features---such as\n[Chat app commands](/workspace/chat/commands), [direct\nmessaging](/workspace/chat/create-messages), and [link\npreviews](/workspace/chat/preview-links)---before releasing them to end users.\n\nBy testing your Chat app, you can ensure that it offers\na high-quality user experience and functions as expected. If you're publishing\nyour Chat app publicly, testing also helps you make\nsure that your Chat app meets the [requirements for\nbeing listed in the\nGoogle Workspace Marketplace](/workspace/marketplace/about-app-review).\n\nTo safely test at each phase of your Chat app's\nlifecycle, we recommend that you set up separate environments for development,\nstaging, and production. In each environment, you should create and deploy a\ndifferent Chat app. To learn how to set up\nenvironments, see [Create and manage deployments for your\nGoogle Chat app](/workspace/chat/create-manage-deployments).\n\nPrerequisites\n\n\u003cbr /\u003e\n\n- A Google Chat app that's configured to receive and respond to [interaction events](/workspace/chat/receive-respond-interactions). To create an interactive Chat app, complete one of the following quickstarts based on the [app architecture](/workspace/chat/structure) that you want to use:\n - [HTTP service](/workspace/chat/quickstart/gcf-app) with Google Cloud Functions\n - [Google Apps Script](/workspace/chat/quickstart/apps-script-app)\n - [Google Cloud Dialogflow CX](/workspace/chat/build-dialogflow-chat-app-natural-language)\n - [Google Cloud Pub/Sub](/workspace/chat/quickstart/pub-sub)\n- To grant access to your Chat app for testing:\n\n - You must have the [`chat.owner`](https://cloud.google.com/iam/docs/understanding-roles.md#hangouts-chat-roles) IAM role . You can also have this role as an [editor or\n owner](https://cloud.google.com/resource-manager/docs/access-control-proj#basic_roles) of the Google Cloud project associated with the Chat app. For details, see [Grant an IAM role by\n using the\n Google Cloud console](https://cloud.google.com/iam/docs/grant-role-console) in the Google Cloud documentation.\n - Anyone who tests the Chat app must belong to the same Google Workspace organization where your Chat app is configured.\n- Ensure that you have access to test and install the\n Chat app in your Google Workspace\n organization. For details, see\n [Configure access for Google Workspace organizations](/workspace/marketplace/how-to-publish#configure-access)\n in the Google Workspace Marketplace documentation.\n\nAdd trusted testers\n\nFor interactive Chat apps, the Chat API lets you share\nyour Chat app with specific people in your\nGoogle Workspace organization. The people that you specify can add the\nChat app to a space and test its features before you\npublish it to the Marketplace. To test your own\nChat app, you must add yourself as a trusted tester.\n\nTo make your test Chat app available to you and others\nin your organization, update the Chat API **Visibility** setting\nin Google Cloud console:\n\n1. In the Google Cloud console, open the Google Chat API page: [Go to Google Chat API page](https://console.cloud.google.com/apis/api/chat.googleapis.com)\n\n2. Click the **Configuration** tab.\n3. Go to **Interactive features** \\\u003e **Visibility** , and then select the **Make this Chat app available to specific people and groups in\n \u003cvar translate=\"no\"\u003eGOOGLE_WORKSPACE_ORGANIZATION\u003c/var\u003e** , where \u003cvar translate=\"no\"\u003eGOOGLE_WORKSPACE_ORGANIZATION\u003c/var\u003e is the name of your organization.\n4. In the field that appears after selecting the checkbox, enter the email addresses of the people or Google Groups that you want to access your Chat app, separated by commas. To test your own Chat app, enter the email address that you use to access Google Chat.\n5. Click **Save**.\n\nAdd your Chat app to spaces\n\nTo start testing interactive features, you must add your\nChat app to one or more spaces, such as a direct\nmessage, group message, or named space. If you haven't added all the members in\nthe space as trusted testers, they might be able to see the\nChat app in the space but can't interact directly with\nit.\n\nChat apps that haven't been published don't appear\nin the listing results from the Google Workspace Marketplace. To find\nunpublished Chat apps in Google Chat, you can search for the Chat app, find it under add_circle_outline **Google Workspace tools** while composing a\nmessage, or @mention the Chat app in a message.\n\nTo add your Chat app to a space, do the following:\n\n1. Open Google Chat using the Google Workspace account that you\n provided when you added yourself as a trusted tester.\n\n [Go to Google Chat](https://chat.google.com)\n2. To start a direct message with the Chat app, do the following:\n 1. Click add **New chat**.\n 2. In the **Add 1 or more people** field, type the name of your Chat app.\n 3. Select your Chat app from the results. A direct message opens.\n3. To add the Chat app to an existing space, do to the following:\n 1. Under **Spaces**, click the name of the space.\n 2. In the Chat space's new message field, enter `@` and the name of the Chat app. Select your Chat app from the results\n 3. Press `Enter` or click send**Send**.\n 4. If the **Add to** space name window appears, click **Add to space**. Your message with the @mention is posted to the Chat space. A text also appears that explains that you added the Chat app to the space.\n\nYou can now test the Chat app in the space.\n\nWhen you test your Chat app, you should review all\nfeatures and then log and fix any errors that you encounter. To understand and\naddress any error messages, see [Troubleshoot and fix Google Chat\nerrors](/workspace/chat/troubleshoot).\n\nReview and test your Chat app for the Google Workspace Marketplace\n\nTo distribute and share a Chat app to anyone not\nlisted as a trusted tester, you must configure and publish the\nChat app to the Google Workspace Marketplace. For\ndetails, see [Publish apps to the Google Workspace Marketplace](/workspace/marketplace/how-to-publish).\n\nIf you want to publish your Chat app publicly on the\nGoogle Workspace Marketplace, you must submit your\nChat app for a review. Google reviews your\nChat app to make sure that it meets all\nMarketplace requirements. To learn about the process\nand requirements, see [App review process and requirements for the\nGoogle Workspace Marketplace](/workspace/marketplace/about-app-review).\n\nRelated topics\n\n- [Create and manage deployments for your Google Chat app](/workspace/chat/create-manage-deployments)\n- [Troubleshoot and fix Google Chat errors](/workspace/chat/troubleshoot-fix-chat-errors)\n- [Query error logs for Google Chat apps](/workspace/chat/query-logs)\n- [Publish apps to the Google Workspace Marketplace](/workspace/marketplace/how-to-publish)"]]
