REST Resource: phones.agentMessages

리소스: AgentMessage

에이전트에서 사용자에게 전송되는 메시지입니다.

JSON 표현
{
  "name": string,
  "sendTime": string,
  "contentMessage": {
    object (AgentContentMessage)
  },
  "messageTrafficType": enum (MessageTrafficType),
  "richMessageClassification": {
    object (RichMessageClassification)
  },
  "totalPayloadSizeBytes": string,
  "carrier": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "expireTime": string,
  "ttl": string
  // End of mutually exclusive fields.
}
필드
name

string

이 필드는 비즈니스용 RCS 플랫폼에서 설정합니다. 에이전트 메시지를 만들 때 포함하지 마세요. 이 필드는 'phones/{E.164}/agentMessages/{messageId}"를 확인합니다. 여기서 {E.164}는 E.164 형식의 사용자 전화번호이고 {messageId}는 상담사 메시지의 상담사 할당 ID입니다.

sendTime

string (Timestamp format)

이 필드는 비즈니스용 RCS 플랫폼에서 설정합니다. 에이전트 메시지를 만들 때 포함하지 마세요. 이 필드는 사용자에게 메시지가 전송되는 시간을 확인합니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.

contentMessage

object (AgentContentMessage)

에이전트 메시지의 콘텐츠입니다.

messageTrafficType

enum (MessageTrafficType)

메시지 트래픽 유형입니다.

richMessageClassification

object (RichMessageClassification)

출력 전용입니다. 미국 결제 모델에 따라 메시지를 분류합니다. 각 분류 유형에 대한 자세한 내용은 미국 결제 모델 가이드를 참고하세요. 이 필드는 미국 전화번호에만 채워집니다.

totalPayloadSizeBytes

string (int64 format)

출력 전용입니다. 메시지의 총 페이로드 크기(바이트)입니다. 페이로드는 비즈니스용 RCS 메시지의 모든 첨부파일(동영상, 이미지, PDF 등)을 계산하며, 메시지 텍스트나 추천은 제외됩니다. 현재 이 필드는 미국 전화번호에만 채워집니다.

carrier

string

출력 전용입니다. Google RCS 백엔드에 따른 사용자의 전화번호가 속한 이동통신사 정보입니다. 현재 이 필드는 미국 전화번호에만 채워집니다.

다음은 상호 배타적인 필드 목록입니다. 응답에서 최대 하나의 필드가 설정됩니다.
expireTime

string (Timestamp format)

선택사항입니다. 이 리소스가 만료된 것으로 간주되는 시간의 타임스탬프(UTC)입니다. 메시지 제출 후 최소 6초가 지나야 합니다. 제출 후 6초 미만의 미래 타임스탬프를 지정하면 플랫폼에서 자동으로 6초로 조정합니다. 메시지 제출 시간 또는 그 이전의 타임스탬프는 400 INVALID_ARGUMENT 오류를 반환합니다. 이 값은 요청에 expireTime 또는 ttl가 설정된 경우 출력에 반환되며 값에 대한 조정 사항을 반영합니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.

ttl

string (Duration format)

선택사항입니다. 입력 전용입니다. 메시지가 자동으로 취소되기 전까지 유지되는 기간입니다. 최솟값은 6초입니다. 6초 미만의 양수 기간을 지정하면 플랫폼에서 자동으로 6초로 조정하고 조정된 값을 응답의 expireTime 필드에 반영합니다. 양수가 아닌 기간 (0 이하)은 400 INVALID_ARGUMENT 오류를 반환합니다.

소수점 아래가 최대 9자리까지이고 's'로 끝나는 초 단위 기간입니다. 예를 들면 "3.5s"입니다.

상호 배타적 필드의 끝입니다.

AgentContentMessage

에이전트에서 사용자에게 전송되는 메시지의 콘텐츠입니다.

JSON 표현
{
  "suggestions": [
    {
      object (Suggestion)
    }
  ],

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "text": string,
  "fileName": string,
  "uploadedRbmFile": {
    object (UploadedRbmFile)
  },
  "richCard": {
    object (RichCard)
  },
  "contentInfo": {
    object (ContentInfo)
  }
  // End of mutually exclusive fields.
}
필드
suggestions[]

