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 RCS for Business). Si RCS for Business ne parvient pas à joindre l'utilisateur, la plate-forme RCS for Business 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} est le 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 américain est +1-222-333-4444, la valeur serait phones/+12223334444 et 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 https://tools.ietf.org/html/rfc4122. La plate-forme RCS for Business ignore tout message d'agent envoyé avec un ID qui a été utilisé par un message ou un é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 de AgentEvent.
Corps de la réponse
Si la requête aboutit, le corps de la réponse contient une nouvelle instance de AgentEvent.
Niveaux d'accès des autorisations
Requiert le niveau d'accès OAuth suivant :
https://www.googleapis.com/auth/rcsbusinessmessaging
Pour plus d'informations, consultez la OAuth 2.0 Overview.