Hebt eine Agent-Nachricht auf, die zwar gesendet, aber noch nicht zugestellt wurde.
Wenn die RBM-Plattform eine Nachricht erfolgreich widerruft, wird sie 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 kann vorkommen, dass der Kundenservicemitarbeiter einen Widerruf einleitet, während die RBM-Plattform gerade die Nachricht sendet. In diesen seltenen Fällen erhält der Agent kurz nach dem Start der Widerrufsanfrage 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 |
„phones/{E.164}/agentMessages/{messageId}“, wobei {E.164} die Telefonnummer des Nutzers im E.164-Format und {messageId} die vom Kundenservicemitarbeiter zugewiesene ID der Nachricht ist, die widerrufen werden soll. Beispiel: Mit der US-Telefonnummer +1-222-333-4444 und einer Agent-Nachricht mit der ID „12345xyz“ würde der resultierende Endpunkt https://rcsbusinessmessaging.googleapis.com/v1/phones/+12223334444/agentMessages/12345xyz ergeben. |
Abfrageparameter
Parameter | |
---|---|
agentId |
Erforderlich. Die eindeutige Kennung des Agents. |
Anfragetext
Der Anfragetext muss leer sein.
Antworttext
Wenn der Vorgang erfolgreich ist, ist der Antworttext leer.
Autorisierungsbereiche
Erfordert den folgenden OAuth-Bereich:
https://www.googleapis.com/auth/rcsbusinessmessaging
Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.