object (Suggestion)

연결된 에이전트 메시지 뒤에 추천 쿼리 칩 목록으로 표시되는 추천 답장 및 추천 작업 목록입니다. 최대 11개의 추천이 표시됩니다.

칩은 연결된 에이전트 메시지가 대화 내에서 가장 최근 메시지인 경우에만 표시됩니다(에이전트 및 사용자 메시지 모두 포함). 사용자는 추천 답장을 탭하여 상담사에게 문자 답장을 보내거나 추천 작업을 탭하여 기기에서 기본 작업을 시작할 수 있습니다.

추천 패턴에는 영구적 패턴과 일시적 패턴의 두 가지 유형이 있습니다. 자세한 내용은 추천을 참고하세요.

에이전트 메시지의 콘텐츠입니다. 다음은 상호 배타적인 필드 목록입니다. 응답에서 최대 하나의 필드가 설정됩니다.
text

string

UTF-8로 인코딩된 텍스트입니다. 최대 3,072자(영문 기준)까지 허용됩니다.

fileName
(deprecated)

string

파일의 고유한 이름입니다. 에이전트가 파일을 업로드하면 비즈니스용 RCS 플랫폼에서 파일 이름을 반환합니다. 아래의 uploadedRbmFile로 인해 지원 중단되었습니다.

uploadedRbmFile

object (UploadedRbmFile)

비즈니스용 RCS 서버에 업로드되고 이 서버에서 제공되는 파일 및 썸네일의 식별자가 포함됩니다.

richCard

object (RichCard)

독립형 리치 카드입니다.

contentInfo

object (ContentInfo)

파일의 URL 및 파일 썸네일의 URL을 포함한 파일에 관한 정보입니다.

비즈니스용 RCS 플랫폼은 캐시에서 콘텐츠를 제공하지만 에이전트는 비즈니스용 RCS 플랫폼이 새 버전의 콘텐츠를 가져오고 캐시를 새로고침하도록 강제할 수 있습니다.

상호 배타적 필드의 끝입니다.

UploadedRbmFile

파일 및 썸네일 정보가 포함된 메시지

JSON 표현
{
  "fileName": string,
  "thumbnailName": string
}
필드
fileName

string

파일이 업로드될 때 비즈니스용 RCS 플랫폼에서 반환하는 파일 이름입니다.

thumbnailName

string

썸네일이 업로드될 때 비즈니스용 RCS 플랫폼에서 반환하는 썸네일의 이름입니다.

RichCard

에이전트가 사용자에게 전송하는 독립형 리치 카드 또는 리치 카드 캐러셀입니다.

JSON 표현
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "carouselCard": {
    object (CarouselCard)
  },
  "standaloneCard": {
    object (StandaloneCard)
  }
  // End of mutually exclusive fields.
}
필드
독립형 카드 또는 카드 캐러셀 다음은 상호 배타적인 필드 목록입니다. 응답에서 최대 하나의 필드가 설정됩니다.
carouselCard

object (CarouselCard)

카드 캐러셀

standaloneCard

object (StandaloneCard)

독립형 카드입니다.

상호 배타적 필드의 끝입니다.

CarouselCard

카드 캐러셀

JSON 표현
{
  "cardWidth": enum (CarouselCard.CardWidth),
  "cardContents": [
    {
      object (CardContent)
    }
  ]
}
필드
cardWidth

enum (CarouselCard.CardWidth)

캐러셀에 있는 카드의 너비입니다.

cardContents[]

object (CardContent)

캐러셀에 있는 각 카드의 콘텐츠 목록입니다. 캐러셀에는 최소 2개, 최대 10개의 카드를 포함할 수 있습니다.

CarouselCard.CardWidth

캐러셀에 있는 카드의 너비입니다.

열거형
CARD_WIDTH_UNSPECIFIED 지정되지 않음
SMALL 120DP입니다.
MEDIUM 232DP

CardContent

카드 콘텐츠

