Revoca un messaggio dell'agente che è stato inviato, ma non ancora consegnato.
Se la piattaforma RCS for Business revoca correttamente un messaggio, questo viene eliminato dalla coda di messaggi dell'utente e non viene mai recapitato (200 OK).
Una risposta 404 Not Found indica che il tentativo di revoca non è riuscito perché il messaggio è stato recapitato.
Esiste una piccola possibilità che l'agente avvii una revoca mentre la piattaforma RCS for Business è in fase di invio del messaggio. In questi rari casi, l'agente riceve un evento utente DELIVERED per il messaggio poco dopo aver avviato la richiesta di revoca.
Richiesta HTTP
DELETE https://rcsbusinessmessaging.googleapis.com/v1/{name=phones/*/agentMessages/*}
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
| Parametri | |
|---|---|
name |
"phones/{E.164}/agentMessages/{messageId}", dove {E.164} è il numero di telefono dell'utente nel formato E.164 e {messageId} è l'ID del messaggio dell'agente assegnato dall'agente che deve essere revocato. Ad esempio, con il numero di telefono statunitense +1-222-333-4444 e un messaggio dell'agente con l'ID "12345xyz", l'endpoint risultante sarebbe https://rcsbusinessmessaging.googleapis.com/v1/phones/+12223334444/agentMessages/12345xyz. |
Parametri di query
| Parametri | |
|---|---|
agentId |
Obbligatorio. L'identificatore univoco dell'agente. |
Corpo della richiesta
Il corpo della richiesta deve essere vuoto.
Corpo della risposta
In caso di esito positivo, il corpo della risposta è un oggetto JSON vuoto.
Ambiti di autorizzazione
Richiede il seguente ambito OAuth:
https://www.googleapis.com/auth/rcsbusinessmessaging
Per ulteriori informazioni, consulta OAuth 2.0 Overview.