行銷訊息

本文件說明如何向用戶要求傳送行銷訊息的權限、傳送要求的具體規定和限制，以及如何建立和傳送行銷訊息權限要求。

總覽

行銷訊息允許 Facebook 粉絲專頁或 Instagram 專業帳號在標準訊息期間之外向授予您權限的用戶傳送訊息。行銷訊息允許您與對您或您的業務感興趣的用戶建立關係。

行銷訊息是新的選用高階功能，我們打算未來將針對此功能進行收費。目前，我們向透過 WhatsApp Business API 傳送訊息的企業收取費用，並聽取顧客意見回饋作為定價模式決策的參考。若免費試用有任何變更，我們將提前通知顧客和合作夥伴。

必備條件

• 使用行銷訊息或其他 Messenger 開放平台功能時，必須遵守所有適用的開發商政策

• 您只能在標準訊息期間內，向用戶發送要求，讓用戶選擇是否願意接收行銷訊息。用戶選擇接收行銷訊息的動作並不會開啟標準訊息期間

• 您的應用程式和／或所提供的訊息體驗不得收到過多來自用戶的負面意見回饋。如果我們判斷您應用程式的訊息體驗收到過多來自用戶的負面意見回饋，訊息功能可能會受到限制或遭到移除

• 您不得使用行銷訊息（包括選擇接收要求）發送垃圾訊息給用戶。這包括向相同的用戶頻繁發送重複的選擇接收要求和我們開發商政策所定義的其他類型垃圾訊息

• 您必須遵守我們針對 Messenger 開放平台和行銷訊息功能所設的限制，以維護我們為您提供的服務範圍

限制

• 您每週只能針對同一個特定標題，傳送一次選擇接收要求給同一位用戶，包括「最新消息和促銷活動」的預設值。
• 請勿重複傳送選擇接收要求給用戶。重複的選擇接收要求定義為，來自 Facebook 粉絲專頁的通知具有相同的 title，或來自 Instagram 專業帳號的通知具有相同的 title 和 image_url
• 您只能在標準訊息期間內傳送選擇接收要求
• 若用戶選擇接收行銷訊息，並不會因為這項操作而開始標準訊息期間
• 您只能看到用戶是否選擇接收行銷訊息，但看不到待處理的選擇接收要求的狀態
• 若用戶選擇停止接收行銷訊息，系統就不會再將您的通知傳送給對方，而且您會收到錯誤訊息
• 用戶可以封鎖、關閉通知，也可以檢舉您傳送的訊息
• 對於從 Instagram 專業帳號傳送的行銷訊息，通常每個用戶在 7 天內最多可以傳送 10 個不同標題的選擇接收要求。次要限制是一天內可以向每位用戶發送最多 5 個選擇接收要求。但是在傳送之前，您應該考量用戶是否可能會覺得每項選擇接收要求與他們相關且有價值。

由於我們持續努力提供最佳的用戶和商家體驗，這些要求和限制可能會有所變動。

最佳作法

您應該傳送具相關性、有價值的行銷訊息給用戶，以創造高品質的用戶體驗，作法如下：

• 您的選擇接收要求（包括標題和圖像）包含用戶可能預期會收到的行銷訊息類型，例如訂單更新、商品推薦或特定優惠

• 發送多個選擇接收要求給用戶時，每個選擇接收要求都應清楚說明用戶可以預期會收到的不同、特定類型的行銷訊息

行銷訊息應具相關性，並針對用戶可能覺得有價值的使用案例量身定做。

用戶可針對您提供的訊息體驗給予意見回饋（包括封鎖您發送的訊息），這可能會導致您使用行銷訊息時會受到限制。您應該定期檢視所發送的選擇接收要求和行銷訊息，查看是否符合上述最佳作法。

傳送訊息的頻率

適用於 2023 年 2 月 2 日之前建立的通知訊息權杖。

• 用戶選擇接收後，您可以根據用戶選擇接收時所選取的頻率，依照每日、每週或每月的頻率傳送訊息給用戶。

要求傳送行銷訊息的權限

