傳送訊息

若要在 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/v25.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/v25.0/me/messages?access_token={PAGE_ACCESS_TOKEN}"
  

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

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

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

您還可以從您的伺服器或之前上傳到 Meta 伺服器的內容傳送影音素材。深入瞭解如何使用附件上傳 API。

傳送多個影音素材附件

若要傳送附加多個圖像的訊息，請將內容新增至 JSON 訊息附件陣列中的 API 要求。唯一允許的影音素材類型是圖像，而且一次只能使用 30 個圖像。

若要傳送附加多個圖像的訊息給向粉絲專頁傳送訊息的用戶，請向 /PAGE-ID/messages 端點傳送 POST 要求，並將 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/v25.0/me/messages?access_token={PAGE_ACCESS_TOKEN}"
  

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

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

傳送回覆至訊息

若要在聊天室內傳送回覆至特定過往訊息，請使用下列項目傳送 POST 要求至 /PAGE-ID/messages：

• recipient object literal key id 設定為用戶的粉絲專頁範圍編號（PSID）
• message_type 設定為 RESPONSE
• 訊息參數物件中的訊息詳細資料
• reply_to object literal key 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…"
} 

最佳作法

文字訊息

• 力求簡短。考量螢幕大小和捲動行為；簡潔的訊息比較容易讓人理解。嘗試分開傳送數則訊息，而不要傳送一則冗長訊息。
• 不要以文字替代圖像、表格和圖表。結構化訊息，甚至網頁檢視，或許更能滿足您的需求。
• 請勿長篇大論。如果您需要傳達多項資訊，請嘗試分開傳送數則訊息，而不要傳送一則冗長訊息。

附件

• 重視品質。使用高解析度的彩色圖像，讓您的訊息更為顯眼。
• 考慮長寬比。檢查圖像顯示在訊息聊天泡泡中是否會遭到裁切。
• 請勿在圖像中置入大量文字。改用文字訊息，或以一般範本結合圖像和文字。

更多訊息類型

行銷訊息

行銷訊息可讓您在標準訊息期限結束後，向用戶索取傳送多則行銷訊息的權限。如果用戶接受這項接收這些通知的要求，您就能向其傳送定期的自動促銷訊息，在訊息中提供即將推出的銷售活動或產品發佈和更新等資訊。

新聞訊息（開發中）

新聞訊息僅適用於已註冊 Facebook 新聞粉絲專頁索引（NPI）的新聞發佈商。新聞訊息可讓新聞發佈商向已訂閱接收這類訊息的用戶傳送非促銷性質的新聞訊息。

新聞訊息不適用於 Instagram 訊息 API。

一次性通知

一次性通知可讓您在標準訊息期限結束後，向用戶索取傳送一則後續追蹤訊息的權限。如果用戶接受這項接收一次性通知的要求，您就能傳送一則有時效性且與個人相關的訊息，例如預約提醒或商品補貨提醒。

一次性通知不適用於 Instagram 訊息 API。

私密回覆

當用戶對您的貼文或廣告發佈留言，或是在您的粉絲專頁或 Instagram 專業帳號發佈訪客貼文，私密回覆可讓您傳送訊息給對方。私密回覆只能是單一訊息，該訊息會自動包含貼文或留言的連結，且須在用戶發佈貼文或留言後七天內傳送。

贊助訊息

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

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

公用訊息

公用訊息可讓您傳送預先核准的範本訊息，在訊息內提供訂單、帳號更新和預約資訊。這些訊息高度個人化，含有帳號、訂單編號、配送追蹤號碼、預約日期和時間，並且可能具有行動呼籲，讓用戶可以取消訂單、重新須約時間，以及執行其他方便與商家互動的動作。

後續步驟

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

瞭解詳情

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

• 附件上傳 API 參考資料：深入瞭解如何上傳和傳送影音素材。
• 傳送 API 參考資料：深入瞭解您能傳送的所有標籤、內容和附件。
• 限速：瞭解使用 Messenger 平台傳送訊息的頻率限制。