Отменяет сообщение агента, которое было отправлено, но еще не доставлено.
Если платформа RCS for Business успешно отзывает сообщение, то оно удаляется из очереди сообщений пользователя и никогда не доставляется (200 OK).
Ответ 404 Not Found означает, что попытка отзыва не удалась, поскольку сообщение было доставлено.
Существует небольшая вероятность того, что агент инициирует отзыв, пока платформа RCS for Business находится в процессе доставки сообщения. В таких редких случаях агент получает пользовательское событие DELIVERED для сообщения вскоре после инициирования запроса на отзыв.
HTTP-запрос
DELETE https://rcsbusinessmessaging.googleapis.com/v1/{name=phones/*/agentMessages/*}
URL использует синтаксис перекодировки gRPC .
Параметры пути
| Параметры | |
|---|---|
name | "phones/{E.164}/agentMessages/{messageId}", где {E.164} — номер телефона пользователя в формате E.164, а {messageId} — назначенный агентом идентификатор сообщения агента, которое следует отозвать. Например, для номера телефона в США +1-222-333-4444 и сообщения агента с идентификатором "12345xyz" результирующая конечная точка будет выглядеть следующим образом: https://rcsbusinessmessaging.googleapis.com/v1/phones/+12223334444/agentMessages/12345xyz . |
Параметры запроса
| Параметры | |
|---|---|
agentId | Обязательно. Уникальный идентификатор агента. |
Текст запроса
Тело запроса должно быть пустым.
Тело ответа
В случае успеха тело ответа представляет собой пустой объект JSON.
Области авторизации
Требуется следующая область OAuth:
-
https://www.googleapis.com/auth/rcsbusinessmessaging
Для получения более подробной информации см.OAuth 2.0 Overview .