Method: phones.agentMessages.delete

Hebt eine Nachricht an Kundenservicemitarbeiter auf, die gesendet, aber noch nicht zugestellt wurde.

Wenn die RBM-Plattform eine Nachricht erfolgreich widerruft, wird die Nachricht aus der Nachrichtenwarteschlange des Nutzers gelöscht und nie zugestellt.

Diese Methode gibt sofort 200 OK zurück, unabhängig davon, ob die Nachricht erfolgreich widerrufen wurde oder nicht.

Es ist unwahrscheinlich, dass der Kundenservicemitarbeiter einen Widerruf einleitet, während die RBM-Plattform die Nachricht sendet. In diesen seltenen Fällen erhält der Kundenservicemitarbeiter kurz nach der Initiierung der Widerrufsanforderung ein DELIVERED-Nutzerereignis für die Nachricht.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
name

string

„phones/{E.164}/agentMessages/{messageId}“, wobei {E.164} die Telefonnummer des Nutzers im E.164-Format und {messageId} die vom Agent zugewiesene ID der Agent-Nachricht ist, die widerrufen werden soll. Beispiel: Mit der US-Telefonnummer +1-222-333-4444 und einer Agent-Nachricht mit der ID „12345xyz“ wäre der resultierende Endpunkt https://rcsbusinessmessaging.googleapis.com/v1/phones/+12223334444/agentMessages/12345xyz.

Abfrageparameter

Parameter
agentId

string

Erforderlich. Die eindeutige Kennung des Agents.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, ist der Antworttext ein leeres JSON-Objekt.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie unter OAuth 2.0 Overview.