Method: phones.agentEvents.create

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

代理程式事件可用於指出代理程式已讀取使用者傳送的訊息，或代理程式正在輸入內容 (為 RCS Business Messaging 體驗增添人味)。如果使用者未啟用 RCS，RCS 企業版平台會傳回 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://tools.ietf.org/html/rfc4122 所定義。如果代理程式傳送的訊息或事件使用先前傳送的 ID，RCS Business 平台會忽略該訊息。
agentId

string

必填。代理程式的專屬 ID。

要求主體

要求主體包含 AgentEvent 的例項。

回應主體

如果成功，回應主體會包含新建立的 AgentEvent 執行個體。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱OAuth 2.0 Overview。