JSON 표현
{
  "title": string,
  "description": string,
  "media": {
    object (Media)
  },
  "suggestions": [
    {
      object (Suggestion)
    }
  ]
}
필드
title

string

(선택사항) 카드 제목입니다. 최대 200자(영문 기준)

description

string

(선택사항) 카드에 대한 설명입니다. 최대 2,000자(영문 기준)까지 허용됩니다.

media

object (Media)

(선택사항) 카드에 포함할 미디어(이미지, GIF, 동영상, PDF)입니다.

suggestions[]

object (Suggestion)

(선택사항) 카드에 포함할 추천 목록입니다. 최대 4개의 추천이 표시됩니다.

미디어

리치 카드 내의 미디어 파일입니다.

JSON 표현
{
  "height": enum (Media.Height),
  "contentDescription": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "fileName": string,
  "uploadedRbmFile": {
    object (UploadedRbmFile)
  },
  "contentInfo": {
    object (ContentInfo)
  }
  // End of mutually exclusive fields.
}
필드
height

enum (Media.Height)

세로 레이아웃이 있는 리치 카드 내 미디어의 높이입니다. 가로 레이아웃의 독립형 카드의 경우 iOS 호환성을 위해 HEIGHT_UNSPECIFIED 대신 TALL를 사용합니다.

contentDescription

string

선택사항입니다. 접근성을 위해 미디어 콘텐츠를 설명하고 대체 텍스트를 제공합니다. 최대 200자(영문 기준)의 일반 텍스트를 지원합니다.

미디어 콘텐츠 다음은 상호 배타적인 필드 목록입니다. 응답에서 최대 하나의 필드가 설정됩니다.
fileName
(deprecated)

string

파일이 업로드될 때 비즈니스용 RCS 플랫폼에서 반환하는 파일의 고유 이름입니다. 아래의 uploadedRbmFile로 인해 지원 중단되었습니다.

uploadedRbmFile

object (UploadedRbmFile)

비즈니스용 RCS 서버에 업로드되고 이 서버에서 제공되는 파일 및 썸네일의 식별자가 포함됩니다.

contentInfo

object (ContentInfo)

파일의 URL 및 파일 썸네일의 URL을 포함한 파일에 관한 정보입니다.

비즈니스용 RCS 플랫폼은 캐시에서 콘텐츠를 제공하지만 에이전트는 비즈니스용 RCS 플랫폼이 새 버전의 콘텐츠를 가져오고 캐시를 새로고침하도록 강제할 수 있습니다.

상호 배타적 필드의 끝입니다.

ContentInfo

콘텐츠 정보가 포함된 메시지입니다.

JSON 표현
{
  "fileUrl": string,
  "thumbnailUrl": string,
  "forceRefresh": boolean
}
필드
fileUrl

string

공개적으로 연결 가능한 파일의 URL입니다. 비즈니스용 RCS 플랫폼은 파일을 가져올 때 HTTP 헤더의 content-type 필드에서 파일의 MIME 유형을 확인합니다. URL의 HTTP 응답에 content-type 필드가 있어야 하며 정확해야 합니다. 권장 최대 파일 크기는 100MB입니다.

참고: 파일 URL의 리디렉션은 지원되지 않습니다. 리디렉션이 필요한 경우 CreateFileRequest를 사용하세요.

thumbnailUrl

string

(선택사항, 이미지, 오디오, 동영상 파일만 해당) 공개적으로 연결 가능한 썸네일 URL입니다. 최대 크기는 100kB입니다.

썸네일 URL을 제공하지 않으면 사용자의 기기에서 파일을 다운로드할 때까지 비즈니스용 RCS 플랫폼에 빈 자리표시자 썸네일이 표시됩니다. 사용자의 설정에 따라 파일이 자동으로 다운로드되지 않을 수 있으며 사용자가 다운로드 버튼을 탭해야 할 수도 있습니다.

참고: 파일 URL의 리디렉션은 지원되지 않습니다. 리디렉션이 필요한 경우 CreateFileRequest를 사용하세요.

forceRefresh

boolean

설정하면 비즈니스용 RCS 플랫폼이 파일(또는 썸네일)의 캐시된 사본을 가지고 있더라도 지정된 URL에서 파일과 썸네일을 가져옵니다.

