傳送訊息

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

2024 年 7 月 23 日，我們推出了設有 Instagram 登入功能的全新 Instagram API。Instagram 專業帳戶是指商業帳戶或創作者帳戶。這類帳戶將不再需要與 Facebook 專頁連結，即可與顧客、追蹤者或對其業務或 Instagram 帳戶感興趣的 Instagram 用戶展開對話，還可以管理留言或發佈影音內容。如需進一步了解此新版本，請瀏覽我們的網誌文章。

詳情請參閱《設有 Instagram 登入功能的 Instagram API》。

向用戶披露自動化體驗

如有適用法律規定，自動化聊天室體驗必須披露用戶正在與自動化服務互動，具體時機如下：

開始任何對話或訊息串之時，
互動暫停一段長時間之後；或
聊天由真人互動轉換為自動化體驗之時。

為下列群體服務的自動化聊天室體驗應特別注意這項規定：

加州市場或加州用戶
德國市場或德國用戶

披露聲明可能包含但不限於：「我是 [專頁名稱] 機械人程式」、「你的互動對象是自動化體驗」、「你的交談對象是機械人程式」或「我是自動化聊天室機械人程式」。

即使法律沒有要求，我們亦建議您最好在用戶與自動化聊天室互動時告知他們，因為這有助管理用戶在與您的訊息功能體驗互動時的期望。

詳情請參閱開發人員政策。

訊息組成元素

來自您應用程式的所有 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 小時標準通訊期限以外的時間傳送推廣訊息，則應使用贊助訊息或一次性通知。

內容類型

您傳送的訊息可能包含以下內容類型：

音訊
按鈕
檔案

選單
GIF
圖像

範本
文字
影片

傳送基本文字

若要傳送基本文字訊息給向您專頁傳送了訊息的用戶，請傳送 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/v24.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/v24.0/me/messages?access_token={PAGE_ACCESS_TOKEN}"

成功的話，您的應用程式就會收到以下 JSON 回應，以及傳送對象編號和訊息編號。

{
  "recipient_id": "PAGE-SCOPED-ID",
  "message_id": "AG5Hz2U..."
}

從網址傳送音訊、影片或檔案應使用相同格式。

您還可以從伺服器或使用之前已上載至 Meta 伺服器的內容傳送媒體。進一步了解如何使用附件上載 API 上載檔案。

傳送多個媒體附件

若要傳送附有多張圖像的訊息，請在 JSON 訊息附件陣列內的 API 要求加入內容。媒體類型僅限圖像，且一次最多 30 張。

若要傳送附有多張圖像的訊息給向您專頁傳送了訊息的用戶，請傳送 POST 要求至 /PAGE-ID/messages 端點，其中 recipient 物件常值鍵 id 設為用戶的專頁範圍編號（PSID），message_type 參數設為 RESPONSE，message 參數包含 attachments 陣列，其中各附件物件 type 鍵設為 image，payload 物件 url 鍵設為圖片網址。

要求範例

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient": {
    "id": "1254459154682919"
  },
  "message": {
    "attachments": [
      {
        "type": "image",
        "payload": {
          "url": "http://www.messenger-rocks.com/image.jpg"
        }
      },
      {
        "type": "image",
        "payload": {
          "url": "http://www.messenger-rocks.com/image.jpg"
        }
      }
    ]
  }
}' "https://graph.facebook.com/v24.0/me/messages?access_token={PAGE_ACCESS_TOKEN}"

成功的話，您的應用程式就會收到以下 JSON 回應，以及傳送對象編號和訊息編號。

{
  "recipient_id": "PAGE-SCOPED-ID",
  "message_id": "AG5Hz2U..."
}

回覆訊息

如要回覆之前的某則特定聊天室訊息，請傳送 POST 要求至 /PAGE-ID/messages，並採用以下設定：

recipient 物件常值鍵 id 設為用戶的專頁範圍編號（PSID）
message_type 設為 RESPONSE
訊息參數物件中的訊息詳情
reply_to 物件常值鍵 mid 設為您想回覆的特定聊天室訊息之編號

該訊息可由您的專頁或用戶傳送。

要求範例

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient": {
    "id": "{PSID}",
  }
  "messaging_type": "RESPONSE"
  "message": {
    "text": "Hello, world!"      
  },
  "reply_to": {
    "mid": "{MESSAGE_ID}"
  }
}' "https://graph.facebook.com/v23.0/{PAGE-ID}/messages?access_token={PAGE_ACCESS_TOKEN}"

成功的話，您的應用程式就會收到以下 JSON 回應，以及傳送對象編號和訊息編號。

{
  "recipient_id": "PAGE-SCOPED-ID",
  "message_id": "AG5Hz2U…"
}

最佳操作實例

文字訊息

保持言簡意賅。請考慮螢幕的大小與捲動行為；簡短的訊息比較易讀和易懂。請嘗試分別傳送幾個訊息，避免一下子傳送一則「千字文」。

請勿以文字取代圖像、表格、圖表與圖像。結構化訊息（甚至網頁檢視）都能更好地滿足您的需求。

請勿撰寫冗長的訊息。如要說明多個項目，請嘗試分別傳送幾個訊息，避免一下子傳送一則「千字文」。

附件

謹記品質為上。使用高解像度的彩色圖像，讓您的訊息更加突出。

注意長闊比例。查看圖像在訊息聊天泡泡中出現的裁剪版本。

請勿在圖像中加入大量文字。請改用文字訊息，或使用通用範本來結合圖像與文字。

後續步驟

進一步了解您可新增至對話訊息的元件。

了解詳情

進一步了解如何使用 Messenger 平台傳送訊息。

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

開發人員支援

使用 Meta 狀態工具以查看 Meta 商業產品的狀態和中斷情況。
使用 Meta 開發人員支援工具以回報錯誤、查看所回報的錯誤、獲取有關廣告或企業管理平台的幫助等。
瀏覽 Messenger 平台支援資源以查看 Messenger 平台的更多支援資源。

傳送訊息

向用戶披露自動化體驗

訊息組成元素

標準訊息時限

傳送對象編號

訊息類型

訊息標籤

內容類型

傳送基本文字

要求範例

傳送媒體附件

要求範例

傳送多個媒體附件

要求範例

回覆訊息

要求範例

最佳操作實例

文字訊息

附件

其他訊息類型

營銷訊息

新聞訊息功能（開發中）

一次性通知

私人回覆

贊助訊息

工具訊息

後續步驟

了解詳情

開發人員支援