에이전트에서 사용자에게 메시지를 전송합니다.
상담사가 메시지를 성공적으로 전송하려면 사용자가 RCS를 사용 설정하고 RBM 플랫폼에서 연결할 수 있어야 합니다. 메시지가 성공적으로 전송되면 호출이 오류 없이 반환됩니다. 그러지 않으면 상담사에게 오류 코드가 전송됩니다.
사용자가 온라인 상태인 경우 RBM 플랫폼에서 즉시 메시지를 전달합니다. 그렇지 않으면 RBM 플랫폼이 메시지를 대기열에 추가한 후 사용자가 다음 온라인 상태가 되면 메시지를 전달합니다.
RBM 플랫폼은 이전 메시지 또는 동일한 상담사가 보낸 이벤트에서 사용된 ID로 전송된 모든 상담사 메시지를 무시합니다.
상담사 메시지는 전송된 시점과 전송된 시점 사이에 취소될 수 있습니다.
HTTP 요청
POST https://rcsbusinessmessaging.googleapis.com/v1/{parent=phones/*}/agentMessages
URL은 gRPC 트랜스코딩 구문을 사용합니다.
경로 매개변수
매개변수 | |
---|---|
parent |
'phones/{E.164}'. 여기서 {E.164}는 E.164 형식의 사용자 전화번호입니다. 예를 들어 미국 전화번호가 +1-222-333-4444이면 값은 calls/+12223334444가 되고 결과로 나오는 엔드포인트는 https://rcsbusinessmessaging.googleapis.com/v1/phones/+12223334444/agentMessages입니다. |
쿼리 매개변수
매개변수 | |
---|---|
messageId |
상담사가 할당한 메시지의 고유 ID입니다. https://tools.ietf.org/html/rfc4122에 정의된 UUID여야 합니다. RBM 플랫폼은 이전 메시지 또는 동일한 상담사가 보낸 이벤트에서 사용된 ID로 전송된 모든 상담사 메시지를 무시합니다. |
agentId |
필수 항목입니다. 상담사의 고유 식별자입니다. |
요청 본문
요청 본문에는 AgentMessage
의 인스턴스가 포함됩니다.
응답 본문
성공한 경우 응답 본문에 새로 생성된 AgentMessage
의 인스턴스가 포함됩니다.
승인 범위
다음 OAuth 범위가 필요합니다.
https://www.googleapis.com/auth/rcsbusinessmessaging
자세한 내용은 OAuth 2.0 개요를 참고하세요.