用戶必須授予權限、選擇接收來自您 Facebook 粉絲專頁或 Instagram 專業帳號的行銷訊息。Messenger 開放平台提供多種選擇接收的方式。您可以在下列訊息體驗中建立選擇接收要求：

• Messenger 發訊廣告 – 當用戶點擊您的廣告時
• 核取方塊外掛程式 – 當用戶點擊表單中的核取方塊並提交表單時
• m.me 連結 – 當用戶點擊網站、電子郵件、社群媒體貼文等內容中的 m.me 連結時
• 私密回覆 – 當用戶發佈訪客貼文或留言至商家的 Facebook 粉絲專頁時
• QR 碼 – 當用戶掃描您放在數位和實體平面上的 QR 碼時（「m.me 連結」技術支援）
• 傳送至 Messener 外掛程式 – 當用戶使用預先定義的 CTA 按鈕或文字清單主動開始對話時

選擇接收要求範例

若要傳送行銷訊息選擇接收要求，請傳送 POST 要求至 /PAGE-ID/messages 端點，並將訊息範本類型設為 notification_messages。粉絲專頁編號為 Facebook 粉絲專頁或與 Instagram 專業帳號連結之 Facebook 粉絲專頁的編號。

注意：如果行銷訊息包含來自您的 Facebook 粉絲專頁或 Instagram 專業帳號的輪播廣告，則必須使用 title 參數。

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "id":"PSID-OR-IGSID"
  },
  "message":{
    "attachment":{
      "type":"template", 
      "payload":{
         "template_type":"notification_messages", 
         "notification_messages_timezone": "UTC",
         "title":"TITLE",
         "image_url":"IMAGE-URL",
         "payload": "ADDITIONAL-WEBHOOK-INFORMATION",
      }
    }
  }
}' "https://graph.facebook.com/LATEST-API-VERSION/PAGE-ID/messages?access_token=PAGE-ACCESS-TOKEN"

成功後，應用程式將收到以下 JSON 回應，其中包含收件人的編號和訊息編號。

{ 
        "recipient": {
          "id":"PSID-OR-IGSID",
          "message_id":"MESSAGE-ID",
}

訊息附加物件參考

必須在傳送至 /PAGE-ID/messages 端點的 POST 要求中加入 messageattachment JSON 物件，才能傳送行銷訊息選擇接收要求。

通知訊息權杖

用戶選擇接收訊息時，商家會收到 messaging_optin Webhooks 通知，內容包含通知訊息權杖，以及訊息標題、選擇接收訊息之用戶所在時區等資訊。通知訊息權杖可讓您傳送行銷訊息給用戶。

選擇接收 Webhook 通知

{
  "sender": {
    "id": "PSID",
  },
  "recipient": {
    "id": "PAGE-ID",
  },
  "timestamp": "TIMESTAMP",
  "optin": {
    "type": "notification_messages", 
      "payload": "ADDITIONAL-WEBHOOK-INFORMATION",
      "notification_messages_token": "NOTIFICATION-MESSAGES-TOKEN", 
      "notification_messages_timezone": "TIMEZONE-ID",
      "token_expiry_timestamp": "TIMESTAMP",
      "user_token_status": "TOKEN-STATUS"  
      "notification_messages_status": "MESSAGE-STATUS", 
      "title": "TITLE-FOR-THE-NOTIFICATION"
    }
}

如果用戶選擇繼續接收行銷訊息，權杖到期日會展延。用戶隨時可以選擇退出。

選擇接收後續追蹤訊息

用戶選擇接收行銷訊息後，您最多可以發送三則後續追蹤訊息。這些訊息必須在第一則後續追蹤訊息的兩分鐘內發送。第二則和第三則後續追蹤訊息不能超過 250 個字元。您可以在標準 24 小時訊息期間外發送這些後續追蹤訊息。

若要發送後續追蹤訊息，請使用包含通知訊息權杖的 recipient 物件和包含後續追蹤訊息文字的 message 物件發出 POST 要求至 /PAGE-ID/messages 端點。所有三個後續追蹤訊息的 API 要求的語法是相同的。

要求範例

curl -X POST -H "Content-Type: application/json" -d 
    '{ 
        "recipient":{ 
            "notification_messages_token":"NOTIFICATION-MESSAGE-TOKEN" 
        }, 
        "message":{ 
            "text":FOLLOWUP-MESSAGE-TEXT-HERE, 
        } 
    }' 
