전송되었지만 아직 전달되지 않은 상담사 메시지를 취소합니다.
비즈니스용 RCS 플랫폼에서 메시지를 성공적으로 취소하면 메시지가 사용자의 메시지 대기열에서 삭제되고 전달되지 않습니다 (200 OK).
404 Not Found 응답은 메시지가 전송되어 취소 시도가 실패했음을 의미합니다.
비즈니스용 RCS 플랫폼에서 메시지를 전송하는 동안 에이전트가 취소를 시작할 가능성은 낮습니다. 이러한 드문 경우 에이전트는 취소 요청을 시작한 직후 메시지에 대한 DELIVERED 사용자 이벤트를 수신합니다.
HTTP 요청
DELETE https://rcsbusinessmessaging.googleapis.com/v1/{name=phones/*/agentMessages/*}
URL은 gRPC 트랜스코딩 구문을 사용합니다.
경로 매개변수
| 매개변수 | |
|---|---|
name |
'phones/{E.164}/agentMessages/{messageId}'입니다. 여기서 {E.164}는 E.164 형식의 사용자 전화번호이고 {messageId}는 취소해야 하는 상담사 메시지의 상담사 할당 ID입니다. 예를 들어 미국 전화번호 +1-222-333-4444와 ID가 '12345xyz'인 상담사 메시지가 있는 경우 결과 엔드포인트는 https://rcsbusinessmessaging.googleapis.com/v1/phones/+12223334444/agentMessages/12345xyz가 됩니다. |
쿼리 매개변수
| 매개변수 | |
|---|---|
agentId |
필수 항목입니다. 에이전트의 고유 식별자입니다. |
요청 본문
요청 본문은 비어 있어야 합니다.
응답 본문
성공하면 응답 본문은 빈 JSON 객체입니다.
승인 범위
다음 OAuth 범위가 필요합니다.
https://www.googleapis.com/auth/rcsbusinessmessaging
자세한 내용은 OAuth 2.0 Overview를 참조하세요.