Dialogflow Google Chat 통합

참고: 이전에는 Google Chat을 행아웃 채팅이라 했습니다. Dialogflow Console에서도 Google Chat을 행아웃 채팅이라고 합니다.

Dialogflow Google Chat 통합으로 일대일 채팅 및 채팅방에 포함할 수 있는 봇을 만들 수 있습니다. 자세한 내용은 Google Chat API 문서를 참조하세요.

참고: 이 통합은 Google Workspace 사용자에게만 제공됩니다. 또한 Google Workspace 관리자는 사용자가 봇을 설치하도록 허용해야 합니다.

제한사항

이 통합에서는 기본 에이전트 언어만 지원합니다.

설정

Google Chat 통합을 설치하거나 사용 설정하는 방법은 다음과 같습니다.

1. 왼쪽 메뉴에서 통합을 클릭합니다.
2. 행아웃 채팅을 클릭합니다.
3. 액세스 옵션을 선택합니다.
4. [선택사항] 에이전트 환경을 선택합니다.
5. 시작을 클릭합니다.

참고: 봇을 중지하려면 Google Chat 통합 페이지로 돌아가 오른쪽 하단에서 중지를 클릭합니다.

봇 구성

Google Chat 봇을 만들고 나면 통합 팝업에서 봇 세부정보 구성 버튼을 클릭하여 세부정보를 변경할 수 있습니다. Google Chat API에 대한 Google Cloud Console 페이지로 이동됩니다.

Google Chat API 봇 게시 가이드의 안내에 따라 봇을 구성 및 게시합니다.

봇 아바타 구성

봇 아바타를 구성하는 두 가지 대안은 다음과 같습니다.

• 통합 설정에서 봇 세부정보 구성 버튼을 클릭하고 아바타 URL 필드에 아바타 URL을 입력합니다.
• 에이전트 일반 설정의 에이전트 아바타 URI 필드에 아바타 URL을 입력합니다.

Cloud Console을 사용하여 사용 설정 및 구성

다음 단계를 수행하여 Cloud Console을 통해 Google Chat 통합을 사용 설정할 수도 있습니다.

1. Cloud Console의 왼쪽 상단에 있는 메뉴 아이콘 을 클릭합니다.
2. API 및 서비스, 대시보드를 차례로 클릭합니다.
3. API 및 서비스 사용 설정을 클릭합니다.
4. 'Google Chat API'를 검색합니다.
5. Google Chat API 타일을 클릭합니다.
6. 사용 설정을 클릭합니다.
7. 왼쪽 사이드바 메뉴에서 구성을 클릭합니다.
8. Google Chat API 봇 게시 가이드의 안내에 따라 봇을 구성 및 게시합니다.

테스트

봇을 테스트하기 전에 봇을 시작했는지 확인하세요. 설정 섹션을 참조하세요.

봇을 테스트하는 방법은 다음과 같습니다.

1. Google Chat으로 이동합니다.
2. 검색 필드를 클릭합니다.
3. 봇 찾기를 선택합니다.
4. 봇 이름을 선택합니다.
5. 메시지를 클릭합니다.

문제해결

오류	해결책
관리자가 채팅 메시지에서 봇과 채팅하는 것을 사용 중지했습니다.	Google Workspace 관리자에게 사용자가 봇을 설치하도록 허용할 것을 요청합니다.

리치 응답 메시지

통합하면 일부 서식 있는 응답 메시지를 Google Chat 메시지 형식으로 변환합니다.

텍스트 응답

텍스트 응답은 SimpleText로 Google Chat에 전송됩니다. 이 서식을 사용하면 텍스트를 특정(마크다운 라이트) 기호로 래핑하여 텍스트를 굵게 또는 기울임꼴로 만들 수 있습니다.

SimpleText 응답은 Dialogflow 콘솔에서 기본 텍스트 응답과 시각적으로 유사합니다. 하지만 원시 API 응답은 약간 다르게 보입니다. 또한 플랫폼 구성을 GOOGLE_HANGOUTS로 설정합니다. 이 구성은 여러 통합을 위한 에이전트를 빌드할 때 유용할 수 있습니다.

"fulfillmentMessages": [
{
   "text": {
   "text": [
        "This is a test."
   ]
},
  "platform": "GOOGLE_HANGOUTS"
},

이미지

이미지 응답은 Google Chat 이미지 위젯으로 Google Chat에 전송됩니다.

카드

카드 응답은 Google Chat 카드로 Google Chat에 전송됩니다.

커스텀 페이로드

다른 유형의 Google Chat 메시지를 전송하려면 커스텀 페이로드를 사용하면 됩니다.

Google Chat 커스텀 페이로드를 사용하면 고급 카드를 만들 수 있습니다. 카드 하나에 섹션이 한 개 이상 있을 수 있습니다. 각 섹션에는 헤더가 있을 수 있습니다. Google Chat 메시지 형식 카드 참조 가이드를 살펴보고 이를 사용하여 만들 수 있는 몇 가지 조합을 알아볼 수 있습니다. 하지만 커스텀 페이로드를 사용하면 JSON 형식을 제공해야 합니다.

참고: 참조 가이드의 예시를 Dialogflow의 커스텀 페이로드 상자에 복사하여 붙여넣을 때 다음 사항에 유의해야 합니다. 첫 번째 키는 카드라고 할 수 없지만 행아웃으로 이름을 지정해야 합니다. 행아웃 키는 카드의 배열이 아니라 객체를 가리킵니다. 편집기에 린트 오류가 포함되어 있지 않은지 확인합니다. Dialogflow 시뮬레이터에서 결과를 테스트할 수 없으며 Google Chat에서 직접 테스트해야 합니다.

다음은 작업 예시입니다.

{
  "hangouts": {
    "header": {
      "title": "Pizza Bot Customer Support",
      "subtitle": "[e-mail]",
      "imageUrl": "https://goo.gl/aeDtrS"
    },
    "sections": [{
      "widgets": [{
        "keyValue": {
          "icon": "TRAIN",
          "topLabel": "Order No.",
          "content": "12345"
        }
      },
      {
        "keyValue": {
          "topLabel": "Status",
          "content": "In Delivery"
        }
      }]
    },
    {
      "header": "Location",
      "widgets": [{
        "image": {
          "imageUrl": "https://dummyimage.com/600x400/000/fff"
        }
      }]
    },
    {
      "header": "Buttons - I could leave the header out",
      "widgets": [{
        "buttons": [{
          "textButton": {
            "text": "OPEN ORDER",
            "onClick": {
              "openLink": {
                "url": "https://example.com/orders/..."
              }
            }
          }
        }]
      }]
    }]
  }
}