Method: phones.agentEvents.create

从代理向用户发送事件。

代理事件可用于指示代理已阅读用户的消息，或代理正在输入内容（这为 RCS for Business 体验增添了人性化元素）。如果用户未启用 RCS，RCS for Business 平台会返回 NOT_FOUND (HTTP 404) 错误。如果用户已启用 RCS，但目前无法联系，平台会返回 200 OK 响应，并根据事件类型处理递送。代理事件会在存储转发队列中排队最多 30 天，并在用户重新上线后传送。只有 IS_TYPING 事件是临时事件，不会排队。

与代理消息不同，代理事件在发送后无法撤消。

HTTP 请求

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

网址采用 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

事件的 ID，由代理分配。此值必须是 UUID，如 https://www.rfc-editor.org/info/rfc9562 中所定义。RCS for Business 平台会忽略任何使用同一代理之前发送的消息或事件所用 ID 发送的代理消息。
agentId

string

必需。智能体的唯一标识符。

请求正文

请求正文包含一个 AgentEvent 实例。

响应正文

如果成功，响应正文将包含一个新创建的 AgentEvent 实例。

授权范围

需要以下 OAuth 范围：

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

如需了解详情，请参阅 OAuth 2.0 Overview。