Media.Height

미디어 높이

열거형
HEIGHT_UNSPECIFIED 지정되지 않음
SHORT 112DP
MEDIUM 168DP
TALL 264DP입니다.

추천

리치 카드 또는 추천 쿼리 칩 목록에 포함된 추천 답장 또는 추천 작업입니다.

JSON 표현
{
  "suggestionDisplay": enum (Suggestion.SuggestionDisplay),

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "reply": {
    object (SuggestedReply)
  },
  "action": {
    object (SuggestedAction)
  }
  // End of mutually exclusive fields.
}
필드
suggestionDisplay

enum (Suggestion.SuggestionDisplay)

선택사항입니다. 추천의 표시 동작을 제어합니다. Google 메시지 클라이언트(버전 20260225.00 이상)로 전송된 일반 텍스트 메시지에만 적용됩니다. 이 필드는 일반 텍스트 메시지와 연결된 독립형 추천에만 설정해야 합니다. 이 필드가 리치 카드의 추천 또는 파일 전송이 포함된 독립형 추천에 적용되면 서버에서 메시지를 거부합니다. 이 설정은 Google 메시지에만 직렬화되며 다른 클라이언트(예: iOS 또는 삼성)에서는 무시됩니다.

추천 답장 또는 추천 작업 다음은 상호 배타적인 필드 목록입니다. 응답에서 최대 하나의 필드가 설정됩니다.
reply

object (SuggestedReply)

사용자는 추천 답장을 탭하여 상담사에게 텍스트 답장을 보낼 수 있습니다.

action

object (SuggestedAction)

사용자는 추천 작업을 탭하여 기기에서 해당하는 네이티브 작업을 시작할 수 있습니다.

상호 배타적 필드의 끝입니다.

SuggestedReply

탭하면 텍스트 답장을 상담사에게 다시 보냅니다.

JSON 표현
{
  "text": string,
  "postbackData": string
}
필드
text

string

추천 답장에 표시되고 사용자가 탭하면 상담사에게 다시 전송되는 텍스트입니다. 최대 글자 수는 25자입니다(영문 기준).

postbackData

string

사용자가 추천 답장을 탭할 때 에이전트가 사용자 이벤트에서 수신하는 base64로 인코딩된 페이로드입니다.

SuggestedAction

탭하면 기기에서 상응하는 네이티브 작업을 시작합니다.

JSON 표현
{
  "text": string,
  "postbackData": string,
  "fallbackUrl": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "dialAction": {
    object (DialAction)
  },
  "viewLocationAction": {
    object (ViewLocationAction)
  },
  "createCalendarEventAction": {
    object (CreateCalendarEventAction)
  },
  "openUrlAction": {
    object (OpenUrlAction)
  },
  "shareLocationAction": {
    object (ShareLocationAction)
  }
  // End of mutually exclusive fields.
}
필드
text

string

추천 작업에 표시되는 텍스트입니다. 최대 글자 수는 25자입니다(영문 기준).

postbackData

string

사용자가 추천 작업을 탭할 때 발생하는 사용자 이벤트에서 에이전트로 전송되는 페이로드(base64로 인코딩됨)입니다. 최대 2,048자(영문 기준)까지 허용됩니다.

fallbackUrl

string

(선택사항) 클라이언트가 추천 작업을 지원하지 않는 경우 사용할 대체 URL입니다. 대체 URL은 새 브라우저 창에서 열립니다. RFC 3986에 정의된 유효한 URI여야 합니다. 최대 2,048자(영문 기준)까지 허용됩니다.

사용자가 추천 작업을 탭할 때 기기에서 시작되는 네이티브 작업입니다. 다음은 상호 배타적인 필드 목록입니다. 응답에서 최대 하나의 필드가 설정됩니다.
dialAction

object (DialAction)

에이전트가 지정한 전화번호가 입력된 상태로 사용자의 기본 다이얼러 앱을 엽니다.

viewLocationAction

object (ViewLocationAction)

