一次性通知（測試版）

摘要

Messenger 平台的一次性通知 API（測試版）可讓專頁在為時 24 小時的收發訊息期限結束後，要求用戶允許其傳送一則跟進訊息，屆時用戶將可選擇在未來接收一則通知。用戶要求接收通知後，專頁將會收到憑證，此憑證等同向用戶傳送單一訊息的權限。此憑證只可使用一次，並將在建立後的一年內過期。

權限

如果專頁有意使用此 API，便需要前往專頁設定的「進階訊息」區塊，以申請「一次性通知」權限。專頁需要接受測試版使用條款；如果專頁符合我們的條件，便會獲得相關權限。

內容

• 用途
• 傳送一次性通知要求
• 傳送跟進訊息
• Webhook 事件
• 限制

用途

• 不得混淆、欺騙、欺詐、誤導用戶、濫發垃圾訊息或作出非用戶預期的行為。請確保提示內容與訊息內容之間有清晰和明顯的關係。一次性通知要求和訊息的內容均須遵守《社群守則》規定。
• 如果專頁收到大量負面用戶意見，或混淆、欺騙、欺詐、誤導用戶、濫發垃圾訊息或作出非用戶預期的行為，便會喪失使用此 API 的權限。

傳送一次性通知要求

專頁可使用傳送 API，將通知要求訊息傳送為範本；範本類型應為 one_time_notif_req。要求正文應遵循所有範本類型的標準格式，其中 message.attachment.payload 屬性包含每種範本類型的專屬類型和內容詳情。您只可自訂要求的標題和裝載。name 欄位的上限為 65 個字元。

{
  "recipient": {
    "id":"

系統將會顯示一次性通知要求範本。用戶一旦點擊「通知我」按鈕，系統便會將 message_optins Webhook 傳送至您的後端，而 one_time_notif_token 則可用於在 24 小時期限以外向用戶傳送一次性跟進訊息。

傳送跟進訊息

如要傳送跟進訊息，請向傳送 API 提交 POST 要求、透過 Webhook 獲取 one_time_notif_token，並在要求正文中設定 message.text：

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient": {
    "one_time_notif_token":"<ONE_TIME_TOKEN>"
  },
  "message": {
    "text":"<MESSAGE_CONTENT>"
  }
}' "https://graph.facebook.com/v21.0/me/messages?access_token=<PAGE_ACCESS_TOKEN>"

如要傳送多樣式訊息，請以多樣式內容取代文字。請參閱傳送 API 參考資料，了解受支援訊息類型的完整清單。one_time_notif_token 只可使用一次，並會在您成功傳送訊息後失效。

Webhook 事件

當用戶同意接收關於特定更新的通知後，您將收到附有 payload 和 one_time_notif_token 的 Webhook 事件。您需要儲存好裝載和憑證，以便在取得所需資訊時傳送跟進訊息。請注意，由於我們不設用於查詢 one_time_notif_token 清單的獨立 API，因此請務必在收到 Webhook 資訊後處理和儲存相關資訊。每個憑證只可使用一次，並會在建立後的一年內過期。

{
   "sender": {
     "id":"<PSID>"
   },
   "recipient": {
     "id":"<PAGE_ID>"
   },
   "timestamp":1458692752478,
   "optin": {
     "type": "one_time_notif_req",
     "payload": "<USER_DEFINED_PAYLOAD>",
     "one_time_notif_token":"<ONE_TIME_TOKEN>",
   }
}

限制

• 請勿使用裝載欄位來傳送密碼、用戶憑證、可識別用戶身分的資訊（即姓名或電郵地址等可單獨用於聯絡用戶或識別其身分的資訊）、其他敏感資料（例如健康、財務、付款或持卡人資料）或適用法律定義為敏感資料的其他資訊類別。
• 一次性通知要求的數量受限速限制，以免造成欠佳的用戶體驗。

常見問題

您可在常見問題頁面中找到更多資訊。