跳转到主要内容
POST
傳送新的私訊 (DM) 給收件者。
計費與限制: 每個 User Profile 每個計費週期在所有社群網路中最多可有 1,000 個活躍對話。計費依方案而定:Premium 方案支付每月固定 49附加費用,而LaunchBusiness方案則按每個活躍對話49** 附加費用,而 **Launch** 與 **Business** 方案則按 **每個活躍對話 0.09 計費。當您在計費週期內傳送訊息給收件者時,該對話即被計為活躍;單純收到的訊息並不會計入。活躍對話中訊息的數量不受限制。
  • 您可以在 message 文字中加入表情符號。
  • Facebook 與 Instagram 的 mediaUrls 必須以已知的副檔名結尾。若加入查詢參數,會導致該媒體 URL 失敗。

標頭參數

路徑參數

platform
string
必填
傳送訊息的平台:facebookinstagramtwitter

主體參數

recipientId
string
必填
訊息收件者的 ID。
message
string
必填
要傳送給收件者的訊息。
  • 在 Facebook 與 Instagram 中,若已提供 mediaUrls,message 可為空字串或不提供。
  • X 要求至少一個字元的訊息,即使已提供 mediaUrls 也一樣。
mediaUrls
array
用於附加圖片、影片或語音訊息的媒體 URL 陣列。
  • 媒體項目的 URL 應以副檔名結尾,且不附加其他參數。
  • Facebook 與 Instagram 支援多個媒體 URL。
  • X 只接受單一媒體 URL。
  • Facebook 與 Instagram 支援語音訊息,格式為 aacwav 檔。