new_releases 업데이트:
출시 노트에서 새로운 기능 및 제품 업데이트를 확인하세요.
UserMessage
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
사용자가 상담사에게 보낸 메시지입니다.
UserMessage는 에이전트가 Google Pub/Sub 구독에서 수신하는 'message' 객체의 'data' 필드에 표시됩니다. 'data' 필드는 상담사가 UserMessage 구조와 일치하도록 디코딩해야 하는 base64로 인코딩된 문자열입니다.
| JSON 표현 |
{
"senderPhoneNumber": string,
"messageId": string,
"sendTime": string,
"agentId": string,
// Union field content can be only one of the following:
"text": string,
"userFile": {
object (UserFile)
},
"location": {
object (LatLng)
},
"suggestionResponse": {
object (SuggestionResponse)
}
// End of list of possible types for union field content.
} |
| 필드 |
senderPhoneNumber |
string
메시지를 보낸 사용자의 전화번호 (E.164 형식)입니다.
|
messageId |
string
전송 사용자의 RCS 클라이언트에서 할당한 고유 메시지 ID입니다.
|
sendTime |
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"입니다.
|
agentId |
string
상담사의 고유 식별자입니다. RCS 비즈니스 메시지에서 설정합니다.
|
통합 필드 content. 메시지 content의 콘텐츠는 다음 중 하나여야 합니다. |
text |
string
텍스트입니다. 구체적으로는 유기적인 사용자 입력으로 생성된 문자열이며 추천 답장이 아닙니다.
|
userFile |
object (UserFile)
미디어 파일입니다.
|
location |
object (LatLng)
위치를 탭합니다. 이는 반드시 사용자의 위치가 아닐 수 있습니다. 사용자가 상담사에게 임의의 위치를 보낼 수 있습니다.
|
suggestionResponse |
object (SuggestionResponse)
사용자가 제안된 답장이나 작업을 탭하여 생성된 응답입니다.
|
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-22(UTC)
[null,null,["최종 업데이트: 2025-08-22(UTC)"],[[["\u003cp\u003eUserMessage data is received by the agent in a base64-encoded string within the "data" field of the "message" object, which must be decoded.\u003c/p\u003e\n"],["\u003cp\u003eThe UserMessage includes fields such as \u003ccode\u003esenderPhoneNumber\u003c/code\u003e, \u003ccode\u003emessageId\u003c/code\u003e, \u003ccode\u003esendTime\u003c/code\u003e, and \u003ccode\u003eagentId\u003c/code\u003e, providing details about the sender and message metadata.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003econtent\u003c/code\u003e field of a UserMessage can represent various types of user input, including \u003ccode\u003etext\u003c/code\u003e, \u003ccode\u003euserFile\u003c/code\u003e, \u003ccode\u003elocation\u003c/code\u003e, or \u003ccode\u003esuggestionResponse\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003esendTime\u003c/code\u003e follows RFC 3339 format, which supports fractional digits and time offsets, ensuring precise time information.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003esenderPhoneNumber\u003c/code\u003e is the user's number in E.164 format, and \u003ccode\u003emessageId\u003c/code\u003e is a unique identifier assigned to the message by the user's RCS client.\u003c/p\u003e\n"]]],[],null,["# UserMessage\n\nA message that a user sent to the agent.\n\nThe UserMessage appears in the \"data\" field of the \"message\" object that the agent receives from its Google Pub/Sub subscription. The \"data\" field is a base64-encoded string that the agent must decode to match the UserMessage structure.\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"senderPhoneNumber\": string, \"messageId\": string, \"sendTime\": string, \"agentId\": string, // Union field `content` can be only one of the following: \"text\": string, \"userFile\": { object (/business-communications/rcs-business-messaging/reference/rest/v1/UserFile) }, \"location\": { object (/business-communications/rcs-business-messaging/reference/rest/v1/phones.agentMessages#LatLng) }, \"suggestionResponse\": { object (/business-communications/rcs-business-messaging/reference/rest/v1/SuggestionResponse) } // End of list of possible types for union field `content`. } ``` |\n\n| Fields ||\n|----------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `senderPhoneNumber` | `string` Phone number (in E.164 format) of the user that sent the message. |\n| `messageId` | `string` A unique message ID, assigned by the sending user's RCS client. |\n| `sendTime` | `string (`[Timestamp](https://protobuf.dev/reference/protobuf/google.protobuf/#timestamp)` format)` Time at which the message was sent. Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than \"Z\" are also accepted. Examples: `\"2014-10-02T15:01:23Z\"`, `\"2014-10-02T15:01:23.045123456Z\"` or `\"2014-10-02T15:01:23+05:30\"`. |\n| `agentId` | `string` The agent's unique identifier. Set by RCS Business Messaging. |\n| Union field `content`. Content of the message `content` can be only one of the following: ||\n| `text` | `string` Text, specifically a string created through organic user typing and not a suggested reply. |\n| `userFile` | `object (`[UserFile](/business-communications/rcs-business-messaging/reference/rest/v1/UserFile)`)` Media file. |\n| `location` | `object (`[LatLng](/business-communications/rcs-business-messaging/reference/rest/v1/phones.agentMessages#LatLng)`)` Location. Note that this is not necessarily the user's location. A user is able to send arbitrary locations to an agent. |\n| `suggestionResponse` | `object (`[SuggestionResponse](/business-communications/rcs-business-messaging/reference/rest/v1/SuggestionResponse)`)` Response generated by a user tapping a suggested reply or action. |"]]
