Method: phones.agentMessages.delete

Hebt eine Agent-Nachricht auf, die gesendet, aber noch nicht zugestellt wurde.

Wenn die RCS for Business-Plattform eine Nachricht erfolgreich widerruft, wird die Nachricht aus der Nachrichtenwarteschlange des Nutzers gelöscht und nie zugestellt (200 OK).

Eine „404 Not Found“-Antwort bedeutet, dass der Versuch, die Nachricht zurückzurufen, fehlgeschlagen ist, weil die Nachricht zugestellt wurde.

Es besteht eine geringe Wahrscheinlichkeit, dass der Agent einen Widerruf einleitet, während die RCS for Business-Plattform die Nachricht gerade zustellt. In diesen seltenen Fällen erhält der Agent kurz nach dem Einleiten 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

string

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

Abfrageparameter

Parameter
agentId

string

Erforderlich. Die eindeutige ID 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.