Method: phones.agentMessages.delete

撤消已发送但尚未送达的代理消息。

如果 RCS 商务平台成功撤消了某条消息，则该消息会从用户的消息队列中删除，并且永远不会递送 (200 OK)。

“404 Not Found”响应表示撤消尝试失败，因为相应消息已递送。

在 RCS Business Messaging 平台传送消息的过程中，代理可能会启动撤消操作。在这些极少数情况下，代理会在发起撤消请求后不久收到相应消息的 DELIVERED 用户事件。

HTTP 请求

DELETE https://rcsbusinessmessaging.googleapis.com/v1/{name=phones/*/agentMessages/*}

网址采用 gRPC 转码语法。

路径参数

参数
name

string

“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

string

必需。代理的唯一标识符。

请求正文

请求正文必须为空。

响应正文

如果成功，则响应正文为空的 JSON 对象。

授权范围

需要以下 OAuth 范围：

  • https://www.googleapis.com/auth/rcsbusinessmessaging

如需了解详情，请参阅 OAuth 2.0 Overview。