傳送訊息

如要在 Messenger 或 Instagram 上傳送訊息給用戶，對話必須由該用戶發起。您可透過 Messenger 平台傳送數種不同類型的訊息。每種訊息都有不同的政策和規範來限制可傳送的內容類型，以及要傳送訊息所須符合的條件。

訊息組成元素

來自您應用程式的所有 Send API 要求都必須包含以下項目：

• 用於傳送訊息的 Facebook 專頁（無論是否連結至 Instagram 專業帳戶）之編號
• 接收訊息的用戶之編號
• 專頁存取憑證，由傳送訊息的專頁所要求
• 接收訊息的用戶給予之權限
• 訊息類型
• 訊息內容

如需進一步了解訊息組成元素，請瀏覽 Send API 參考資料。

標準訊息時限

標準訊息時限您獲允許向用戶傳送訊息的 24 小時期限。如果有人向您的專頁或 Instagram 專業帳戶傳送訊息，或是透過網絡附加程式展開對話，您的應用程式最多可在 24 小時內傳送訊息。

在 24 小時期限內傳送的訊息可以包含推廣內容。

引發 24 小時標準訊息時限的用戶動作

以下用戶動作將引發 24 小時標準訊息時限：

• 用戶向您的專頁或 Instagram 專業帳戶傳送訊息
• 用戶在對話中點擊呼籲字句按鈕，例如「開始使用」
• 用戶點擊 Messenger 發訊廣告，然後向您的專頁或 Instagram 專業帳戶傳送訊息
• 用戶透過附加程式（如傳送到 Messenger 附加程式或選框附加程式）向專頁傳送訊息
• 用戶點擊 m.me 連結，由此進入該用戶與專頁之間的現有對話
• 用戶點擊 ig.me 連結，由此進入該用戶與 Instagram 專業帳戶之間的現有對話
• 用戶對訊息表達心情，例如營銷訊息
• 用戶回應您專頁或 Instagram 專業帳戶上的帖子
• 用戶在您的專頁上發佈訪客帖子

我們知道，用戶都希望能及時收到回應。因此，我們強烈建議您在此 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/v21.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/v21.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 平台傳送訊息。

• 附件上載 API 參考資料 ：進一步了解如何上載和傳送媒體。
• Send API 參考資料 ：進一步了解您可以傳送的所有標籤、內容和附件。
• 傳輸率限制 ：進一步了解使用 Messenger 平台傳送訊息的傳輸率限制。