Skip to main content
POST
傳送新的私訊 (DM) 給收件者。
計費與限制: 每個 User Profile 每個計費週期在所有社群網路中最多可有 1,000 個活躍對話。計費依方案而定:Premium 方案支付每月固定 49附加費用,而LaunchBusiness方案則按每個活躍對話49** 附加費用,而 **Launch** 與 **Business** 方案則按 **每個活躍對話 0.09 計費。當您在計費週期內傳送訊息給收件者時,該對話即被計為活躍;單純收到的訊息並不會計入。活躍對話中訊息的數量不受限制。
  • 您可以在 message 文字中加入表情符號。
  • Facebook 與 Instagram 的 mediaUrls 必須以已知的副檔名結尾。若加入查詢參數,會導致該媒體 URL 失敗。
WhatsApp 24 小時客服視窗。 WhatsApp Business 僅允許在對方最後一則訊息後的 24 小時內傳送自由格式的外送訊息。超過該視窗後,Meta 會拒絕發送,直到對方再次來訊為止。目前此端點尚不支援 24 小時視窗外的範本訊息 (templated messages)。

標頭參數

路徑參數

string
必填
傳送訊息的平台:facebookinstagramtwitterwhatsapp

主體參數

string
必填
訊息收件者的 ID。
  • 對於 FacebookInstagramX/Twitter,這是該平台專屬的使用者 ID(PSID、IGSID 或 user ID)。
  • 對於 WhatsApp,這是收件者的 E.164 電話號碼,僅數字格式(例如 14155551234,而非 +1 (415) 555-1234)。
string
必填
要傳送給收件者的訊息。
  • Facebook、Instagram 與 WhatsApp 的 message 在已提供 mediaUrls 時,可為空字串或完全省略。
  • X 要求至少一個字元的訊息,即使已提供 mediaUrls 也一樣。
array
用於附加圖片、影片、音訊(包括語音訊息)或文件的媒體 URL 陣列。
  • 媒體項目的 URL 應以副檔名結尾,且不附加其他參數。
  • Facebook 與 Instagram 支援多個媒體 URL。
  • X 只接受單一媒體 URL。
  • Facebook 與 Instagram 支援語音訊息,格式為 aacwav 檔。
  • WhatsApp 接受多個媒體 URL。Ayrshare 會擷取每個 URL,並依其回應的 Content-Type 選擇對應的 WhatsApp 媒體類別。Meta 接受:
    • Image: .jpg.jpeg.png
    • Video: .mp4.3gp
    • Audio: .aac.amr.mp3.m4a.ogg
    • Document: .txt.pdf.ppt.pptx.doc.docx.xls.xlsx