리치 응답 메시지

많은 통합 플랫폼이 플랫폼별 리치 응답 메시지를 지원합니다. 이러한 메시지는 최종 사용자에게 단순한 텍스트 응답 이상의 경험을 제공하는 데 사용할 수 있습니다. 선택할 수 있는 다양한 응답 유형이 있습니다. 예를 들어 이미지를 표시하거나 오디오를 재생하거나 버튼을 제공할 수 있습니다. 각 플랫폼은 선택할 수 있는 응답 유형의 하위 집합을 지원합니다.

이 데이터를 찾을 수 있는 위치

에이전트를 빌드할 때는 Dialogflow ES 콘솔을 사용하는 것이 가장 일반적입니다(문서 보기, 콘솔 열기). 아래의 안내는 콘솔 사용에 중점을 둡니다. 인텐트 응답 데이터에 액세스하려면 다음 안내를 따르세요.

  1. Dialogflow ES 콘솔로 이동합니다.
  2. 에이전트를 선택합니다.
  3. 왼쪽 사이드바 메뉴에서 인텐트를 선택합니다.
  4. 인텐트를 선택합니다.
  5. 응답 섹션까지 아래로 스크롤합니다.

콘솔 대신 API를 사용하여 에이전트를 빌드하는 경우 인텐트 참조를 확인하세요. API 필드 이름은 콘솔 필드 이름과 유사합니다. 아래 안내에서 콘솔과 API의 중요한 차이점을 볼 수 있습니다.

리치 응답 메시지 추가

응답 섹션에는 기본 플랫폼을 비롯한 각 플랫폼의 탭이 있습니다. 모든 플랫폼에서 사용될 수 있는 기본 플랫폼용 응답을 정의할 수 있습니다.

리치 메시지 추가 스크린샷

플랫폼별 탭에서 각 플랫폼에서만 작동하는 응답을 정의할 수 있습니다. 또한 특정 플랫폼에 기본 응답이 사용되게 할 수도 있습니다. 이러면 모든 플랫폼에 텍스트 응답을 중복으로 만들 필요가 없습니다.

리치 메시지 추가 스크린샷

리치 응답 메시지를 추가하려면 다음 안내를 따르세요.

  1. 원하는 플랫폼 탭을 선택합니다. 원하는 플랫폼 탭이 표시되지 않으면 추가 버튼을 클릭하여 선택합니다.
  2. 응답 추가 버튼을 클릭합니다. 드롭다운에 선택한 플랫폼에서 지원하는 응답 유형이 표시됩니다.
  3. 응답 유형을 선택합니다. 응답 유형은 아래에서 설명됩니다.
  4. 선택한 응답 유형의 필드에 입력합니다.
  5. 필요에 따라 플랫폼 탭과 응답을 더 추가합니다. 각 탭에서 메시지를 순서대로 최대 10개까지 추가할 수 있습니다.
  6. 저장을 클릭합니다.

응답에 매개변수 참조를 사용하면 런타임에서 최종 사용자가 제공하거나 이벤트에서 제공하는 매개변수를 참조할 수 있습니다.

텍스트 응답

기본적으로 텍스트 응답은 최종 사용자에게 텍스트 응답을 보냅니다.

텍스트 음성 변환이 에이전트에 대해 사용 설정되었거나 인텐트 감지 요청에 의해 요청된 경우 제공된 텍스트는 음성을 합성하고 오디오를 재생하는데 사용됩니다. 이 경우 제공되는 텍스트는 선택적으로 음성 합성 마크업 언어(SSML)를 사용할 수 있습니다.

제공되는 필드는 다음과 같습니다.

  • 텍스트 또는 SSML 항목 목록

응답을 입력할 때 줄바꿈을 입력하려면 Shift + Enter를 누르고 다른 텍스트를 입력하려면 Enter만 누릅니다.

다음과 같은 제한사항이 적용됩니다.

  • 텍스트 응답당 최대 300개의 텍스트 항목

이미지 응답

이미지 응답은 최종 사용자에게 이미지를 보냅니다. 여기에는 다음과 같은 필드가 포함됩니다.

  • 공개적으로 액세스할 수 있는 이미지 URL

카드 응답

카드 응답은 최종 사용자에게 이미지, 카드 제목, 카드 자막, 대화형 버튼을 보냅니다. 카드 스타일은 플랫폼에 따라 다양합니다.

최종 사용자를 URL로 보내거나 최종 사용자가 표현을 제공한 것처럼 사전 구성된 텍스트를 Dialogflow로 보내도록 버튼을 구성할 수 있습니다.

