如要在 Messenger 或 Instagram 上傳送訊息給用戶,對話必須由該用戶發起。您可透過 Messenger 平台傳送數種不同類型的訊息。每種訊息都有不同的政策和規範來限制可傳送的內容類型,以及要傳送訊息所須符合的條件。
在適用法律的要求下,自動化聊天室體驗必須披露用戶的互動對象是自動化服務,時間點則是:
為下列族群服務的自動化聊天室體驗應特別注意這項規定:
披露聲明可能包含但不限於:「我是 [專頁名稱] 機械人」、「你的互動對象是自動化體驗」、「你的交談對象是機械人」或「我是自動化聊天室」。
即使法律沒有要求,我們還是建議您最好在用戶與自動化聊天室互動時告知他們,因為這有助於管理用戶在與您的訊息體驗互動時抱持的期待。
如需詳細資訊,請參閱開發人員政策。
來自您應用程式的所有 Send API 要求都必須包含以下項目:
如需進一步了解訊息組成元素,請瀏覽 Send API 參考資料。
標準訊息時限您獲允許向用戶傳送訊息的 24 小時期限。如果有人向您的專頁或 Instagram 專業帳戶傳送訊息,或是透過網絡附加程式展開對話,您的應用程式最多可在 24 小時內傳送訊息。
在 24 小時期限內傳送的訊息可以包含推廣內容。
引發 24 小時標準訊息時限的用戶動作
以下用戶動作將引發 24 小時標準訊息時限:
我們知道,用戶都希望能及時收到回應。因此,我們強烈建議您在此 24 小時期限內儘快回覆。用戶隨時都可以選擇封鎖或關閉對話通知。
接收訊息的用戶之編號是在 recipient
物件參數中設定,可為下列任何一種編號類型:
專頁範圍編號 (PSID):用戶首次向您的專頁傳送訊息時,系統分配給該用戶的編號。這個不重複的編號表示您的專頁與該用戶之間的互動情形。
用戶參考編號:系統把這個編號分配給使用附加程式或回傳按鈕向您專頁傳送訊息的用戶。
帖子或回應編號:系統把這個編號分配給在您專頁上發佈帖子或回應帖子的用戶;而此編號會用來向相關用戶傳送私人回覆。
請注意,來自 Facebook 登入整合工具的用戶編號屬於應用程式範圍,不適用於 Messenger 平台。
您傳送的訊息類型是在 messaging_type
參數中設定。此參數是一種更明確的方法,可確保您的訊息傳送動作遵循訊息政策規定而且符合傳送對象的偏好。
系統支援以下類型的訊息:
回覆:這類訊息用於回覆所收到的訊息,可包含推廣和非推廣內容,而且必須在標準訊息期限內傳送。
更新:這類訊息為主動傳送,並非用來回覆所收到的訊息,可包含推廣和非推廣內容,而且必須在標準訊息期限內傳送。
被標註的訊息:這類訊息是在標準訊息期限以外傳送的訊息,必須加入訊息標籤(符合標籤的允許使用案例),並包含非推廣內容。
有了訊息標籤,您可在標準訊息時限以外的時間傳送訊息。此類訊息為與用戶切身相關的最新資訊。例如,您可以傳送關於送貨和配送、即將到來的預訂或航班最新資訊,或者有關顧客帳戶的提醒。若訊息流程需要呈報路徑,企業代表可運用真人客戶服務人員標籤在 7 天期限內親自回覆用戶的訊息。
訊息標籤不可用於傳送推廣內容,包括但不限於限時促銷、優惠、優惠券和折扣。如果在獲准使用案例以外的情況下使用訊息標籤,可能會導致專頁或 Instagram 帳戶訊息傳送功能受限。如需更多詳細資訊,請參閱 Messenger 平台和 Instagram 訊息 API 政策 。
如果使用 Messenger 平台的企業要在 24 小時標準通訊期限以外的時間傳送推廣訊息,則應使用贊助訊息或一次性通知。
您傳送的訊息可能包含以下內容類型:
|
|
|
若要傳送基本文字訊息給向您專頁傳送了訊息的用戶,請傳送 POST
要求至 /PAGE-ID/messages
端點,其中 recipient
物件常值鍵 id
設定為用戶的專頁範圍編號 (PSID),message_type
參數設定為 RESPONSE
,message
參數物件 text
設定為訊息文字。
curl -X POST -H "Content-Type: application/json" -d '{
"recipient":{
"id":"{PSID}"
},
"messaging_type": "RESPONSE",
"message":{
"text":"Hello, world!"
}
}' "https://graph.facebook.com/v20.0
/{PAGE-ID}/messages?access_token={PAGE-ACCESS-TOKEN}"
成功的話,您的應用程式就會收到以下 JSON 回應,以及傳送對象編號和訊息編號。
{ "recipient_id": "PAGE-SCOPED-ID", "message_id": "AG5Hz2U..." }
若要傳送附有媒體(例如 GIF 或圖片)或範本的訊息,您應該在 JSON 訊息附件物件內的 API 要求加入內容。
若要傳送附有圖片的訊息給向您專頁傳送了訊息的用戶,請傳送 POST
要求至 /PAGE-ID/messages
端點,其中 recipient
物件常值鍵 id
設定為用戶的專頁範圍編號 (PSID),message_type
參數設定為 RESPONSE
,message
參數 attachment
物件 type
鍵設定為 image
,以及 payload
物件 url
鍵設定為圖片網址。
curl -X POST -H "Content-Type: application/json" -d '{
"recipient":{
"id":"1254459154682919"
},
"message":{
"attachment":{
"type":"image",
"payload":{
"url":"http://www.messenger-rocks.com/image.jpg",
"is_reusable":true
}
}
}
}' "https://graph.facebook.com/v20.0
/me/messages?access_token=<PAGE_ACCESS_TOKEN>"
成功的話,您的應用程式就會收到以下 JSON 回應,以及傳送對象編號和訊息編號。
{ "recipient_id": "PAGE-SCOPED-ID", "message_id": "AG5Hz2U..." }
從網址傳送音訊、影片或檔案應使用相同格式。
您還可以從伺服器或使用之前已上載至 Meta 伺服器的內容傳送媒體。進一步了解如何使用附件上載 API 上載檔案。
保持言簡意賅。請考慮螢幕的大小與捲動行為;簡短的訊息比較易讀和易懂。請嘗試分別傳送幾個訊息,避免一下子傳送一則「千字文」。
請勿以文字取代圖像、表格、圖表與圖像。結構化訊息(甚至網頁檢視)都能更好地滿足您的需求。
請勿撰寫冗長的訊息。如要說明多個項目,請嘗試分別傳送幾個訊息,避免一下子傳送一則「千字文」。
謹記品質為上。使用高解像度的彩色圖像,讓您的訊息更加突出。
注意長闊比例。查看圖像在訊息聊天泡泡中出現的裁剪版本。
請勿在圖像中加入大量文字。請改用文字訊息,或使用通用範本來結合圖像與文字。
新聞訊息功能:這種功能只適用於已在 Facebook 新聞專頁索引 (NPI) 註冊的新聞發佈商。透過新聞訊息功能,新聞發佈商可以向已訂閱接收相關訊息的用戶傳送非推廣新聞訊息。
Instagram 訊息 API 不支援新聞訊息功能。
一次性通知:這種通知讓您可在標準訊息期限結束後,要求用戶允許您傳送一則跟進訊息。如果用戶接受此要求以接收一次性通知,您將能夠傳送一則具有時效性且與用戶切身相關的通知,例如預約提醒或補貨提醒。
Instagram 訊息 API 不支援一次性通知。
私人回覆:當用戶在您其中一則帖子或廣告發佈回應,或在您的專頁或 Instagram 專業帳戶上發佈訪客帖子時,您可透過這種回覆向該用戶傳送訊息。私人回覆僅可為單一訊息,其中將自動附有帖子或回應的連結,並且必須在用戶發佈帖子或回應後的 7 天內傳送。
營銷訊息:這種訊息讓您可在標準訊息期限結束後,要求用戶允許您傳送多則營銷訊息。如果用戶接受此要求以接收這些訊息,您將能夠向該用戶自動定期傳送推廣訊息,其中包含有關您近期促銷活動或產品發佈及更新的資訊。
贊助訊息:這種訊息允許您在標準訊息期限到期後,繼續向之前曾向您專頁或 Instagram 專業帳戶傳送訊息的用戶傳送推廣或非推廣內容。贊助訊息的顯示方式在對話中與一般訊息幾乎無異,但會在訊息上方標示「贊助」一詞。贊助訊息內容必須遵守廣告刊登政策。
Instagram 訊息 API 不支援贊助訊息功能。
進一步了解您可新增至對話訊息的元件。
進一步了解如何使用 Messenger 平台傳送訊息。