Envía un mensaje del agente a un usuario.
Para que el agente envíe un mensaje correctamente, el usuario debe tener habilitado el RCS y ser accesible a través de la plataforma de RCS Business Messaging. De lo contrario, el agente recibe un código de error 404.
Si el usuario está en línea, la plataforma de RCS for Business entrega el mensaje de inmediato. De lo contrario, la plataforma de RCS for Business pone el mensaje en cola y lo entrega la próxima vez que el usuario esté en línea.
La plataforma de RCS for Business ignora cualquier mensaje del agente que se envíe con un ID que se haya usado en un mensaje o evento anterior enviado desde el mismo agente.
Los mensajes del agente se pueden revocar entre el momento en que se envían y el momento en que se entregan.
Solicitud HTTP
POST https://rcsbusinessmessaging.googleapis.com/v1/{parent=phones/*}/agentMessages
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
| Parámetros | |
|---|---|
parent |
"phones/{E.164}", donde {E.164} es el número de teléfono del usuario en formato E.164. Por ejemplo, con el número de teléfono de EE.UU. +1-222-333-4444, el valor sería phones/+12223334444, y el extremo resultante sería https://rcsbusinessmessaging.googleapis.com/v1/phones/+12223334444/agentMessages. |
Parámetros de consulta
| Parámetros | |
|---|---|
messageId |
Obligatorio. Es el ID único del mensaje, asignado por el agente. Debe ser un UUID, según se define en https://tools.ietf.org/html/rfc4122. La plataforma de RCS for Business ignora cualquier mensaje del agente que se envíe con un ID que se haya usado en un mensaje o evento anterior enviado desde el mismo agente. |
agentId |
Obligatorio. Es el identificador único del agente. |
Cuerpo de la solicitud
El cuerpo de la solicitud contiene una instancia de AgentMessage.
Cuerpo de la respuesta
Si el proceso se realiza de forma correcta, el cuerpo de la respuesta contiene una instancia recién creada de AgentMessage.
Permisos de autorización
Requiere el siguiente permiso de OAuth:
https://www.googleapis.com/auth/rcsbusinessmessaging
Para obtener más información, consulta OAuth 2.0 Overview.