사용자의 기본 지도 앱을 열고 에이전트가 지정한 위치를 선택하거나 에이전트가 지정한 검색어를 기반으로 사용자 위치 주변을 검색합니다.

createCalendarEventAction

object (CreateCalendarEventAction)

사용자의 기본 캘린더 앱을 열고 에이전트가 지정한 이벤트 데이터가 자동 입력된 상태로 새 캘린더 일정 흐름을 시작합니다.

openUrlAction

object (OpenUrlAction)

사용자의 기본 웹브라우저 앱을 지정된 URL로 엽니다. 사용자가 URL의 기본 핸들러로 등록된 앱을 설치한 경우 이 앱이 대신 열리고 추천 작업 UI에 앱 아이콘이 사용됩니다.

shareLocationAction

object (ShareLocationAction)

사용자가 에이전트에 전송할 위치를 선택할 수 있도록 RCS 앱의 위치 선택 도구를 엽니다.

상호 배타적 필드의 끝입니다.

DialAction

에이전트가 지정한 전화번호가 입력된 상태로 사용자의 기본 다이얼러 앱을 엽니다.

JSON 표현
{
  "phoneNumber": string
}
필드
phoneNumber

string

E.164 형식의 전화번호(예: +12223334444)입니다.

ViewLocationAction

사용자의 기본 지도 앱을 열고 에이전트가 지정한 위치를 선택하거나 에이전트가 지정한 검색어를 기반으로 사용자 위치 주변을 검색합니다.

JSON 표현
{
  "latLong": {
    object (LatLng)
  },
  "label": string,
  "query": string
}
필드
latLong

object (LatLng)

(선택사항) 지정된 위치의 위도 및 경도입니다.

label

string

(선택사항) latLong에 드롭된 핀의 라벨입니다.

query

string

(선택사항) latLong(및 선택사항인 라벨)을 지정하는 대신 상담사가 쿼리 문자열을 지정할 수 있습니다. 검색 기능을 지원하는 기본 지도 앱(Google 지도 포함)의 경우 이 추천 작업을 탭하면 사용자의 현재 위치를 중심으로 위치 검색이 실행됩니다. 쿼리가 충분히 구체적이면 상담사는 이를 사용하여 전 세계의 모든 위치를 선택할 수 있습니다.

예를 들어 쿼리 문자열을 'Growing Tree Bank'로 설정하면 사용자 주변의 모든 Growing Tree Bank 위치가 표시됩니다. 쿼리 문자열을 '1600 Amphitheater Parkway, Mountain View, CA 94043'으로 설정하면 사용자의 위치와 관계없이 해당 주소가 선택됩니다.

LatLng

위도/경도 쌍을 나타내는 객체로 위도(도)와 경도(도)를 나타내는 double의 쌍으로 표현됩니다. 달리 명시되지 않는 한 이 객체는 WGS84 표준을 준수해야 합니다. 값은 정규화된 범위 내에 있어야 합니다.

JSON 표현
{
  "latitude": number,
  "longitude": number
}
필드
latitude

number

위도입니다. 범위는 [-90.0, +90.0]입니다.

longitude

number

경도입니다. 범위는 [-180.0, +180.0]입니다.

CreateCalendarEventAction

사용자의 기본 캘린더 앱을 열고 에이전트가 지정한 이벤트 데이터가 자동 입력된 상태로 새 캘린더 일정 흐름을 시작합니다.

JSON 표현
{
  "startTime": string,
  "endTime": string,
  "title": string,
  "description": string
}
필드
startTime

string (Timestamp format)

일정 시작 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.

endTime

string (Timestamp format)

이벤트 종료 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.

title

string

일정 제목 최대 100자(영문 기준)까지 허용됩니다.

description

string

이벤트 설명입니다. 최대 500자까지 입력할 수 있습니다.

OpenUrlAction

사용자의 기본 웹브라우저 앱을 지정된 URL로 엽니다. 사용자가 URL의 기본 핸들러로 등록된 앱을 설치한 경우 이 앱이 대신 열리고 추천 작업 UI에 앱 아이콘이 사용됩니다.

JSON 표현
{
  "url": string,
  "application": enum (OpenUrlApplication),
  "webviewViewMode": enum (WebviewViewMode),
  "description": string
}
필드
url