"https://graph.facebook.com/LATEST-API-VERSION/PAGE-ID/messages?access_token=TOKEN"

取得權杖清單

若要取得所有有效通知訊息權杖的清單，請傳送 GET 要求至 /PAGE-ID/notification_message_tokens 端點。

要求範例

curl -i -X GET "https://graph.facebook.com/API-VERSION-NUMBER/PAGE-ID/notification_message_tokens
    ?access_token=PAGE-ACCESS-TOKEN"

預設會傳回最多包含 25 個權杖的清單，並依更新時間排序。若要查看更多權杖，可以加入 limit 參數。目前最多只能傳回 100 個權杖。您可以使用 after 參數進行分頁，但不能使用 before 參數。

成功後，您的應用程式將收到以下 JSON 回應，其中包含權杖、接收者編號（Instagram 範圍編號或粉絲專頁範圍編號）、權杖建立的時間、通知的標題，以及您可以傳送下一則行銷訊息給該收件人的時間。

{
  "data":[
    {
      "notification_messages_token":"NOTIFICATION-MESSAGE-TOKEN-ID-1",
      "recipient_id":"PAGE-OR-INSTAGRAM-SCOPED-ID-1",
      "notification_messages_reoptin":"RE-OPT-IN-STATUS",
      "creation_timestamp":TIMESTAMP,
      "token_expiry_timestamp":UNIX-TIMESTAMP-EXPIRATION-DATE,
      "user_token_status":"TOKEN-STATUS",
      "topic_title":"NOTIFICATION-TITLE",
      "notification_messages_timezone":"TIMEZONE-ID",
      "next_eligible_time": TIMESTAMP
    },
...
    {
      "notification_messages_token":"NOTIFICATION-MESSAGE-TOKEN-ID-25",
      "recipient_id":"PAGE-OR-INSTAGRAM-SCOPED-ID-25",
      "notification_messages_reoptin":"RE-OPT-IN-STATUS",
      "creation_timestamp":TIMESTAMP,
      "token_expiry_timestamp":UNIX-TIMESTAMP-EXPIRATION-DATE,
      "user_token_status":"TOKEN-STATUS",
      "topic_title":"NOTIFICATION-TITLE",
      "notification_messages_timezone":"TIMEZONE-ID",
      "next_eligible_time": TIMESTAMP
    }
  ],
  "paging":{"cursors":{"before":"QVFIU...","after":"QVFIU..."},"next":"https:\/\/graph.facebook.com\/LATEST-API-VERSION\/PAGE-ID\/notification_message_tokens?access_token=PAGE-ACCESS-TOKEN"}
}

取得權杖資訊

雖然我們建議使用 messaging_optin Webhook 收集行銷訊息資訊，但若要取得權杖資訊，您可以傳送 GET 要求至權杖端點，您的權杖會附加在 notification_messages_、notification_messages_NOTIFICATION-MESSAGES-TOKEN 後面。

要求範例

curl -i -X GET "https://graph.facebook.com/LATEST-API-VERSION/notification_messages_NOTIFICATION-MESSAGES-TOKEN
    ?access_token=PAGE-ACCESS-TOKEN"

成功後，您的應用程式將收到以下 JSON 回應，其中包括通知訊息權杖、接收訊息的用戶編號，和其他權杖資訊。您將使用通知訊息權杖和收件人的編號發送行銷訊息。

{
  "notification_messages_token": "NOTIFICATION-MESSAGES-TOKEN",
  "recipient_id": "PAGE-OR-INSTAGRAM-SCOPED-ID",
  "creation_timestamp": "TIMESTAMP",
  "token_expiry_timestamp": "TIMESTAMP",
  "user_token_status": "REFRESHED",
  "notification_messages_reoptin": "ENABLED",
  "notification_messages_timezone": "TIMEZONE-ID"
  "next_eligible_time": TIMESTAMP
}

這些 API 呼叫會依應用程式的速限計算。

