Method: phones.agentEvents.create

將事件從代理程式傳送給使用者。

代理程式事件可用來表示代理程式已讀取使用者的訊息，或服務專員正在輸入內容 (為 RBM 體驗增添人為元素)。如果 RBM 無法連線至使用者，RBM 平台會傳回 404 NOT_FOUND。

與代理程式訊息不同，代理程式事件在傳送後即無法撤銷。

HTTP 要求

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

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
parent

string

「phones/{E.164}」，其中 {E.164} 是使用者的電話號碼 (採用 E.164 格式)。舉例來說，如果某位使用者使用美國電話號碼「+1-222-333-4444」，這個值會是 phone/+12223334444，產生的端點則是 https://rcsbusinessmessaging.googleapis.com/v1/phones/+12223334444/agentEvents。

查詢參數

參數
eventId

string

由服務專員指派的事件 ID。這必須是 https://tools.ietf.org/html/rfc4122 中定義的 UUID。RBM 平台會忽略所有由相同代理程式傳送且使用 ID 的代理程式訊息。
agentId

string

必要欄位。代理程式的專屬 ID。

要求主體

要求主體包含 AgentEvent 的例項。

回應主體

如果成功，回應主體會包含新建立的 AgentEvent 例項。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 Overview。