若要在 Messenger 或 Instagram 上傳送訊息給用戶,必須由該用戶起始對話。Messenger 平台具有多種不同的訊息類型可供您傳送。每種訊息類型對於可傳送的內容類型,以及在何種情況下可以傳送,各有不同的政策和守則。
在適用法律的要求下,自動化聊天室體驗必須披露用戶的互動對象是自動化服務,時間點則是:
為下列族群服務的自動化聊天室體驗應特別注意這項規定:
披露聲明可能包含但不限於:「我是 [專頁名稱] 機械人」、「你的互動對象是自動化體驗」、「你的交談對象是機械人」或「我是自動化聊天室」。
即使法律沒有要求,我們還是建議您最好在用戶與自動化聊天室互動時告知他們,因為這有助於管理用戶在與您的訊息體驗互動時抱持的期待。
如需詳細資訊,請參閱開發人員政策。
所有用於傳送訊息的應用程式傳送 API 要求皆必須包含下列項目:
如需有關訊息元件的詳細資訊,請瀏覽傳送 API 參考資料。
標準訊息期限是允許您向用戶傳送訊息的 24 小時時段期間。當用戶傳送訊息到您的粉絲專頁或 Instagram 專業帳號,或透過網頁外掛程式開始對話,您的應用程式最多有 24 小時的時間可以傳送訊息。
於 24 小時訊息期限內傳送的訊息可能包含促銷內容。
開啟標準訊息期限的用戶動作
以下用戶動作可開啟 24 小時標準訊息期限:
我們知道用戶希望立即收到回覆,因此強烈建議您在 24 小時內儘快回覆。用戶可隨時選擇封鎖對話,或關閉對話通知。
接收訊息的用戶編號是在 recipient
物件參數中設定,可使用下列其中一種編號類型:
粉絲專頁範圍編號(PSID):用戶首次向粉絲專頁傳送訊息時為其指派的編號。此不重複編號代表粉絲專頁與用戶之間的互動。
用戶參考:指派給使用外掛程式或回傳按鈕向粉絲專頁傳送訊息之用戶的編號。
貼文或留言編號:指派給在粉絲專頁上發佈貼文或向貼文留言之用戶的編號。用於傳送私密回覆給用戶。
請注意,來自 Facebook 登入整合的用戶編號屬於應用程式範圍,無法與 Messenger 開放平台搭配使用。
要傳送的訊息類型是在 messaging_type
參數中設定。此參數是確保傳訊更能符合訊息政策和收件人偏好設定的明確方法。
系統支援以下訊息類型:
回覆:傳送的訊息用以回覆收到的訊息。訊息可包含促銷和非促銷內容,且必須在標準訊息期限內傳送。
更新:主動傳送的訊息,而不是用於回覆之前所收到的訊息。訊息可包含促銷和非促銷內容,且必須在標準訊息期限期間傳送。
含有標籤的訊息:在標準訊息期限之外傳送的訊息。此類訊息必須包含符合標籤之允許使用案例的訊息標籤,並包含非促銷內容。
訊息標籤允許您在標準訊息期限之外傳送訊息。這些訊息是用戶個人相關的更新資訊。例如,您可以傳送有關配送服務和投遞的更新資訊、近期預約或航班,或有關顧客帳號的提醒。對於需要提報管道的傳送訊息流程,真人客服標籤可讓業務代表在 7 天內手動回覆用戶的訊息。
訊息標籤不得用於傳送促銷內容,包括但不限於:交易、優惠、優惠券和折扣。若在核准的使用案例之外使用訊息標籤,可能會導致粉絲專頁或 Instagram 帳號傳送訊息的功能受到限制。如需詳細資訊,請參閱 Messenger 開放平台和 Instagram 訊息 API 政策 。
使用 Messenger 開放平台的商家若想在 24 小時標準訊息期限之外傳送促銷訊息,應使用贊助訊息或一次性通知。
您傳送的訊息可能包含以下內容類型:
|
|
|
若要傳送基本文字訊息給向粉絲專頁傳送訊息的用戶,請向 /PAGE-ID/messages
端點傳送 POST
要求,並將 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/LATEST-API-VERSION/PAGE-ID/messages?access_token=PAGE-ACCESS-TOKEN"
成功後,應用程式將收到以下 JSON 回應,其中包含收件人的編號和訊息編號。
{ "recipient_id": "PAGE-SCOPED-ID", "message_id": "AG5Hz2U..." }
若要傳送附加影音素材(例如 GIF、圖像或範本)的訊息,請將內容新增至 JSON 訊息附件物件中的 API 要求。
若要傳送附加圖像的訊息給向粉絲專頁傳送訊息的用戶,請向 /PAGE-ID/messages
端點傳送 POST
要求,並將 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/v19.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 專業帳號發佈訪客貼文時,私密回覆允許您向其傳送訊息。私密回覆只能是單一訊息,該訊息將自動包含指向貼文或留言的連結,且必須在用戶發佈貼文或留言後七天內傳送。
行銷訊息允許您於標準訊息期限結束後,向用戶要求傳送多則行銷訊息的權限。如果用戶接受此要求而接收這些通知,您將能夠向其傳送自動定期的促銷訊息,其中包含即將推出的銷售活動或產品發佈和更新的相關資訊。
贊助訊息允許您於標準訊息期限到期後,向之前傳送訊息到您粉絲專頁或 Instagram 專業帳號的用戶傳送促銷或非促銷內容。贊助訊息會在對話中顯示為一般訊息,但訊息上方會附註有「贊助」字樣。贊助訊息內容必須遵守廣告刊登政策。
贊助訊息不適用於 Instagram 傳訊 API。
深入瞭解使用 Messenger 平台傳送訊息。