傳送行銷訊息

準備工作

必備資料：

• 已經選擇接收通知之用戶的通知訊息權杖
• 商家 Facebook 粉絲專頁的編號
• 向可在粉絲專頁執行 MESSAGING 任務之用戶要求的粉絲專頁存取權杖
• 使用「Facebook 登入」的 pages_messaging 權限
• 要包含在行銷訊息中的任何素材
• 應用程式的 messaging_referrals Webhook 訂閱

若要傳送行銷訊息，請傳送 POST 要求至 /PAGE-ID/messages 端點，並在訊息附件中加入收件人的 NOTIFICATION-MESSAGES-TOKEN 值和訊息資訊。

限制

• 您每天只能就每個通知訊息權杖傳送一則訊息。如果您要傳送多則訊息，請務必將後續訊息延遲 24 小時，否則您將收到錯誤。（請勿套用於選擇接收後續追蹤訊息。）

建議作法

• 強烈建議您在傳送行銷訊息時參考收件人的時區，以確保收件人在適當的時間收到訊息。

要求範例

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "notification_messages_token": "NOTIFICATION-MESSAGES-TOKEN"
  },
  "message":{
    "attachment":{
      "type":"template",
      "payload":{
        "template_type":"generic",
        "elements":[
           {
            "title":"Welcome!",
            "image_url":"https://raw.githubusercontent.com/fbsamples/original-coast-clothing/main/public/styles/male-work.jpg",
            "subtitle":"We have the right hat for everyone.",
            "default_action": {
              "type": "web_url",
              "url": "https://www.originalcoastclothing.com/",
              "webview_height_ratio": "tall"
            },
            "buttons":[
              {
                "type":"web_url",
                "url":"https://www.originalcoastclothing.com/",
                "title":"View Website"
              },{
                "type":"postback",
                "title":"Start Chatting",
                "payload":"ADDITIONAL-WEBHOOK-INFORMATION"
              }              
            ]      
          }
        ]
      }
    }
  }
}' "https://graph.facebook.com/LATEST-API-VERSION/PAGE-ID/messages?access_token=PAGE-ACCESS-TOKEN"

成功時，應用程式會收到以下回應：

{ 
  "recipient": "PAGE-OR-INSTAGRAM-SCOPED-ID",
  "message_id": "MESSAGE-ID"      
}

測試行銷訊息

您隨時可以測試行銷訊息。

準備工作

必備資料：

• 要接收通知的測試人員用戶。此用戶必須在應用程式中擁有角色。

測試選擇接收

您隨時可以按照下列步驟測試行銷訊息。

• 步驟 1：傳送包含行銷訊息選擇接收範本的訊息給測試對象。
• 步驟 2：確認測試對象點擊對話中的選擇接收訊息按鈕，例如接收 50% 折扣優惠訊息。
• 步驟 3：傳送第一則行銷訊息給測試對象
• 步驟 4：在第一則行銷訊息之後立即傳送另一則行銷訊息，並將 developer_action 參數設為 ENABLE_FOLLOWUP_MESSAGE。
• 步驟 5：傳送另一則行銷訊息給測試對象，這是您的測試訊息。

要求範例

curl -X POST "https://graph.facebook.com/LATEST-API-VERSION/PAGE-ID/notification_messages_dev_support
    ?recipient={
        "notification_messages_token": "NOTIFICATION-MESSAGES-TOKEN"
    }
    &developer_action=ENABLE_FOLLOWUP_MESSAGE
    &access_token=PAGE-ACCESS-TOKEN"

成功後，您的應用程式將收到以下 JSON 回應，其中包含 success 設定為 true。

{ "success": true }

若要測試重新選擇接收設定，請重複以上步驟，但將步驟 4 中的 developer_action 參數設為 SEND_RE_OPTIN。

後續步驟

• 選擇接收訊息 Webhooks 通知
• 請前往訊息類型總覽 ，瞭解您可以傳送的各種訊息類型。

另請參閱

• 粉絲專頁訊息參考資料 ，以取得定期訊息可用欄位的詳細資訊。
• 適用時區清單
• Messenger 開放平台錯誤代碼