이 페이지에서는 Google Chat 앱을 설계할 때 사용자의 요구사항을 고려하는 방법을 설명합니다. Chat 앱이 전 세계에 분산된 수천 명의 팀을 지원하든 한 명의 사용자를 지원하든 설계 과정에 의도한 사용자를 포함하여 메시지를 보내는 모든 사용자를 지원해야 합니다.
Chat 앱 살펴보기
의도한 사용자가 Chat 앱을 처음 발견할 수 있는 위치를 고려하세요. Chat 앱을 게시할 때 사용자가 앱을 찾을 수 있는 위치를 고려하세요.
예를 들어 사용자가 채팅 앱의 기능을 알고 있다고 가정하지 마세요. Chat 앱의 이름이 실제 기능이나 통합된 서비스를 반영하는지 확인하세요.
Chat 앱에 대한 지식
채팅 앱은 사용자가 채팅 앱과 상호작용한 첫 번째 사례일 수 있습니다. 사용자가 채팅 앱의 작동 방식을 알고 있다고 가정하지 마세요. 채팅 앱 명령어 및 대화상자와 같은 기능은 일부 사용자에게 혼란을 줄 수 있으므로 사용자에게 안내를 제공하세요.
예를 들어 사용자에게 슬래시 명령어를 실행하라는 메시지를 표시할 때는 다음 형식을 사용하는 것이 좋습니다.
이 프롬프트는 다음과 같은 이유로 유용합니다.
사용자에게 입력해야 하는 내용을 정확하게 알려줍니다.
특수 서식을 사용하여 /createContact 슬래시 명령어를 주변 텍스트와 구분합니다.
슬래시 명령어의 목표를 나타냅니다.
다른 대화형 채팅 앱 기능으로 사용자를 지원하는 방법을 자세히 알아보려면 사용자 상호작용 설계를 참고하세요.
지역
사용자가 전 세계 어디에서 채팅 앱을 사용하는지 파악합니다. 채팅 스페이스의 사용자는 전 세계에 있는 경우가 많으므로 서로 다른 시간대에서 작업합니다. Chat 앱이 사용자 또는 스페이스에 알림을 보내는 경우 시간대를 고려하세요.
예를 들어 다음 채팅 앱은 해당 주의 당번 검토자에게 알림을 보냅니다. 하지만 팀의 일부는 뉴욕에 있고 일부는 캘리포니아에 있는 경우 모든 사용자에게 편리한 시간에 메시지를 보내도록 Chat 앱을 구성하는 것이 좋습니다.
Chat 앱이 사용자를 직접 멘션하는 경우 알림을 보내기 전에 Calendar API에서 해당 사용자의 시간대를 확인하는 것이 좋습니다. 해당 사용자의 근무 시간 외인 경우 멘션 없이 메시지를 보내거나 근무 시간이 시작될 때까지 기다리는 것이 좋습니다.
언어
채팅 앱은 여러 언어로 사용자에게 응답할 수 있습니다. 두 개 이상의 언어를 지원하려면 채팅 앱이 사용자가 선호하는 언어를 확인하고 그에 따라 콘텐츠를 현지화해야 합니다.
Chat 스페이스의 경우 Chat 앱의 구성 설정에 언어 옵션을 추가합니다. 사용자가 스페이스에서 언어를 설정하면 Chat 앱이 스페이스의 기본 언어를 사용하여 메시지에 응답할 수 있습니다.
Directory API에서 지정된 user.id의 user.languages[]을 가져옵니다.
플랫폼: 웹 대 모바일
Google Chat은 컴퓨터와 휴대기기에서 사용할 수 있습니다. 컴퓨터는 사용자가 버튼과 옵션이 많은 정보 밀도 높은 메시지를 더 잘 받아들일 수 있는 많은 화면 공간을 제공합니다. 휴대기기에서는 화면 크기가 제한되어 있으므로 간결한 메시지가 좋습니다.
카드당 버튼을 3개 이하로 표시하세요. 더 많은 정보가 필요한 경우 대신 대화상자를 실행하는 것이 좋습니다. 대화상자는 여러 카드를 표시할 수 있으므로 단일 카드 메시지에서 모든 정보를 수집하려고 하는 것보다 사용자 입력을 더 친근하게 수집할 수 있습니다.
다양한 크기의 여러 기기에서 채팅 앱을 테스트하여 정보 표시가 이해하기 쉬운지 확인합니다.
음성 및 어조
Chat 앱은 텍스트 기반 인터페이스이므로 명확하고 간결하며 실행 가능한 메시지를 작성하면 사용자가 성공할 수 있습니다. Chat 앱용 메시지를 작성할 때는 Google Material Design 작성 가이드라인을 참고하세요.
채팅 앱마다 다르지만 Chat 사용자와 효과적으로 소통하려면 채팅 앱의 음성과 어조가 다음 특성을 전달해야 합니다.
전문가 Chat 앱이 직장 내 사용자에게 도움이 될 수 있습니다. 성격이 전문적인 환경에 적합해야 합니다. 그렇지 않으면 어색하고 부적절하게 느껴질 수 있습니다.
Authentic Chat 앱은 구어체로 말할 수 있지만 사람인 척해서는 안 됩니다. 채팅 앱에 성별이나 사람과 혼동될 수 있는 이름을 지정하지 마세요. 약간의 캐릭터를 포함하는 것은 좋지만 채팅 앱은 유용성에 중점을 두어야 합니다.
배려심 신중하고 비침습적이어야 합니다. 채팅 앱은 불필요하거나 반복적으로 사용자를 괴롭혀서는 안 됩니다. 사용자의 요구사항을 예측하고 해결 방법을 제공하기 위해 노력합니다.
효율적. 대부분의 사용자는 긴 대화를 원하지 않습니다. 채팅 앱 환경에 집중하여 사용자가 작업을 완료할 수 있도록 지원하세요. 모든 것을 말하는 대신 가장 중요한 것을 말하세요. 많은 양의 정보를 전달해야 하는 경우 긴 메시지를 여러 개의 짧은 메시지로 나눕니다. 각 메시지를 하나의 클릭 유도 문구로 제한하고 표시되는 정보가 최대한 관련성이 있도록 합니다.
격려 사용자가 Chat 앱을 탐색할 때 낙관적이고 친근하게 대하세요. 사용자는 항상 목표를 향해 나아가는 방법을 알아야 합니다. 특히 Chat 앱에 할 수 없는 작업을 요청하는 등 오류가 발생한 경우에 더욱 그렇습니다.
사용자에게 오류나 제한사항이 발생했다고 솔직하게 알리고, 어떻게 진행해야 하는지 안내합니다.
권한, 역할, 데이터 액세스가 다른 사용자
Chat 사용자는 Google Workspace 및 기타 시스템에서 서로 다른 권한과 데이터 액세스 권한을 갖습니다. 하나의 Chat 스페이스에는 관리자, 매니저, 영업 담당자, 고객이 포함될 수 있습니다. 다음은 채팅 앱을 빌드하는 동안 고려해야 할 권한 관련 시나리오입니다.
Chat 앱에 대한 액세스 제한
Google Workspace 관리자는 Google Chat에서 Chat 앱에 액세스할 수 있는 사용자를 제한할 수 있습니다. 자세한 내용은 Google Workspace Marketplace 문서의 앱의 잠재고객 결정하기를 참고하세요.
인증
고객에게 고객의 Google Workspace 도메인에 인증하라는 메시지를 표시하면 작동하지 않을 수 있으며 사용자가 혼란스러워하고 불만을 느낄 수 있습니다. 실행 가능한 오류 메시지를 작성하여 이 가능성을 고려하세요.
Chat 스페이스에서 민감한 정보 공유하기
사용자가 금융 또는 건강 데이터와 같은 민감한 정보를 공유하기 위해 Chat 앱을 인증하는 경우 다른 사용자가 볼 수 있는 Chat 스페이스에서 Chat 앱이 실수로 민감한 정보를 공개하지 않도록 Chat 앱을 1:1 채팅 메시지로 제한하는 것이 좋습니다. Google Cloud 콘솔에서 이 유형의 Chat 앱을 구성할 때 구성 페이지에서 스페이스 및 그룹 대화 참여 체크박스가 선택 해제되어 있는지 확인합니다.
고객이 포함된 Chat 스페이스에서 정보 공유하기
회사의 직원이 고객과 Chat 스페이스를 공유하는 것은 일반적입니다. Chat 앱은 직원과 고객 간의 상호작용에 큰 도움이 될 수 있지만, Chat 앱이 고객과 스페이스를 공유하는 경우 Chat 앱에서 어떤 데이터가 공개될 수 있는지 고려해야 합니다.
예를 들어 채팅 앱이 고객 케이스 세부정보를 공유한다고 가정해 보겠습니다. Chat 앱이 다른 고객과 공유된 Chat 스페이스에서 고객 케이스를 공유하는 경우 고객 정보를 볼 수 없는 사용자에게 고객 정보가 실수로 공개될 수 있습니다.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-08-29(UTC)"],[[["\u003cp\u003eWhen designing your Google Chat app, prioritize user needs by considering factors like app discoverability and user familiarity with Chat app features.\u003c/p\u003e\n"],["\u003cp\u003eAccount for global users by considering time zones and offering multi-language support to enhance user experience.\u003c/p\u003e\n"],["\u003cp\u003eOptimize your Chat app for both web and mobile platforms, ensuring clear and concise messaging while adapting to screen size limitations.\u003c/p\u003e\n"],["\u003cp\u003eMaintain a professional, authentic, and considerate tone in your Chat app's communication, prioritizing user efficiency and providing clear error handling.\u003c/p\u003e\n"],["\u003cp\u003eBe mindful of user permissions and data access, ensuring sensitive information is shared appropriately and avoiding unintended data exposure in shared spaces.\u003c/p\u003e\n"]]],["When designing a Google Chat app, prioritize user needs by considering their discovery, familiarity with Chat apps, geography, and preferred language. Ensure clear, concise communication with a professional, authentic, considerate, efficient, and encouraging voice. Optimize for both web and mobile platforms, and be mindful of varying user permissions and data access. Protect sensitive data and avoid accidental information leaks in shared spaces. Tailor messages based on user preferences and test across different devices.\n"],null,["# Identify your users' needs\n\nThis page describes how to account for your users' needs when designing a\nGoogle Chat app. Whether your Chat app\nsupports a globally distributed team of thousands or just one person, ensure\nyour Chat app helps everyone who messages it by\nincluding the intended user in your design process.\n\nDiscover your Chat app\n----------------------\n\nConsider where your intended users can discover your\nChat app for the first time. When you\n[publish your Chat app](/workspace/marketplace/how-to-publish),\nthink about where users can find it.\n\nFor example, don't assume that users know what your\nChat app does. Make sure your\nChat app's name reflects what it actually does, or the\nservice that it integrates with.\n\nFamiliarity with Chat apps\n--------------------------\n\nYour Chat app might be the first interaction a user has\nhad with Chat apps. Don't assume that users know how a\nChat app works. Features like\n[Chat app commands](/workspace/chat/commands)\nand\n[dialogs](/workspace/chat/dialogs)\nmight confuse some users, so give them instructions.\n\nFor example, when prompting the user to issue a slash command, we recommend the\nfollowing format:\n\nThis prompt is helpful for the following reasons:\n\n- Tells the user exactly what they need to type.\n- Uses special formatting to make the `/createContact` slash command stand out from the surrounding text.\n- States the goal of the slash command.\n\nTo learn more about how to help users with other interactive\nChat app features, see\n[Design user interactions](/workspace/chat/interactivity).\n\nGeography\n---------\n\nIdentify where in the world your users use your\nChat app. Oftentimes, people in a Chat\nspace are located all over the world, which means that they're working in\ndifferent time zones. If your Chat app sends\nnotifications to users or spaces, be mindful of the time of day.\n\nFor example, the following Chat app notifies whomever\nis the on-call reviewer for the week. But, if part of the team is in New York,\nand part of the team is in California, we recommend configuring the\nChat app to send a message at a time that is convenient\nfor all users.\n\nIf your Chat app\n[mentions a user directly](/workspace/chat/format-messages#messages-@mention),\nconsider checking that user's timezone in the\n[Calendar API](/workspace/calendar/api/v3/reference/calendars)\nbefore sending the notification. If it's outside that user's working hours,\nconsider sending the message without a mention, or waiting until their work day\nbegins.\n\nLanguage\n--------\n\nYour Chat app can respond to users in multiple\nlanguages. To support more than one language, your\nChat app must check for a user's preferred language\nand localize its content accordingly.\n\nFor Chat spaces, add a language option to the\nChat app's configuration settings. After users set a\nlanguage in the space, your Chat app can respond to\nmessages using the space's preferred language.\n\nTo check a user's preferred language:\n\n1. Get `User.name` from the [`User`](/workspace/chat/api/reference/rest/v1/User) type in the Google Chat API.\n2. Map `User.name` to [`user.id`](/workspace/admin/directory/reference/rest/v1/users) in the Directory API.\n3. Get `user.languages[]` for the given `user.id` in the Directory API.\n\nPlatform: web versus mobile\n---------------------------\n\nGoogle Chat is available on computers and mobile devices. Computers offer lots\nof screen space where users might be more accepting of information-dense\nmessages with lots of buttons and options. On mobile devices, users appreciate\nsuccinct messages due to the limited screen size.\n\nTry to show three or fewer buttons per card. If you need more, consider\nlaunching a\n[dialog](/workspace/chat/dialogs) instead. Dialogs can present a series of cards\nthat make gathering lots of user input a friendlier experience than trying to\ncollect all of the information in a single card message.\n\nTest your Chat app on multiple devices of varying sizes\nto make sure its presentation of information is digestible.\n\nVoice and tone\n--------------\n\nBecause Chat apps are text-based interfaces, writing clear,\nconcise, and actionable messages ensures user success. When writing messages for\nyour Chat app, consult the\n[Google Material Design writing guidelines](https://material.io/design/communication/writing.html).\n\nEach Chat app is different, but to communicate\neffectively with Chat users, your\nChat app's voice and tone should convey the following\ncharacteristics:\n\n- **Professional**. Your Chat app might be helping\n people at work. Make sure its personality fits into a professional setting,\n or it might feel jarring and inappropriate.\n\n- **Authentic**. Chat apps can speak colloquially, but\n shouldn't pretend to be human. Avoid giving your\n Chat app a gender, or a name that could be confused\n with a person. Including a little character is good, but your\n Chat app should focus on its utility.\n\n- **Considerate**. Be thoughtful and noninvasive. Your\n Chat app shouldn't bother users unnecessarily or\n repeatedly. Strive to anticipate user needs and offer solutions.\n\n- **Efficient**. Recognize that most users aren't looking for a long\n conversation. Help people complete tasks by keeping the\n Chat app experience focused. Avoid saying\n everything in favor of saying the most important things. If you do need to\n convey a large amount of information, break long messages into multiple\n short messages. Try to limit each message to one call to action, and make\n the information presented as relevant as possible.\n\n- **Encouraging**. Be optimistic and friendly with users as they explore your\n Chat app. Users should always know how to move\n ahead towards their goal, especially if they encounter an error, like asking\n your Chat app to do something that it can't.\n Honestly tell users that they've encountered an error or limitation, and\n tell them how to proceed.\n\nUsers with different permissions, roles, and data access\n--------------------------------------------------------\n\nPeople in Chat have different permissions and data access in\nGoogle Workspace and other systems. A single Chat space could\ninclude administrators, managers, sales people, and customers. These are some of\nthe permission-related scenarios to consider while building your\nChat app:\n\n### Limited access to Chat apps\n\nGoogle Workspace administrators can limit who has access to\nChat apps in Google Chat. For more information, see\n[Determine the audience for your app](/workspace/marketplace/how-to-publish#audience)\nin the Google Workspace Marketplace documentation.\n\n### Authentication\n\nPrompting a customer to authenticate to a customer's Google Workspace\ndomain might not work, and might confuse and frustrate the user. Account for\nthis possibility by writing an [actionable error message](/workspace/chat/write-error-messages).\n\n### Share sensitive information in Chat spaces\n\nIf a user authenticates a Chat app to share sensitive\ninformation, like financial or health data, it might be best to limit that\nChat app to 1:1 direct messages so that the\nChat app doesn't accidentally reveal sensitive\ninformation in a Chat space where others might see it. When\nconfiguring this type of Chat app in the\nGoogle Cloud console, on the\n[**Configuration** page](https://console.cloud.google.com/apis/api/chat.googleapis.com/hangouts-chat),\nmake sure that the **Join spaces and group conversations** checkbox is cleared\nand unselected.\n\n### Share information in Chat spaces that include customers\n\nIt's common for employees of a company to share a Chat space with\ncustomers. Your Chat app can be a real boon to\nemployee-customer interactions, but if your Chat app\nshares a space with customers, it's important to consider what data your\nChat app might reveal.\n\nFor example, say your Chat app shares customer case\ndetails. If your Chat app shares a customer case in a\nChat space shared with other customers, it might accidentally\nreveal customer information to people who shouldn't see it.\n\nRelated topics\n--------------\n\n- [Write actionable error messages](/workspace/chat/write-error-messages)\n- [Define all user journeys](/workspace/chat/journeys)"]]
