Messenger 開放平台

一次性通知（測試版）

摘要

Messenger 開放平台的一次性通知 API（測試版）允許粉絲專頁在 24 小時訊息期間結束後，要求用戶傳送一則後續追蹤訊息。用戶將可在未來接收通知。當用戶要求接收通知時，網頁會收到一個權杖，該權杖相當於向用戶傳送單一訊息的權限。權杖只能使用一次，且將在建立後 1 年內過期。




權限

有意願使用此 API 的粉絲專頁，需要在粉絲專頁設定的「進階訊息」部分中申請「一次性通知」權限。粉絲專頁需要同意測試版使用條款，若其符合我們的條件，將授予該權限。




內容

使用方式

傳送一次性通知要求

網頁可使用「傳送 API」，以範本形式傳送通知要求訊息。範本類型應為 one_time_notif_req。要求的內文應遵循所有範本類型的標準格式，其中 message.attachment.payload 屬性包含每種範本類型特定的類型和內容詳細資訊。您只能自訂要求的標題和承載。title 欄位字元數上限為 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/v19.0/me/messages?access_token=<PAGE_ACCESS_TOKEN>"

若要傳送內容豐富的訊息，請將文字更換為多種格式的內容。請參閱傳送 API 參考資料，取得完整的支援訊息類型清單。one_time_notif_token 只能使用一次，且將在訊息傳送成功後失效。

Webhook 事件

當用戶同意接收特定的更新時，您將取得包含 payload 和 one_time_notif_token 的 Webhook 事件。您需要同時儲存承載和權杖，以便在資訊可用時傳送後續追蹤訊息。請注意，並沒有單獨的 API 可查詢 one_time_notif_token 清單，因此在接收 Webhook 資訊時，處理和儲存該資訊非常重要。每個權杖只能使用一次，且將在建立後 1 年內過期。

{
   "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>",
   }
}

限制

  • 請勿使用承載欄位傳送密碼、用戶憑證、可識別用戶的私人資訊（即可用於自行聯繫用戶或識別其身分的名稱或電子郵件地址等資訊），或其他敏感資訊（例如健康、財務、付款或持卡人資料，或根據適用法律定義為敏感資料的其他資訊類別）。
  • 一次性通知要求的數量受限速規範，以避免產生不良的用戶體驗。

常見問題

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

開發人員支援