Method: phones.agentMessages.create

Envoie un message de l'agent à un utilisateur.

Pour que l'agent puisse envoyer un message, l'utilisateur doit être compatible avec le RCS et joignable par la plate-forme RCS for Business. Sinon, l'agent reçoit un code d'erreur 404.

Si l'utilisateur est en ligne, la plate-forme RCS for Business lui envoie le message immédiatement. Sinon, la plate-forme RCS for Business met le message en file d'attente et le distribue lorsque l'utilisateur se reconnecte.

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.

Les messages des agents peuvent être révoqués entre le moment où ils sont envoyés et celui où ils sont remis.

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

string

"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 serait phones/+12223334444 et le point de terminaison obtenu serait https://rcsbusinessmessaging.googleapis.com/v1/phones/+12223334444/agentMessages.

Paramètres de requête

Paramètres
messageId

string

Obligatoire. Identifiant unique du message, 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

string

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.

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.