Envoie un message de l'agent à un utilisateur.
Pour que l'agent puisse envoyer un message, l'utilisateur doit avoir activé le RCS et être joignable par la plate-forme RBM. Sinon, l'agent reçoit un code d'erreur 404.
Si l'utilisateur est en ligne, la plate-forme RBM distribue le message immédiatement. Sinon, la plate-forme RBM met le message en file d'attente et le distribue la prochaine fois que l'utilisateur sera en ligne.
La plate-forme RBM ignore tout message d'agent envoyé avec un ID utilisé par un message ou un événement précédent envoyé par le même agent.
Les messages envoyés par les agents peuvent être révoqués entre le moment où ils sont envoyés et le moment où ils sont distribués.
Requête HTTP
POST https://rcsbusinessmessaging.googleapis.com/v1/{parent=phones/*}/agentMessages
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, avec le numéro de téléphone américain +1-222-333-4444, la valeur sera phones/+12223334444, et le point de terminaison obtenu sera https://rcsbusinessmessaging.googleapis.com/v1/phones/+12223334444/agentMessages. |
Paramètres de requête
Paramètres | |
---|---|
messageId |
Obligatoire. ID unique du message, attribué par l'agent. Il doit s'agir d'un UUID, comme défini dans https://tools.ietf.org/html/rfc4122. La plate-forme RBM ignore tout message d'agent envoyé avec un ID 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 AgentMessage
.
Corps de la réponse
Si la requête aboutit, le corps de la réponse contient une nouvelle instance de AgentMessage
.
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.