從服務專員傳送訊息給使用者。
使用者必須啟用 RCS 並由 RBM 平台連線,服務專員才能順利傳送訊息。成功傳送訊息後,呼叫會傳回沒有錯誤。否則代理程式會收到錯誤代碼。
如果使用者在線上,RBM 平台會立即傳送訊息。否則,RBM 平台會將訊息排入佇列,並在使用者下次連線時傳送。
如果您透過同一代理程式傳送稍早的訊息或事件使用此 ID,透過 RBM 平台傳送這些訊息,RBM 平台就會忽略該訊息。
您可以在傳送代理程式訊息和訊息傳送時間之間撤銷代理程式訊息。
HTTP 要求
POST https://rcsbusinessmessaging.googleapis.com/v1/{parent=phones/*}/agentMessages
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 | |
---|---|
parent |
「phones/{E.164}」,其中 {E.164} 是 E.164 格式的使用者電話號碼。舉例來說,美國的電話號碼 +1-222-333-4444,則值為「phone/+12223334444」,而產生的端點為 https://rcsbusinessmessaging.googleapis.com/v1/phones/+12223334444/agentMessages。 |
查詢參數
參數 | |
---|---|
messageId |
訊息的專屬 ID,由服務專員指派。這必須是 https://tools.ietf.org/html/rfc4122 中定義的 UUID。如果您透過同一代理程式傳送稍早的訊息或事件使用此 ID,透過 RBM 平台傳送這些訊息,RBM 平台就會忽略該訊息。 |
agentId |
必要欄位。代理程式的專屬 ID。 |
要求主體
要求主體包含 AgentMessage
的例項。
回應主體
如果成功,回應主體會包含新建立的 AgentMessage
例項。
授權範圍
需要下列 OAuth 範圍:
https://www.googleapis.com/auth/rcsbusinessmessaging
詳情請參閱 OAuth 2.0 總覽。