Google Chat 메시지 보내기

이 페이지에서는 Google Chat 앱이 메시지를 전송하여 사용자 상호작용에 답장하는 방법을 설명합니다.

Google Chat에서 부가기능은 사용자에게 Google Chat 앱으로 표시됩니다. 자세한 내용은 Google Chat 확장 개요를 참고하세요.

기본 요건

메시지 디자인

채팅 앱은 메시지에 다음 중 하나를 포함할 수 있습니다.

• 하이퍼링크, @멘션, 그림 이모티콘이 포함된 텍스트
• 하나 이상의 카드로, 메시지에 표시되거나 새 창에서 대화상자로 열 수 있습니다.
• 하나 이상의 액세서리 위젯: 메일의 텍스트 또는 카드 뒤에 표시되는 버튼입니다.

메시지 디자인에 관한 자세한 내용은 다음 Google Chat API 문서를 참고하세요.

• 메시지 개요
• 메일에서 서식 지정하기
• Google Chat 앱용 카드 빌드하기
• 카드에 텍스트 및 이미지 추가하기
• 카드에 양방향 UI 요소 추가하기

메시지로 응답하기

채팅 앱은 다음과 같은 트리거 또는 상호작용에 메시지로 응답할 수 있습니다.

• 사용자가 채팅 앱을 @멘션하거나 채팅 메시지를 보낼 때와 같은 메시지 트리거
• 사용자가 Google Workspace Marketplace에서 Chat 앱을 설치하거나 스페이스에 추가하는 경우와 같이 스페이스에 추가됨 트리거
• 메시지 또는 대화상자의 카드에서 버튼을 클릭합니다. 예를 들어 사용자가 정보를 입력하고 '제출'을 클릭하는 경우입니다.

또는 Chat 앱은 Google Chat API를 호출하여 메시지를 사전에 보낼 수 있습니다.

메시지로 답장하려면 CreateMessageAction 객체와 함께 작업 DataActions를 반환합니다.

{ "hostAppDataAction": { "chatDataAction": { "createMessageAction": {
  "message": MESSAGE
}}}

MESSAGE를 Chat API의 Message 리소스로 바꿉니다. 작업 작동 방식에 대한 자세한 내용은 채팅 작업을 참고하세요.

다음 예에서는 Chat 앱이 스페이스에 추가될 때마다 텍스트 메시지를 만들어 전송합니다. 사용자가 스페이스에 채팅 앱을 추가할 때 텍스트 메시지를 보내려면 채팅 앱이 DataActions 작업을 반환하여 Added to space 트리거에 응답합니다.

/**
 * Sends an onboarding message when the Chat app is added to a space.
 *
 * @param {Object} req The request object from Google Workspace Add-on.
 * @param {Object} res The response object from the Chat app. An onboarding message that
 *                     introduces the app and helps people get started with it.
 */
exports.cymbalApp = function cymbalApp(req, res) {
  const chatEvent = req.body.chat;
  // Send an onboarding message when added to a Chat space
  if (chatEvent.addedToSpacePayload) {
    res.json({ hostAppDataAction: { chatDataAction: { createMessageAction: { message: {
      text: 'Hi, Cymbal at your service. I help you manage your calendar' +
            'from Google Chat. Take a look at your schedule today by typing' +
            '`/checkCalendar`, or schedule a meeting with `/scheduleMeeting`. To learn' +
            'what else I can do, type `/help`.'
    }}}}});
  }
};

/**
 * Sends an onboarding message when the Chat app is added to a space.
 *
 * @param {Object} event The event object from Chat API.
 * @return {Object} Response from the Chat app. An onboarding message that
 *                  introduces the app and helps people get started with it.
 */
function onAddedToSpace(event) {
  return { hostAppDataAction: { chatDataAction: { createMessageAction: { message: {
    text: 'Hi, Cymbal at your service. I help you manage your calendar' +
          'from Google Chat. Take a look at your schedule today by typing' +
          '`/checkCalendar`, or schedule a meeting with `/scheduleMeeting`. To learn' +
          'what else I can do, type `/help`.'
  }}}}};
}

이 코드 샘플은 다음과 같은 텍스트 메시지를 반환합니다.

메시지로 응답하는 방법에 관한 추가 예시는 다음 가이드를 참고하세요.

• 슬래시 명령어에 응답하기
• 양방향 대화상자 열기
• Google Chat 사용자로부터 정보 수집하기

메시지 업데이트

채팅 앱은 전송하는 메시지를 업데이트할 수도 있습니다. 예를 들어 사용자가 대화상자를 제출하거나 메시지에서 버튼을 클릭한 후 메시지를 업데이트하는 경우

Chat 앱 메시지를 업데이트하려면 다음 예와 같이 UpdateMessageAction와 함께 작업 DataActions를 반환합니다.

{ "hostAppDataAction": { "chatDataAction": { "updateMessageAction": {
  "message": MESSAGE
}}}}

MESSAGE를 Chat API의 Message 리소스로 바꿉니다.

작업 작동 방식에 대한 자세한 내용은 채팅 작업을 참고하세요.

채팅 앱은 사용자가 보낸 링크의 미리보기를 반환하기 위해 사용자의 메시지를 업데이트할 수도 있습니다. 자세한 내용은 Google Chat 메시지에서 링크 미리보기를 참고하세요.

Google Chat API를 사용하여 상호작용에 답장하거나 사전 메시지 전송

Chat 앱은 부가기능 작업을 반환하는 대신 Google Chat API를 사용하여 상호작용에 응답해야 할 수 있습니다. 예를 들어 Chat 앱은 다음 작업을 실행하려면 Google Chat API를 호출해야 합니다.

• 일정에 따라 메시지를 보내거나 외부 리소스의 변경사항에 관한 메시지를 보냅니다. 예를 들어 새 문제 또는 케이스에 관한 알림이 여기에 해당합니다.
• 상호작용 후 30초 이상 후에 답장합니다. 예를 들어 장기 실행 작업을 완료한 후 메시지로 응답하는 경우
• 상호작용이 이루어진 스페이스 외부로 메시지를 보냅니다.
• Chat 사용자를 대신하여 메시지를 보냅니다.

Chat API를 사용하여 메시지를 보내려면 인증을 설정하고 Message 리소스에서 create() 메서드를 호출해야 합니다. 단계는 Google Chat API를 사용하여 메시지 보내기를 참고하세요.

관련 주제

• Google Chat 인터페이스 빌드
• 슬래시 명령어에 응답하기
• 양방향 대화상자 열기
• Google Chat 사용자로부터 정보 수집하기
• Google Chat 메시지에서 링크 미리보기
• Google Chat API를 사용하여 메시지 보내기