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 que l'agent est en train de saisir du texte (ce qui ajoute un élément humain à l'expérience RBM). Si RBM ne peut pas toucher 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 est situé aux États-Unis : +1-222-333-4444, la valeur est "Phones/+12223334444". Le point de terminaison obtenu est 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 https://tools.ietf.org/html/rfc4122. La plate-forme RBM ignore les messages d'agent envoyés avec un ID qui a été utilisé par un message ou un événement précédent 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 de 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 OAuth 2.0 Overview.