이 페이지에서는 슬래시 명령어를 설정하고 이에 응답하는 방법을 설명합니다. Google Chat 앱
슬래시 명령어는 사용자가 채팅 앱 또한 슬래시 명령어를 사용하면 채팅 앱의 주요 기능 사용
슬래시 명령어를 사용하려면 슬래시 (/
)를 입력한 후 짧은 텍스트 명령어를 입력합니다.
채팅 앱에 관한 정보를 얻는 방법(예: /about
)
사용자는 슬래시를 입력하여 사용 가능한 슬래시 명령어를 찾을 수 있습니다.
Google Chat - 사용 가능한 명령어를 나열하는 창이 표시됨
채팅 앱:
![슬래시 명령어 창](https://developers-dot-devsite-v2-prod.appspot.com/static/workspace/chat/images/slash-command-window.png?authuser=0000&hl=ko)
슬래시 명령어의 설정 여부를 결정하고 사용자 상호작용을 설계하고 모든 사용자 여정을 정의합니다.
비공개 응답이 있는 슬래시 명령어
사용자가 슬래시 명령어가 포함된 메일을 보내면 사용자 및 채팅 앱에 표시됩니다. 만약 채팅 앱이 스페이스에 추가되도록 구성함 슬래시 명령에 응답하려면 비공개로 설정하여 사용자와 채팅 앱
예를 들어 사용자가 앱을 사용하는
사용자는 /about
또는 /help
와 같은 명령어를 사용할 수 있습니다.
스페이스에 있는 다른 모든 사용자에게 알림을 보내지 않기 위해
채팅 앱이
채팅 앱 사용 방법 및 지원 받는 방법
기본 요건
Node.js
양방향 기능이 사용 설정된 Google Chat 앱 대화형 채팅 앱을 사용하려면 이 빠른 시작을 완료하세요.
Apps Script
양방향 기능이 사용 설정된 Google Chat 앱 Apps Script에서 대화형 채팅 앱을 사용하려면 이 빠른 시작을 완료하세요.
Python
양방향 기능이 사용 설정된 Google Chat 앱 대화형 채팅 앱을 사용하려면 이 빠른 시작을 완료하세요.
자바
양방향 기능이 사용 설정된 Google Chat 앱 대화형 채팅 앱을 사용하려면 이 빠른 시작을 완료하세요.
슬래시 명령어 설정
이 섹션에서는 슬래시 설정을 위한 다음 단계를 완료하는 방법을 설명합니다. 명령어:
- 슬래시 명령어의 이름을 만듭니다.
- Google Chat API에서 슬래시 명령어를 구성합니다.
슬래시 명령어 이름 지정
슬래시 명령어의 이름은 사용자가 Chat 메시지에 입력하는 이름입니다 채팅 앱을 호출합니다. 간단한 설명도 이 이름 아래에 표시되어 사용자에게 명령어 사용 방법에 관한 추가 메시지를 표시합니다.
<ph type="x-smartling-placeholder">![슬래시 명령어 이름 및 설명](https://developers-dot-devsite-v2-prod.appspot.com/static/workspace/chat/images/slash-command-description.png?authuser=0000&hl=ko)
슬래시 명령어의 이름과 설명을 선택할 때는 다음 권장 사항을 참고하세요.
슬래시 명령어의 이름을 지정하려면 다음 안내를 따르세요.
- 짧고, 설명적이고, 실행 가능한 단어나 문구를 사용하여
사용자에게 명확하고 간단한 명령을 내릴 수 있습니다. 예를 들어,
/createAReminder
,/remindMe
사용 - 명령어에 단어가 2개 이상 포함된 경우 사용자가 명령어를 읽을 수 있도록 돕습니다.
첫 번째 단어는 모두 소문자를 사용하고 첫 번째 단어는 대문자로 표기해야 합니다.
추가 단어의 문자입니다. 예를 들어
/updatecontact
대신/updateContact
사용 - 명령어에 고유한 이름을 사용할지, 일반 이름을 사용할지 고려합니다. 만약
명령이 일반적인 상호작용이나 기능을 설명하는 경우
사용자가 알아보고 예상하는 일반적인 이름(예:
/settings
또는/feedback
그렇지 않으면 고유한 명령 이름을 사용하는 것이 좋습니다. 명령어 이름이 다른 채팅 앱과 동일하다면 사용자는 비슷한 명령어를 필터링하여 사용하는 명령어를 찾고 사용하세요.
- 짧고, 설명적이고, 실행 가능한 단어나 문구를 사용하여
사용자에게 명확하고 간단한 명령을 내릴 수 있습니다. 예를 들어,
슬래시 명령어를 설명하는 방법은 다음과 같습니다.
- 사용자가 내용을 이해할 수 있도록 설명을 짧고 명확하게 작성합니다. 메시지가 표시될 수 있습니다
- 명령어에 형식 요구사항이 있는지 사용자에게 알립니다.
예를 들어 인수가 필요한
/remindMe
명령어를 만드는 경우 설명을Remind me to do [something] at [time]
와 같이 설정하세요. - 채팅 앱이 답장하면 사용자에게 알립니다.
스페이스에 있는 모든 사용자 또는 명령어를 호출하는 사용자에게 비공개로
표시합니다
예를 들어 슬래시 명령어
/about
의 경우 다음과 같이 설명할 수 있습니다.Learn about this app (Only visible to you)
비공개 메시지로 응답 섹션을 참고하세요.
Google Chat API에서 슬래시 명령어 구성
슬래시 명령어를 만들려면 명령어에 대한 정보를 Google Chat API에 대한 채팅 앱 구성
Google Chat API에서 슬래시 명령어를 구성하려면 다음을 완료합니다. 단계:
Google Cloud 콘솔에서 메뉴를 클릭합니다. > API 및 서비스 > 사용 설정된 API 및 서비스 > Google Chat API
구성을 클릭합니다.
슬래시 명령어에서 슬래시 명령어 추가를 클릭합니다.
명령어의 이름, 명령어 ID, 설명을 입력합니다.
- 이름: 명령어의 표시 이름 및 사용자가 입력하는 내용 앱을 호출할 수 있습니다. 슬래시로 시작하고 텍스트만 포함해야 하며 최대 50자(영문 기준)여야 합니다
- 설명: 사용 및 형식 지정 방법을 설명하는 텍스트입니다. 지정할 수도 있습니다 설명은 최대 50자(영문 기준)까지 입력할 수 있습니다.
- 명령어 ID: 명령어를 실행할 1~1,000 사이의 숫자 채팅 앱이 슬래시 명령어를 인식하는 데 사용합니다. 응답을 반환합니다
선택사항: 채팅 앱에서 대화상자가 있는 명령어를 실행하려면 대화상자 열기 체크박스
저장을 클릭합니다.
이제 채팅 앱에 슬래시 명령어가 구성되었습니다.
슬래시 명령어에 응답
<ph type="x-smartling-placeholder">
사용자가 슬래시 명령어가 포함된 Chat 메시지를 작성하는 경우
채팅 앱이 MESSAGE
상호작용 이벤트를 수신합니다.
이벤트 페이로드에는 slashCommand
가 포함됩니다.
및 slashCommandMetadata
객체입니다. 이러한 객체에는 메시지에서 사용된 명령어에 대한 세부정보가 포함됩니다.
(명령어 ID 포함)을 사용하여 적절한 응답을 반환할 수 있습니다.
![비공개 메시지:
Cymbal Labs 채팅 앱 메시지에
Cymbal Labs에서 만든 채팅 앱은 링크를 공유합니다.
문서 및 지원팀에 문의할 수 있는 링크를 제공합니다.](https://developers-dot-devsite-v2-prod.appspot.com/static/workspace/chat/images/private-message.png?authuser=0000&hl=ko)
/help
로 지원을 받는 방법을 설명합니다.다음 코드는 채팅 앱의 예를 보여줍니다.
/about
슬래시 명령어에 응답하는
MESSAGE
상호작용 이벤트 및
메시지에 일치하는 명령어 ID가 포함되어 있는지 여부 메시지에
명령어 ID를 요청하면 채팅 앱이 비공개 메시지를 반환합니다.
Node.js
Apps Script
Python
자바
명령어 ID로 ABOUT_COMMAND_ID
를 설정합니다.
지정된
Chat API에서 슬래시 명령어를 구성
이 코드를 테스트하려면 다음을 참고하세요.
Google Chat 앱의 양방향 기능 테스트하기
관련 주제
- 슬래시 명령어를 사용하는 채팅 앱 샘플 보기
- 메시지 보내기
- 비공개 메시지 보내기
- 대화형 대화상자 열기