Method: phones.agentMessages.create

服務專員傳送訊息給使用者。

使用者必須啟用 RCS，且 RCS for Business 平台必須能連上使用者，代理程式才能順利傳送訊息。否則，代理程式會收到 404 錯誤碼。

如果使用者處於連線狀態，RCS Business Messaging 平台會立即傳送訊息。否則，RCS 企業通訊平台會將訊息加入佇列，並在使用者下次上線時傳送。

如果代理程式傳送的訊息或事件使用先前傳送的 ID，RCS Business 平台會忽略該訊息。

代理人訊息在傳送後到送達前這段時間內，都可以撤銷。

HTTP 要求

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

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

路徑參數

參數
parent

string

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

查詢參數

參數
messageId

string

必要欄位。代理程式指派的訊息專屬 ID。這必須是 UUID，如 https://tools.ietf.org/html/rfc4122 所定義。如果代理程式傳送的訊息或事件使用先前傳送的 ID，RCS Business 平台會忽略該訊息。
agentId

string

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

要求主體

要求主體包含 AgentMessage 的例項。

回應主體

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

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱OAuth 2.0 Overview。