Envoie un événement de l'agent à un utilisateur.
Les événements d'agent peuvent être utilisés pour indiquer que l'agent a lu un message de l'utilisateur ou qu'il est en train de taper (ce qui ajoute un élément humain à l'expérience RBM). Si RBM ne parvient pas à atteindre l'utilisateur, la plate-forme RBM renvoie 404 NOT_FOUND.
Contrairement aux messages d'agent, les événements d'agent ne peuvent pas être révoqués après leur envoi.
Requête HTTP
POST https://rcsbusinessmessaging.googleapis.com/v1/{parent=phones/*}/agentEvents
L'URL utilise la syntaxe de transcodage gRPC.
Paramètres de chemin d'accès
| Paramètres | |
|---|---|
parent |
"phones/{E.164}", où {E.164} correspond au numéro de téléphone de l'utilisateur au format E.164. Par exemple, pour un utilisateur dont le numéro de téléphone aux États-Unis est +1-222-333-4444, la valeur serait phones/+12223334444. Le point de terminaison obtenu serait https://rcsbusinessmessaging.googleapis.com/v1/phones/+12223334444/agentEvents. |
Paramètres de requête
| Paramètres | |
|---|---|
eventId |
ID de l'événement, attribué par l'agent. Il doit s'agir d'un UUID, tel que défini dans le document https://tools.ietf.org/html/rfc4122. La plate-forme RBM ignore tous les messages d'agent envoyés avec un ID qui a été utilisé par un message ou événement antérieur envoyé par le même agent. |
agentId |
Obligatoire. Identifiant unique de l'agent. |
Corps de la requête
Le corps de la requête contient une instance AgentEvent.
Corps de la réponse
Si la requête aboutit, le corps de la réponse contient une nouvelle instance de AgentEvent.
Champs d'application des autorisations
Requiert le niveau d'accès OAuth suivant :
https://www.googleapis.com/auth/rcsbusinessmessaging
Pour en savoir plus, consultez la présentation d'OAuth 2.0.