Method: phones.agentMessages.create

Отправляет сообщение от агента пользователю.

Чтобы агент мог успешно отправить сообщение, у пользователя должен быть включен RCS и он должен быть доступен платформе RBM. Если сообщение успешно отправлено, вызов возвращается без ошибок. В противном случае агент получает код ошибки.

Если пользователь онлайн, платформа RBM сразу же доставляет сообщение. В противном случае платформа RBM ставит сообщение в очередь и доставляет его, когда пользователь в следующий раз подключится к сети.

Платформа RBM игнорирует любое сообщение агента, отправленное с идентификатором, который использовался предыдущим сообщением или событием, отправленным от того же агента.

Сообщения агента могут быть отозваны между моментом их отправки и моментом доставки.

HTTP-запрос

POST https://rcsbusinessmessaging.googleapis.com/v1/{parent=phones/*}/agentMessages

URL-адрес использует синтаксис транскодирования gRPC .

Параметры пути

Параметры
parent

string

«phones/{E.164}», где {E.164} — номер телефона пользователя в формате E.164. Например, для номера телефона в США +1-222-333-4444 значение будет иметь вид телефоны/+12223334444, а конечная точка будет https://rcsbusinessmessaging.googleapis.com/v1/phones/+12223334444/agentMessages . .

Параметры запроса

Параметры
messageId

string

Уникальный идентификатор сообщения, присвоенный агентом. Это должен быть UUID, как определено в https://tools.ietf.org/html/rfc4122 . Платформа RBM игнорирует любое сообщение агента, отправленное с идентификатором, который использовался предыдущим сообщением или событием, отправленным от того же агента.

agentId

string

Необходимый. Уникальный идентификатор агента.

Тело запроса

Тело запроса содержит экземпляр AgentMessage .

Тело ответа

В случае успеха тело ответа содержит вновь созданный экземпляр AgentMessage .

Области авторизации

Требуется следующая область действия OAuth:

  • https://www.googleapis.com/auth/rcsbusinessmessaging

Дополнительную информацию см. в обзоре OAuth 2.0 .