이 페이지에서는 Google Chat 앱의 빠른 명령어를 설정하고 응답하는 방법을 설명합니다.
빠른 명령어는 사용자가 Chat 앱을 호출하고 상호작용할 수 있는 방법입니다. 빠른 명령어를 사용하려면 Chat 스페이스 또는 대화에서 Google Workspace 도구 를 클릭하여 통합 메뉴를 연 다음 이름이 슬래시 (/)로 시작하지 않는 앱 명령어를 선택합니다. 빠른 명령어를 선택하면 사용자의 추가 입력 없이 Chat 앱이 직접 호출되므로 빠른 사용자 상호작용이 가능합니다.
사용자는 슬래시 명령어를 통해 Chat 앱을 호출할 수도 있습니다. 단계는 슬래시 명령어에 응답을 참고하세요. 슬래시 명령어와 비교하여 빠른 명령어는 채팅 UI에서 더 사용자 친화적인 이름으로 형식이 지정되며 선택 시 즉시 호출되며 사용자가 슬래시 명령어의 이름을 기억하거나 입력할 필요가 없습니다.
Google Chat API에서 빠른 명령어 설정
빠른 명령어를 만들거나 기존 슬래시 명령어를 빠른 명령어로 업데이트하려면 Chat 앱의 Google Chat API 구성에서 명령어에 관한 정보를 지정해야 합니다.
Google Chat API에서 빠른 명령어를 구성하려면 다음 단계를 완료하세요.
Google Cloud 콘솔에서 메뉴 > API 및 서비스 > 사용 설정된 API 및 서비스 > Google Chat API를 클릭합니다.
구성을 클릭합니다.
명령어에서 명령어 추가를 클릭합니다.
명령어의 명령어 ID, 이름, 설명, 명령어 유형을 입력합니다.
- 명령어 ID: Chat 앱에서 명령어를 인식하고 응답을 반환하는 데 사용하는 1~1,000 사이의 숫자입니다.
- 이름: 명령어의 표시 이름입니다. 이름은 최대 50자(영문 기준)까지 지정할 수 있으며 특수문자를 포함할 수 있습니다.
- 짧고 설명적이고 실행 가능한 단어 또는 문구를 사용하여 명령어를 사용자에게 명확하게 전달합니다. 예를 들어 연락처 레코드를 수정하는 명령어에는 연락처 업데이트를 사용합니다.
- 설명: 명령어의 기능을 설명하는 텍스트입니다.
설명은 최대 50자(영문 기준)까지 입력할 수 있으며 특수문자를 포함할 수 있습니다.
- 사용자가 명령어를 호출할 때 어떤 결과를 얻을 수 있는지 알 수 있도록 설명을 짧고 명확하게 유지합니다.
- Chat 앱이 스페이스의 모든 사용자에게 답장하는지 또는 명령어를 호출한 사용자에게 비공개로 답장하는지 사용자에게 알립니다. 예를 들어 빠른 명령어 정보의 경우 이 앱에 대해 알아보기 (나에게만 표시됨)라고 설명할 수 있습니다.
- 명령어 유형: 빠른 명령어를 선택합니다.
선택사항: 채팅 앱이 대화상자로 명령어에 응답하도록 하려면 대화상자 열기 체크박스를 선택합니다.
저장을 클릭합니다.
이제 Chat 앱에 빠른 명령어가 구성되었습니다.
빠른 명령어에 응답
사용자가 빠른 명령어를 호출하면 채팅 앱은 APP_COMMAND 상호작용 이벤트를 수신합니다.
이벤트 페이로드에는 호출된 명령어에 관한 세부정보 (명령어 ID 및 명령어 유형 포함)가 포함된 appCommandMetadata 객체가 포함되어 있으므로 적절한 응답을 반환할 수 있습니다.
다음 코드는 APP_COMMAND 상호작용 이벤트를 처리하고 이벤트 페이로드에 일치하는 명령어 ID가 포함되어 있는지 감지하여 도움말 명령어에 응답하는 Chat 앱의 예를 보여줍니다. 이벤트 페이로드에 명령어 ID가 포함된 경우 Chat 앱은 비공개 메시지를 반환합니다.
Apps Script
// Handle the APP_COMMAND event type.
function onAppCommand(event) {
// Executes the command logic based on its ID.
// Command IDs are set in the Google Chat API configuration.
switch (event.appCommandMetadata.appCommandId) {
case HELP_COMMAND_ID:
return {
privateMessageViewer: event.user,
text: 'The Avatar app replies to Google Chat messages.'
};
}
}
Chat API에서 빠른 명령어를 구성할 때 지정한 명령어 ID로 HELP_COMMAND_ID를 설정합니다.
이 코드를 테스트하려면 Google Chat 앱의 양방향 기능 테스트를 참고하세요.
Chat에서 빠른 명령어를 테스트하려면 Google Workspace 도구 를 클릭한 다음 빠른 명령어를 선택하여 통합 메뉴를 엽니다.
기존 슬래시 명령어를 빠른 명령어로 전환
기존 슬래시 명령어를 빠른 명령어로 수정하려면 Google Chat API에서 명령어 유형을 슬래시 명령어에서 빠른 명령어로 변경하여 슬래시 명령어를 수정합니다.
사용자가 빠른 명령어를 호출하면 채팅 앱은 슬래시 명령어에 대해 전송되는 MESSAGE 상호작용 이벤트 대신 APP_COMMAND 상호작용 이벤트를 수신합니다. 호출된 빠른 명령어에 관한 세부정보가 포함된 appCommandMetadata 객체가 포함된 이벤트 페이로드를 읽어서 이 상호작용 이벤트 유형을 처리하도록 Chat 앱을 업데이트합니다. 빠른 명령어에 응답을 참고하세요.