Method: phones.agentEvents.create

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

События агента могут указывать на то, что агент прочитал сообщение от пользователя или находится в процессе набора текста (что добавляет человеческий фактор в работу RCS для бизнеса). Если у пользователя не включен RCS, платформа RCS для бизнеса возвращает ошибку NOT_FOUND (HTTP 404). Если у пользователя включен RCS, но в данный момент он недоступен, платформа возвращает ответ 200 OK и обрабатывает доставку в зависимости от типа события. События агента помещаются в очередь с сохранением и пересылкой на срок до 30 дней и доставляются после того, как пользователь снова подключится к сети. Только события IS_TYPING являются временными и не помещаются в очередь.

В отличие от сообщений от агентов, события от агентов нельзя отменить после отправки.

HTTP-запрос

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

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

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

Параметры
parent

string

"phones/{E.164}", где {E.164} — это номер телефона пользователя в формате E.164. Например, для пользователя с американским номером телефона +1-222-333-4444 значение будет phones/+12223334444, а результирующая конечная точка будет https://rcsbusinessmessaging.googleapis.com/v1/phones/+12223334444/agentEvents .

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

Параметры
eventId

string

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

agentId

string

Обязательно. Уникальный идентификатор агента.

Текст запроса

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

Ответный текст

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

Области полномочий

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

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

Для получения более подробной информации см.OAuth 2.0 Overview .