Envoie un message de l'agent à un utilisateur.
L'utilisateur doit être compatible avec le RCS et joignable par la plate-forme RBM pour que l'agent puisse envoyer un message. Une fois le message envoyé, l'appel est renvoyé sans erreur. Sinon, l'agent reçoit un code d'erreur.
Si l'utilisateur est en ligne, la plate-forme RBM transmet immédiatement le message. Sinon, la plateforme RBM met le message en file d'attente et le distribue lors de la prochaine connexion de l'utilisateur.
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.
Les messages d'agent peuvent être révoqués entre leur envoi et leur distribution.
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} correspond au numéro de téléphone de l'utilisateur au format E.164. Par exemple, si le numéro de téléphone aux États-Unis est +1-222-333-4444, la valeur est phones/+12223334444 et le point de terminaison résultant est https://rcsbusinessmessaging.googleapis.com/v1/phones/+12223334444/agentMessages. |
Paramètres de requête
| Paramètres | |
|---|---|
messageId |
Identifiant unique du message, 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 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 la présentation d'OAuth 2.0.