string

열려는 URL입니다. 2025년 11월 1일부터 URL 스키마는 https:// 또는 http://여야 합니다. 이 날짜 이후에는 다른 스키마(예: tel:, mailto:, sms:)를 사용하는 API 요청이 400 잘못된 요청 오류와 함께 거부됩니다. URL은 RFC 3986에 정의된 유효한 URI여야 합니다. 최대 2,048자(영문 기준)까지 허용됩니다.

application

enum (OpenUrlApplication)

URL 열기 애플리케이션, 브라우저 또는 WebView 사용자의 기기가 WebView 모드를 지원하는지 확인하려면 먼저 기능 확인을 실행하세요. 자세한 내용은 https://developers.google.com/business-communications/rcs-business-messaging/guides/build/capabilities 문서를 참고하세요.

webviewViewMode

enum (WebviewViewMode)

WebView의 보기 모드입니다.

description

string

WebView의 접근성 설명입니다.

OpenUrlApplication

URL 열기 애플리케이션의 유형입니다.

열거형
OPEN_URL_APPLICATION_UNSPECIFIED 지정되지 않음, 브라우저를 사용하여 열림
BROWSER 브라우저를 사용하여 URL을 엽니다.
WEBVIEW 통합 웹뷰 창에서 URL 열기

WebviewViewMode

WebView의 뷰 모드 유형입니다.

열거형
WEBVIEW_VIEW_MODE_UNSPECIFIED 지정되지 않음 웹뷰를 사용하려면 보기 모드를 지정해야 합니다.
FULL 상태 표시줄에 챗봇 대화 라벨이 지정된 전체 화면 오버레이가 필요합니다.
HALF 화면 절반 오버레이가 필요합니다.
TALL 3/4 화면 오버레이가 필요합니다.

ShareLocationAction

이 유형에는 필드가 없습니다.

사용자가 상담사에게 보낼 위치를 선택할 수 있도록 RCS 앱의 위치 선택 도구를 엽니다.

Suggestion.SuggestionDisplay

독립형 텍스트 추천의 표시 동작입니다.

열거형
SUGGESTION_DISPLAY_UNSPECIFIED

클라이언트는 기본 표시 동작을 실행합니다.

  • 일반 텍스트 메시지 전용 Google 메시지: 새 메시지를 보내거나 받으면 추천이 사라집니다.
  • 독립형 일반 텍스트 메시지용 iOS: 사용자가 탭한 후에만 추천이 사라집니다.
  • 리치 카드의 모든 클라이언트: 추천은 항상 유지됩니다. 리치 카드에서 suggestionDisplay를 설정하면 400 오류가 발생합니다.
PERSISTENT 대화에 새 메시지가 추가되더라도 추천은 메시지 풍선 내에 계속 표시됩니다.

StandaloneCard

독립형 카드

JSON 표현
{
  "cardOrientation": enum (StandaloneCard.CardOrientation),
  "thumbnailImageAlignment": enum (StandaloneCard.ThumbnailImageAlignment),
  "cardContent": {
    object (CardContent)
  }
}
필드
cardOrientation

enum (StandaloneCard.CardOrientation)

카드의 방향입니다.

thumbnailImageAlignment

enum (StandaloneCard.ThumbnailImageAlignment)

가로 레이아웃이 있는 독립형 카드의 이미지 미리보기 정렬입니다.

cardContent

object (CardContent)

카드 콘텐츠입니다.

StandaloneCard.CardOrientation

카드의 방향입니다.

열거형
CARD_ORIENTATION_UNSPECIFIED 지정되지 않음
HORIZONTAL

가로 레이아웃

가로 리치 카드의 object(CardContent)에 media 필드가 포함된 경우 title, description 또는 suggestions[] 필드도 하나 이상 포함되어야 합니다.

VERTICAL 세로 레이아웃

StandaloneCard.ThumbnailImageAlignment

가로 레이아웃이 있는 독립형 카드의 이미지 미리보기 정렬입니다.

