Messenger Send API:從 Facebook 專頁傳送訊息
Facebook 專頁透過 POST /{page-id}/messages 並使用專頁存取權杖傳送 Messenger 訊息:recipient 須包含該用戶的專頁範圍 ID(PSID);在標準訊息時限內,messaging_type 為 RESPONSE 或 UPDATE,時限過後則為 MESSAGE_TAG;message 則承載文字,或圖片、音訊、影片、檔案等附件。Meta 會以 recipient_id 與 message_id 回覆。
easyCoexistence 可透過 Claude、ChatGPT 或您自己的程式碼,在 24 小時時限內以 send_social_dm 回覆 Messenger 私訊,內容為文字;媒體、快速回覆及範本則不在支援範圍內。
應用程式可對每個專頁作出的 Send API 呼叫次數(適用於含文字、連結、反應及貼圖的訊息)。
應用程式可對每個專頁作出的 Send API 呼叫次數(適用於含音訊或影片的訊息)。
Messenger Platform 可儲存供重用的最大素材;以 URL 上載的圖片上限為 8 MB。
單則訊息的 attachments 陣列最多可承載的圖片數量,也是該陣列唯一允許的媒體類型。
已儲存的 attachment_id 有效多久,之後須重新上載媒體。
Send API 請求包含哪些內容?
Meta 列出傳送時必須包含的六個組成部分:傳送方的專頁 ID、接收方的 ID、該專頁的專頁存取權杖、用戶的許可、訊息類型及內容。請求為以 JSON 形式 POST 至 /{page-id}/messages,回覆剛發來訊息的用戶時,格式如下:
POST /{page-id}/messages
{
"recipient": { "id": "<PSID>" },
"messaging_type": "RESPONSE",
"message": { "text": "Your order ships tomorrow." }
}
{ "recipient_id": "<PSID>", "message_id": "<MESSAGE_ID>" }recipient 應填入哪種 ID?
通常是 Meta 在用戶首次向專頁傳送訊息時指派的專頁範圍 ID,即 PSID;它會在 messages webhook 中以 sender.id 送達。recipient 物件亦接受其他類型的 ID,供特定情況使用:
- id:PSID,對該用戶及該專頁而言為唯一值。
user_ref:用戶曾透過外掛程式或 postback 按鈕向專頁傳送訊息時使用。comment_id或post_id:用於私下回覆留言或訪客貼文。- 來自 Facebook Login 的 ID 屬應用程式範圍,無法用於 Messenger Platform。
一則訊息應使用哪種 messaging_type?
此類型說明 Meta 傳送該訊息的原因,並決定何時允許傳送。Meta 的專頁訊息參考列出四個值:
- RESPONSE:回覆專頁所收到的訊息,不論是否屬推廣性質,並須在標準訊息時限內。
- UPDATE:專頁主動傳送的訊息,不論是否屬推廣性質,同樣須在標準訊息時限內。
MESSAGE_TAG:時限過後傳送的非推廣訊息,並須附上與已核准用途相符的標籤。- UTILITY:根據已核准範本製作的實用訊息,例如訂單或預約更新。
訊息可以承載什麼?
可為文字,或一個含類型與負載的 attachment 物件:圖片、音訊、影片及檔案附件會指向 URL 或已儲存的 attachment_id;範本附件則承載帶按鈕的結構化訊息。同一端點亦接受以下參數:
- attachments:一個陣列,最多可在一則訊息內傳送 30 張圖片。
reply_to配合 mid:回覆較早前的特定訊息,無論是用戶或專頁發出的。quick_replies:輸入框上方最多 13 個按鈕,每個標題最多 20 個字元。sender_action:輸入中指示、已讀標記或反應,須與訊息本身分開,以另一個請求傳送。notification_type:預設為 REGULAR,亦可設為SILENT_PUSH或NO_PUSH。
附件可以有多大?
Meta 有關儲存素材的指南,為 Messenger Platform 擷取並保存的媒體設定了上限:素材最大 25 MB;以 URL 上載的圖片最大 8 MB;音訊須以音訊 Content-Type 傳送;影片須於 75 秒內擷取完成。將 is_reusable 設為 true 會返回一個 attachment_id,只有傳送該附件的專頁可重用,有效期為 90 天;POST /{page-id}/message_attachments 可預先上載媒體。
Send API 的速率限制是多少?
Meta 按專頁及內容類型計算。其專頁訊息參考將錯誤代碼 613 列為傳送錯誤之一,即「呼叫已超出速率限制」。出現此錯誤時,應放慢速度,而非立即重試:
- 每個專頁每秒 300 次,適用於文字、連結、反應及貼圖訊息。
- 每個專頁每秒 10 次,適用於音訊或影片訊息。
- 同一對話內傳送過多訊息,亦可能單獨受到速率限制。
- Messenger API 呼叫總數:以 24 小時滾動計,為有互動用戶數目的 200 倍。
- 每秒超過 40 則訊息時,專頁收件匣會停止顯示新訊息,專頁在流量回落前無法傳送。
Send API 會返回哪些錯誤?
Meta 的 Messenger 錯誤表將每個代碼與一個說明成因的子代碼配對。以下是專頁傳送時最常遇到的錯誤:
- 10 配 2018278 或 2534022:訊息在允許的時限之外傳送。
- 10 配 2018300:另一應用程式控制該對話。
- 100:參數無效,例如收件人 ID 錯誤;子代碼 2018001 顯示「找不到相符用戶」。
- 551:用戶不可用,可能已封鎖專頁或停用帳戶;200 配 1545041 顯示「此用戶暫時無法使用」。
- 200 配 2018028:在
pages_messaging通過審核且應用程式上線前,應用程式無法向其角色以外的用戶傳送訊息。 - 10904:專頁已在設定中停用訊息功能。
easyCoexistence 如何透過它傳送?
send_social_dm 接受 account_id、收件人 recipient_id(即轉發的 messages 事件中的 sender.id)及文字,並以 messaging_type RESPONSE 傳送至 /{page-id}/messages。結果為 Meta 返回的 message_id;傳送被拒時,則返回 Meta 的錯誤代碼與訊息。媒體、快速回覆、範本及 sender_action 不在工具之列:send_social_dm 只傳送文字。
常見錯誤
- 將輸入中指示與訊息一併傳送。Meta 要求 sender_action 須與收件人單獨傳送,文字或範本則須另行以獨立請求傳送。
- 向單一用戶連發大量訊息。Meta 可能會單獨對同一對話施加速率限制,獨立於專頁每秒 300 次的呼叫上限。
- 以文字速率傳送音訊或影片。音訊或影片訊息的上限為每個專頁每秒 10 次。
- 重用超過 90 天的 attachment_id。已儲存的附件 ID 會過期,請重新上載媒體以取得新 ID。
自動化功能可按固定文字或 AI 回覆,自動回應新訊息。每個連接每月由 US$ 9 降至 US$ 0.75,連接越多越便宜,首 3 天免費。
常見問題
Messenger Send API 免費嗎?
是,標準訊息免費。Meta 的概覽列明 Messenger Platform 免費使用,因此專頁回覆主動來訊的用戶時,每則訊息都無須付費;推廣訊息則按每則收費。
傳送訊息需要哪種專頁任務?
Meta 的 Messenger 概覽要求專頁存取權杖來自可執行 MESSAGING 及 MODERATE 任務的人,並已獲授予 pages_messaging 權限。
easyCoexistence 可否在 Messenger 回覆圖片?
目前不行。send_social_dm 只傳送文字,沒有任何工具可傳送附件。
easyCoexistence 為 Facebook 專頁收費多少?
每個您連接的專頁即為一個連接,按您擁有的連接數目,每個連接每月由 US$ 9 降至 US$ 0.75,首 3 天免費。
繼續閱讀
兩分鐘內連接您的第一個頻道。
無需等待平台審核。連接 WhatsApp、Instagram、TikTok 或其他頻道,然後請您的 AI 發佈貼文、回覆訊息或匯報數據,並看着它運作。
- 免費試用 3 天
- 隨時取消
- 只用官方 API
- 24/7 監察
驗證日期