일부 필드는 플랫폼에 따라 선택사항입니다.

  • 공개적으로 액세스할 수 있는 이미지 URL
  • 카드 제목
  • 카드 자막
  • 다음 필드가 있는 버튼 목록:
    • 버튼 이름
    • 최종 사용자 표현인 것처럼 보낼 텍스트 또는 이동할 URL

다음과 같은 제한사항이 적용됩니다.

  • 인텐트의 플랫폼 및 언어당 최대 10개의 카드 예를 들어 에이전트가 영어, 프랑스어, 플랫폼 X, 플랫폼 Y를 지원하는 경우 인텐트는 최대 40개의 카드를 가질 수 있습니다.

    • 플랫폼 X의 영어 카드 10개
    • 플랫폼 Y의 영어 카드 10개
    • 플랫폼 X의 프랑스어 카드 10개
    • 플랫폼 Y의 프랑스어 카드 10개

빠른 답장 응답

빠른 답장 응답은 최종 사용자에게 버튼을 보냅니다. 최종 사용자가 표현을 제공한 것처럼 사전 구성된 텍스트를 Dialogflow로 보내도록 버튼을 구성할 수 있습니다.

제공되는 필드는 다음과 같습니다.

  • 버튼 이름
  • 최종 사용자 표현인 것처럼 보낼 텍스트 항목 목록

다음과 같은 제한사항이 적용됩니다.

  • 인텐트의 플랫폼 및 언어당 빠른 응답 최대 1개 예를 들어 에이전트가 영어, 프랑스어, 플랫폼 X, 플랫폼 Y를 지원하는 경우 인텐트는 최대 4개의 빠른 응답을 가질 수 있습니다.

    • 플랫폼 X의 영어 빠른 답장 1개
    • 플랫폼 Y의 영어 빠른 답장 1개
    • 플랫폼 X의 프랑스어 빠른 답장 1개
    • 플랫폼 Y의 프랑스어 빠른 답장 1개
  • 빠른 답장 응답당 최대 10개의 텍스트 항목

  • 텍스트 항목당 최대 20자(영문 기준)

합성 음성 응답

합성 음성 응답은 텍스트 응답의 음성을 합성하고 오디오를 재생하는데 사용됩니다. 제공되는 텍스트는 선택적으로 음성 합성 마크업 언어(SSML)를 사용할 수 있습니다.

제공되는 필드는 다음과 같습니다.

  • 텍스트 또는 SSML

다음과 같은 제한사항이 적용됩니다.

오디오 재생 응답

오디오 재생 응답은 오디오 파일을 재생하는데 사용됩니다. 오디오 파일은 Cloud Storage 버킷에서 제공됩니다.

제공되는 필드는 다음과 같습니다.

  • gs://bucket-name/object-name 형식의 Cloud Storage 객체 URI

다음과 같은 제한사항이 적용됩니다.

  • Dialogflow Phone Gateway 통합에서만 지원
  • 오디오 파일 사양: 8kHz에서 리니어 PCM 오디오(2바이트/샘플)의 단일 채널(모노)
  • 인텐트당 오디오 재생 응답 최대 20개

통화 전달 응답

통화 전달 응답은 전화 통합을 위한 발신자 전달에 사용됩니다.

제공되는 필드는 다음과 같습니다.

  • 전달할 전화 번호

다음과 같은 제한사항이 적용됩니다.

커스텀 페이로드 응답

일부 플랫폼은 커스텀 페이로드 응답을 지원하여 비표준 고급 응답을 처리합니다. 이러한 커스텀 페이로드는 플랫폼 문서에 정의된 JSON 형식으로 제공됩니다.

또한 개발 중인 통합에 커스텀 페이로드를 보낼 수도 있습니다. Dialogflow에서 처리되지 않으므로 자체 비즈니스 로직에서 처리해야 합니다.

여러 플랫폼용 커스텀 페이로드를 구성할 수 있습니다. 이를 구성하려면 기본 플랫폼 및 다음과 유사한 JSON 형식을 사용합니다.

{
  "facebook": {
    "attachment": {
      "type": "",
      "payload": {}
    }
  },
  "slack": {
    "text": "",
    "attachments": []
  }
}

Google 어시스턴트 응답 유형

Google 어시스턴트 통합에서는 다양한 응답 메시지 유형이 제공됩니다. 자세한 내용은 Google 어시스턴트 응답 참조를 확인하세요.

추가 응답 유형

다른 메시지 유형이 다양한 플랫폼에서 지원됩니다. 응답 메시지 REST 참조에서 전체 목록을 확인할 수 있습니다. 자세한 내용은 플랫폼 통합 문서를 참조하세요.