Revoga uma mensagem do agente que foi enviada, mas ainda não foi entregue.
Se a plataforma RCS para empresas revogar uma mensagem, ela será excluída da fila de mensagens do usuário e nunca será entregue (200 OK).
Uma resposta "404 Not Found" significa que a tentativa de revogação falhou porque a mensagem foi entregue.
Há uma pequena chance de o agente iniciar uma revogação enquanto a plataforma RCS for Business estiver entregando a mensagem. Nesses casos raros, o agente recebe um evento de usuário DELIVERED para a mensagem logo após iniciar a solicitação de revogação.
Solicitação HTTP
DELETE https://rcsbusinessmessaging.googleapis.com/v1/{name=phones/*/agentMessages/*}
O URL usa a sintaxe de transcodificação gRPC.
Parâmetros de caminho
| Parâmetros | |
|---|---|
name |
"phones/{E.164}/agentMessages/{messageId}", em que {E.164} é o número de telefone do usuário no formato E.164 e {messageId} é o ID atribuído pelo agente da mensagem que precisa ser revogada. Por exemplo, com o número de telefone dos EUA +1-222-333-4444 e uma mensagem do agente com o ID "12345xyz", o endpoint resultante seria https://rcsbusinessmessaging.googleapis.com/v1/phones/+12223334444/agentMessages/12345xyz. |
Parâmetros de consulta
| Parâmetros | |
|---|---|
agentId |
Obrigatório. O identificador exclusivo do agente. |
Corpo da solicitação
O corpo da solicitação precisa estar vazio.
Corpo da resposta
Se não houver nenhum problema, o corpo da resposta será um objeto JSON vazio.
Escopos de autorização
Requer o seguinte escopo OAuth:
https://www.googleapis.com/auth/rcsbusinessmessaging
Para mais informações, consulte OAuth 2.0 Overview.