열거형
THUMBNAIL_IMAGE_ALIGNMENT_UNSPECIFIED 지정되지 않음
LEFT 파일 미리보기가 왼쪽 정렬됩니다.
RIGHT 파일 미리보기가 오른쪽 정렬됩니다.

MessageTrafficType

지원되는 메시지 트래픽 유형입니다. enum은 추가 트래픽 유형을 지원하도록 확장됩니다. 에이전트 사용 사례는 사용할 트래픽 유형에 대한 안내를 제공할 수 있지만 관계에 대한 API 적용은 없습니다.

열거형
MESSAGE_TRAFFIC_TYPE_UNSPECIFIED 기본 동작: 메시지 트래픽 유형은 에이전트의 사용 사례에 따라 결정됩니다. 메시지 내용에 따라 필요에 따라 트래픽 유형을 업데이트합니다. 다용도 에이전트의 경우 기본값이 제공되지 않습니다. 트래픽 유형은 수동으로 설정해야 합니다(예: TRANSACTION, PROMOTION).
AUTHENTICATION 인증 메시지(OTP 에이전트 사용 사례에 권장됨)
TRANSACTION 거래 메시지(거래 또는 다목적 에이전트 사용 사례에 권장됨)
PROMOTION 프로모션 메시지(프로모션 또는 다목적 에이전트 사용 사례에 권장)
SERVICEREQUEST 사용자가 수신에 동의한 서비스에 관한 메시지(OTP, 거래, 프로모션 또는 다용도 에이전트 사용 사례에 권장됨)
ACKNOWLEDGEMENT 사용자의 수신 거부 요청을 확인하는 메시지입니다(OTP, 거래, 프로모션 또는 다용도 에이전트 사용 사례에 권장됨).

RichMessageClassification

미국 결제 전용: 결제에 사용되는 메시지 분류에 관한 세부정보입니다.

JSON 표현
{
  "classificationType": enum (RichMessageClassificationType),
  "segmentCount": integer
}
필드
classificationType

enum (RichMessageClassificationType)

segmentCount

integer

메시지 텍스트의 160바이트 세그먼트 수로, 항상 올림됩니다.

텍스트 콘텐츠의 총 UTF-8 바이트 길이로만 계산되며 추천 답장 또는 작업의 데이터는 제외됩니다.

예를 들어 길이가 300바이트인 문자 메시지의 segmentCount는 2입니다.

이 필드는 RICH_MESSAGE 유형에만 채워집니다.

RichMessageClassificationType

미국 결제 전용: 결제에 대한 메시지 분류를 지정합니다.

중요: 미국 이동통신사는 이 페이지에 설명된 청구 가능한 메시지 유형의 가격을 설정합니다. 미국 이동통신사는 비즈니스용 RCS 메시지 전송에 대한 개발자의 최종 요금도 결정합니다. 추가 가격 책정 또는 결제 정보는 해당 이동통신사 담당자에게 문의하세요.

열거형
RICH_MESSAGE_CLASSIFICATION_TYPE_UNSPECIFIED 지정되지 않음
RICH_MESSAGE 다음 조건에서 메시지가 RICH로 분류됩니다. 1. 리치 카드가 포함되어 있지 않습니다. 2. 첨부파일이 포함되어 있지 않습니다. 3. 포함된 추천 작업은 다이얼 작업 또는 WebView를 사용하지 않는 URL 열기 작업이어야 합니다.
RICH_MEDIA_MESSAGE RICH_MESSAGE 기준을 충족하지 않는 모든 메시지입니다. 여기에는 리치 카드, 미디어 파일 또는 전화 걸기나 브라우저에서 URL 열기 이외의 추천 작업이 포함된 메시지가 포함됩니다.
SUGGESTED_ACTION_CLICK 사용자가 추천 답장이 아닌 추천 작업을 탭하는 것을 나타냅니다. 이 분류는 사용자 작업에만 적용되며 웹훅의 UserMessage 페이로드에만 표시됩니다. A2P 메시지에는 적용되지 않습니다.

메서드

create

에이전트에서 사용자에게 메시지를 보냅니다.

delete

전송되었지만 아직 전달되지 않은 상담사 메시지를 취소합니다.