Revoga uma mensagem do agente que foi enviada, mas ainda não foi entregue.
Se a plataforma RBM revogar uma mensagem, ela será excluída da fila de mensagens do usuário e nunca será entregue.
Esse método retorna imediatamente 200 OK, se a mensagem foi revogada ou não.
Há uma pequena chance de que o agente inicie uma revogação enquanto a plataforma RBM 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 a solicitação for concluída, o corpo da resposta estará vazio.
Escopos de autorização
Requer o seguinte escopo OAuth:
https://www.googleapis.com/auth/rcsbusinessmessaging
Para mais informações, consulte a Visão geral do OAuth 2.0.