傳送訊息

若要在 Messenger 或 Instagram 上傳送訊息給用戶，必須由該用戶起始對話。Messenger 平台具有多種不同的訊息類型可供您傳送。每種訊息類型對於可傳送的內容類型，以及在何種情況下可以傳送，各有不同的政策和守則。

訊息元件

所有用於傳送訊息的應用程式傳送 API 要求皆必須包含下列項目：

• Facebook 粉絲專頁或與 Instagram 專業帳號連結之 Facebook 粉絲專頁的粉絲專頁編號，用於傳送訊息
• 接收訊息之用戶的編號
• 傳送訊息之粉絲專頁所要求的粉絲專頁存取權杖
• 接收訊息之用戶的權限
• 訊息類型
• 訊息內容

如需有關訊息元件的詳細資訊，請瀏覽傳送 API 參考資料。

標準訊息期限

標準訊息期限是允許您向用戶傳送訊息的 24 小時時段期間。當用戶傳送訊息到您的粉絲專頁或 Instagram 專業帳號，或透過網頁外掛程式開始對話，您的應用程式最多有 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 小時標準訊息期限之外傳送促銷訊息，應使用贊助訊息或一次性通知。

內容類型

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

傳送基本文字

若要傳送基本文字訊息給向粉絲專頁傳送訊息的用戶，請向 /PAGE-ID/messages 端點傳送 POST 要求，並將 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 要求。

若要傳送附加圖像的訊息給向粉絲專頁傳送訊息的用戶，請向 /PAGE-ID/messages 端點傳送 POST 要求，並將 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 專業帳號發佈訪客貼文時，私密回覆允許您向其傳送訊息。私密回覆只能是單一訊息，該訊息將自動包含指向貼文或留言的連結，且必須在用戶發佈貼文或留言後七天內傳送。

行銷訊息

行銷訊息允許您於標準訊息期限結束後，向用戶要求傳送多則行銷訊息的權限。如果用戶接受此要求而接收這些通知，您將能夠向其傳送自動定期的促銷訊息，其中包含即將推出的銷售活動或產品發佈和更新的相關資訊。

贊助訊息

贊助訊息允許您於標準訊息期限到期後，向之前傳送訊息到您粉絲專頁或 Instagram 專業帳號的用戶傳送促銷或非促銷內容。贊助訊息會在對話中顯示為一般訊息，但訊息上方會附註有「贊助」字樣。贊助訊息內容必須遵守廣告刊登政策。

贊助訊息不適用於 Instagram 傳訊 API。

後續步驟

瞭解可以在對話中新增到訊息的元件。

瞭解詳情

深入瞭解使用 Messenger 平台傳送訊息。

• 附件上傳 API 參考資料 - 深入瞭解上傳和傳送影音素材。
• 傳送 API 參考資料 - 深入瞭解可傳送的所有標籤、內容和附件。
• 限速 - 瞭解使用 Messenger 平台傳送訊息的限速。