Messenger 開放平台變更紀錄
本文件包含 Messenger 開放平台最新版本的變更紀錄。Messenger 開放平台遵循圖形 API 版本控制。
最新版本為： v21.0
相關變更紀錄
2024 年 10 月 8 日
Messenger response_feedback Webhook
當用戶透過點擊「拇指向上」／「拇指向下」／「回覆品質良好」／「回覆品質不佳」其中一個按鈕對您傳送的訊息提供意見回饋時，新的 response_feedback Webhook 事件會通知您。請前往這裡查看 Webhook 的詳細資訊。
傳送 API 限速
每個 Instagram 專業帳號現在每秒可以使用您的應用程式發出 300 次（之前為 100 次）呼叫，傳送包含文字、連結、心情和貼圖的訊息。瞭解詳情。
2024 年 6 月 23 日
啟用含有 Instagram 登入的全新 Instagram API
- Facebook 粉絲專頁不再為必要項目
- API 呼叫的主機網址為
graph.instagram.com - 此 API 的新權限：
instagram_business_basicinstagram_business_content_publishinginstagram_business_manage_commentsinstagram_business_manage_messages
- 新應用程式將在建立 Meta 應用程式時新增 Instagram 產品
- 現有應用程式可以在應用程式主控板中新增 Instagram 產品
請瀏覽我們的移轉指南，瞭解此含有 Instagram 登入的全新 Instagram API 是否適合您。
監控 Instagram 開放平台變更紀錄的變更，包括故障修復和新功能
2024 年 6 月 11 日
Messenger 訊息 Webhook
ig_reel 現在將成為訊息 Webhook 的支援附件類型。IG 連續短片附件將具有 ig_reel 類型，附件承載將包括連續短片的標題、網址和影片編號。
Instagram 訊息 Webhook
ig_reel 和 reel 現在將成為訊息 Webhook 中的支援附件類型。IG 連續短片附件將具有 ig_reel 類型，附件承載將包括連續短片的標題、網址和影片編號。FB 連續短片附件將具有 reel 類型，附件承載將包括連續短片的標題、網址和影片編號。
Messenger 對話指派：應用程式層級對話串控制權配置
使用 Messenger 對話指派的商家現在可以在個別應用程式層級配置對話串控制權接管功能。搭配預設應用程式使用的原始接管配置現已停用，系統已移轉所有的值。請前往這裡瞭解詳情。
Instagram 留言 Webhooks
適用於所有版本
當用戶在加強推廣的 Instagram 貼文或 Instagram 廣告貼文上留言時，除了會在 comments 欄位的 value 物件的 media 物件中傳回 ad_id 和 ad_title 之外，也會傳回 original_media_id。如需更多資訊，請參閱設定 Instagram 的 Webhooks。
2024 年 4 月 9 日
message_edits Webhook 事件
新的 message_edits Webhook 事件會在用戶編輯先前傳送的訊息時通知您。請前往這裡深入瞭解此 Webhook 事件。
2024 年 2 月 20 日
Messenger 訊息 Webhooks
「連續短片」現在將成為針對 Messenger 對話所傳送之訊息 Webhooks 的支援附件類型。系統將連續短片附件歸類為 reel 類型，附件承載將包括連續短片的標題、網址和影片編號。
2024 年 1 月 10 日
指令
指令是可點擊的關鍵字，用戶可以隨時呼叫指令，以在 Messenger 體驗中執行特定操作。指令是由指令本身和提示所組成，提示可讓用戶知道指令的功能為何。例如，當用戶輸入「幫我預訂12 月最後一週飛往墨西哥的航班和飯店」時，會叫用旅行社所配置的航班和飯店指令。請前往這裡瞭解詳情。
指令功能表
指令功能表是我們新推出的功能表，當您設定指令時會自動出現。如果您已經為 Messenger 體驗設定常駐功能表，則指令功能表會覆蓋該常駐功能表。請前往這裡瞭解詳情。
分享表單
現在用戶可以從 Messenger 上的商業簡介頁面分享您的傳訊體驗。這有助於讓您的 Messenger 體驗獲得口碑傳播。請前往這裡瞭解詳情。
商業簡介更新
為您的 Messenger 體驗配置指令後，這些指令會顯示在商業簡介中。用戶點擊最上方的頁面名稱，即可導覽至商業簡介，並瞭解您在 Messenger 體驗中提供的指令。
歡迎畫面更新
歡迎畫面會顯示傳訊體驗支援的指令清單，使人們可以輕鬆了解 Messenger 體驗可以執行哪些操作。請前往這裡瞭解詳情。
Messenger 應用程式審查更新
如果您開發的應用程式是要為自己的頁面傳送和接收訊息，則不需要進行應用程式審查。請注意，如果您計畫擷取用戶個人檔案資訊，還是需要進行應用程式審查，以取得存取用戶個人檔案 API 所需的權限。
2023 年 10 月 17 日
Instagram 對話指派
對話指派現在可用於 Instagram。對話指派可讓 Meta 將商家與顧客或潛在顧客之間的對話指派給您指定在對話中用來回應的應用程式。這個指派機制可讓您的商家與對方建立豐富的對話，並使對 Meta 伺服器的 API 呼叫降到最低。
自訂標籤 API 和角色 API
我們已經為在歐洲營運的商家，以及在歐洲和日本與全球商家聯繫的用戶，回復自訂標籤 API 和角色 API 存取權限。
更新 Messenger 發訊廣告和 Instagram Direct 發訊廣告的歡迎訊息流程
商家和廣告代理商現在可以輕鬆地將其 Messenger 發訊廣告和 Instagram Direct 發訊廣告連接至合作夥伴應用程式中建立的歡迎訊息，而不需使用 JSON 程式碼片段。建立 Messenger 發訊廣告和 Instagram Direct 發訊廣告時，歡迎訊息會以下拉式選單顯示在廣告管理員中。請前往這裡瞭解詳情。
2023 年 10 月 12 日
私密回覆
現在可以在 Facebook Reels 上以私密回覆進行留言。
2023 年 9 月 20 日
私密回覆
更新社團的私密回覆，並在 group_feed Webhook 中導入透過 from 欄位支援留言者資訊和透過 parent_id 支援上層內文的新欄位。您可能需要更新 Webhooks 伺服器來處理這些新欄位。
2023 年 9 月 12 日
對話指派
做為商家，您可能會使用多個第三方訊息供應商來與顧客進行不同的對話，例如開發潛在顧客、商品相關行銷優惠或顧客支援問題。對話指派可讓您定義哪些合作夥伴能夠在特定時間控制顧客對話，以便顧客取得所需的資訊。您可以在粉絲專頁設定中建立和管理訊息指派規則。
Instagram 按鈕範本
按鈕範本傳送一則簡訊時，最多可包含三個附加按鈕。此範本可用來提供選項讓訊息收件人選擇，例如對問題的預定回應或所要執行的動作。支援的按鈕類型包括 postback 和 web_url。
2023 年 9 月 12 日
對話指派
做為商家，您可能會使用多個第三方訊息供應商來與顧客進行不同的對話，例如開發潛在顧客、商品相關行銷優惠或顧客支援問題。對話指派可讓您定義哪些合作夥伴能夠在特定時間控制顧客對話，以便顧客取得所需的資訊。您可以在粉絲專頁設定中建立和管理訊息指派規則。
Instagram 按鈕範本
按鈕範本傳送一則簡訊時，最多可包含三個附加按鈕。此範本可用來提供選項讓訊息收件人選擇，例如對問題的預定回應或所要執行的動作。支援的按鈕類型包括 postback 和 web_url。
2023 年 7 月 26 日
Messenger 名單型廣告
- 即時表單訊息範本
2023 年 6 月 30 日
Messenger 名單型廣告
- Messenger 對話中的名單型廣告
- 預約按鈕
2023 年 6 月 20 日
透過 Messenger 開放平台使用 Instagram 傳訊
Instagram 傳訊現在可用於商家或創作者的任何 Instagram 專業帳號。
2023 年 6 月 15 日
Messenger 發訊廣告
通話提示
您現在可以新增通話提示，讓顧客或對您商家感興趣的人致電您的商家。
點擊訂閱廣告
您現在可以建立包含點擊訂閱流程的廣告，讓您能夠要求顧客或對您商家感興趣的人選擇接收行銷訊息。
多重應用程式指派
多重應用程式指派現在可用於 Instagram Direct 和 Messenger。
2023 年 2 月 21 日
Messenger 開放平台定期通知
選擇接收要求的標題
定期通知選擇接收要求的 title 屬性不再是必要項目。若未設定 title，該值會預設為「最新消息和促銷活動」。此變更適用於從 Facebook 粉絲專頁或 Instagram 專業帳號傳送的選擇接收要求。
2023 年 2 月 2 日
Messenger 開放平台定期通知
選擇接收要求的傳送訊息頻率
定期通知選擇接收要求的 notification_messages_frequency 屬性已停用，且不再於 GET 要求或 Webhook 通知中傳回。不過，系統仍將支援 2023 年 2 月 2 日之前針對每週或每月定期通知所建立的通知訊息權杖，並會在 Webhook 通知中傳回 notification_message_frequency。
選擇接收後續追蹤訊息
您現在可以向已選擇接收定期通知的用戶傳送最多三則後續追蹤訊息。所有三則後續追蹤訊息必須在第一則後續追蹤訊息的 2 分鐘內傳送。
通知訊息權杖
GET /PAGE-ID/notification_message_tokens 端點現在可用於 Instagram 傳訊。
通知訊息權杖端點的 next_eligible_time 屬性現已可使用。此欄位會傳回您可以使用該通知訊息權杖來傳送下一則定期通知的時間。
Messenger API for Instagram
您現在可以使用 Messenger API for Instagram 在從 Instagram 專業帳號傳送的訊息中傳送 GIF。
附件上傳 API 現在支援為 Instagram 專業帳號傳送的訊息上傳影音素材。
Instagram 對話發訊廣告（CTD）的轉介資訊現在會在訊息 Webhook 通知中傳回。
2023 年 1 月 2 日
Messenger 開放平台洞察報告
自 2023 年 3 月 31 日起，您將無法再從 Messenger 分析工具主控板下載 CVS 檔。請瀏覽傳訊洞察報告 API，瞭解如何取得這些洞察報告。
2022 年 11 月 9 日
Instagram 商家登入
Business Login for Instagram 可讓您以更輕鬆的方式，透過強制回應彈出視窗和更少的步驟來啟用仍需要配置帳號以進行 API 存取的 Instagram 用戶。
Messenger 發訊廣告、名單型廣告和 Messenger 開放平台之間的改善項目
我們透過以下方式，讓您更輕鬆地追蹤 Messenger 發訊名單型廣告：
- 標準傳訊視窗開啟時會觸發轉介或摘要事件，因此應用程式可以直接在 Messenger 中追蹤潛在顧客、將他們加入定期通知進行追加銷售，或是讓他們預約或直接致電商家。
訊息傳送事件 API
訊息傳送事件 API 支援 lead_submitted 事件。商家可以使用此事件回報 Messenger 發訊廣告的潛在顧客提交內容。這個新的訊息傳送事件是以公開測試版的方式推出。近期內將會在廣告管理員中推出分析報告功能。
常駐功能表
常駐功能表現在可用於 Instagram 傳訊。
私密回覆
Instagram 傳訊現在支援 Instagram Live 限時動態留言和廣告貼文留言的私密回覆。您可能需要更新 Webhooks 伺服器來處理這些新欄位。
定期通知
您現在可以使用 GET /PAGE-ID/notification_message_tokens 端點取得所有有效的通知訊息權杖清單。
2022 年 10 月 17 日
定期通知
應用程式編號將不再與通知訊息權杖相關聯。當用戶選擇接收定期通知時，所有與粉絲專頁連結的應用程式，現在都將收到選擇接收 Webhook 通知。
系統已新增下列訊息附件承載欄位：
image_aspect_ratio- 將圖像設定為適合選擇接收要求的水平或矩形長寬比elements- 建立適合選擇接收要求的圖像輪播廣告notification_message_tokens- 取得目前的通知訊息權杖清單notification_messages_cta_text- 自訂適合選擇接收要求的行動呼籲文字
已新增下列獲得用戶選擇接收定期通知的方式：
2022 年 10 月 3 日
已將 title 欄位新增至定期通知 Webhooks 通知。
2022 年 8 月 16 日
私密回覆
私密回覆現在可用於 Instagram Reels 的留言。
Instagram 傳訊
您現在可以在所要傳送的 Instagram 訊息中包含已上傳到 Meta 伺服器或從您的伺服器傳送的音訊和影片。
2022 年 5 月 25 日
用戶個人檔案 API 支援在圖形 API 14.0 和以上版本擷取顧客的 Instagram 用戶名稱欄位。
2022 年 5 月 19 日
Messenger API 定期通知定期通知是 Messenger API 的重大更新，可讓商家傳送增進交流互動的主動、自動訊息。定期通知可協助商家在顧客歷程的每個階段，傳遞以顧客為中心的個人化訊息。
Messenger API for Instagram 定期通知我們宣布推出 Messenger API for Instagram 定期通知測試版。開發人員可以在 7 月之前註冊測試版興趣主題清單。
Instagram 傳送 API 速限提高我們已將傳送 API 的速限提高為每個 Instagram 專業帳號每秒 100 次 API 呼叫。
ig.me 轉介參數商家可以在網站、電子郵件和產品包裝上加入 ig.me 連結，方便讓用戶在 Instagram 上開始與商家對話。我們新增的功能可讓品牌將轉介參數加入這些 ig.me 連結，以打造個人化的訊息傳送體驗。
Instagram API 新啟用流程我們宣布推出 Instagram API 的新啟用流程測試版。開發人員可以在 6 月 29 日之前註冊測試版興趣主題清單。
2022 年 4 月 19 日
- Messenger API 上的 Ice Breakers 現在支援本地化，方便商家根據用戶的語言地區設定自訂破冰問題。此 API 將推出新的格式，建議開發人員利用新的格式來設定和擷取 Ice Breakers 資訊。
- 尚未完成商家驗證的 Messenger 應用程式必須在 2022 年 7 月 19 日前完成驗證。如果屆時應用程式仍未完成商家驗證，將無法透過 Messenger 收發訊息，且這些應用程式的 pages_messaging 權限也將遭到撤銷。我們已傳送開發人員重要通知給受影響的應用程式。如果您的 Messenger 應用程式已完成商家驗證，則無須採取其他動作。
- 我們已回復 Messenger 開放平台上的已讀取訊息、已傳遞訊息和已傳達心情訊息 Webhooks，這些 Webhooks 之前不開放給歐洲的商家，以及在歐洲和日本與全球商家聯繫的用戶。
2022 年 3 月 15 日
我們已推出 Messenger API for Instagram 支援的常駐功能表，讓用戶能夠探索粉絲專頁的主要功能並與之互動。
2022 年 3 月 14 日
根據 2021 年 9 月 14 日的公告，所有 Facebook 粉絲專頁現在都將移轉為支援新的交接通訊協定行為。我們預計在 2022 年 3 月 18 日之前移轉所有粉絲專頁。如需詳細資訊，請參閱重大變更章節。以下是之前公告的主要改善項目摘要。
我們不斷致力改善交接通訊協定，此協定可協助開發人員和商家快速啟動訊息傳送體驗（即應用程式）、可在應用程式之間輕鬆傳遞對話的控制權，並藉由禁止應用程式插入進行中的對話來確保良好的用戶體驗。主要的改善項目包括專屬模式、閒置模式、可針對貼文串所有權進行細部控制的新 API，並且不需要再為應用程式指派主要或次要角色
2022 年 2 月 7 日
我們已透過 API 以及我們的第一方設定工具，啟用洽談外掛程式進入點自訂設定。這可以讓商家從一組預設設定中，選擇最符合其品牌風格的進入點圖示和標籤。如需詳細資訊，請參閱開發人員文件。
2021 年 11 月 11 日
Messenger API for Instagram 現在可用於追蹤者少於 50 萬的 Instagram 創作者帳號類型。如需詳細資訊，請參閱開發人員文件。
2021 年 10 月 20 日
- 我們已更新 Instagram 上的 Ice Breaker，可支援不同語言的多個版本。開發人員現在可以設定不同語言的破冰問題，並依據用戶的語言地區設定，提供正確的版本給用戶。如需詳細資訊，請參閱開發人員文件。
2021 年 9 月 14 日
交接通訊協定改善項目
- 我們不斷致力改善交接通訊協定，此協定可協助開發人員和企業快速啟動訊息傳送體驗（即應用程式）、可在應用程式之間輕鬆傳遞對話的控制權，並藉由禁止應用程式插入進行中的對話來確保良好的用戶體驗。主要的改善項目包括專屬模式、閒置模式、可針對貼文串所有權進行細部控制的新 API，並且不需要再為應用程式指派主要或次要角色
自訂標籤 API - 我們將針對 自訂標籤 API 進行令人期待的更新，這些更新可讓商家建立、更新和刪除標籤，並在 Facebook 粉絲專頁收件匣與商家可能用來與顧客溝通的任何其他工具之間同步標籤。
- 2021 年 10 月 1 日之後，商家若要使用自訂標籤 API，需要接受新的《粉絲專頁聯絡資料使用條款》。這些條款說明 Meta 針對商家建立的自訂標籤所制定的資料處理方式。從 10 月 1 日開始，我們將陸續要求 Facebook 粉絲專頁接受《粉絲專頁聯絡資料使用條款》。
- 圖形 API
v12.0以上版本自訂標籤 APIname欄位將更換為page_label_name。此變更將自 2021 年 12 月 14 日起對所有舊版的圖形 API 生效。開發人員應將page_label_name全面用於各種 CRUD（建立、擷取、更新、刪除）API 呼叫和 Webhooks。
歐洲和日本的 Messenger API 更新 - 我們已回復 Messenger API 中的顧客意見回饋範本，此功能之前不開放給歐洲的商家，以及在歐洲和日本與全球商家聯繫的用戶。請前往這裡瞭解詳情。
Messenger API for Instagram 更新
心情 Webhook - 我們已更新表情符號心情，以傳回新的 unicode 格式，並支援多種表情符號心情。請參閱開發人員文件，並在 2021 年 12 月 14 日之前移轉至新版本，以繼續支援表情符號心情。
用戶個人檔案 API - 我們已更新用戶個人檔案 API，以納入可在 Instagram 應用程式上公開使用的其他欄位。如需詳細資訊，請參閱開發人員文件。
Facebook 洽談外掛程式自訂 API - 我們將透過 API 啟用洽談外掛程式自訂設定。在這個新版本中，開發人員將能夠編輯目前只能透過我們第一方工具來使用的功能，包括位置、顏色、問候語、訪客模式設定等。
訊息回應 Webhook 現在會在圖形 API
v12.0中包含 Facebook 粉絲專頁收件匣的應用程式編號 - 當商家回覆 Facebook 粉絲專頁收件匣中的 Messenger 對話時，連接至粉絲專頁的其他應用程式可以接聽訊息回應 Webhook。這些應用程式將會收到附有 Facebook 粉絲專頁收件匣應用程式編號（263902037430900）的回應 Webhook。
2021 年 8 月 16 日
- Messenger API for Instagram - Messenger API for Instagram 已於 6 月開放所有開發人員使用，日後也將開放追蹤者人數介於 1 萬至 10 萬的 IG 商業帳號使用。開發人員現在可以將 Instagram 傳訊功能加入應用程式，並為 Instagram 上的所有商家打造優異的 Instagram 傳訊體驗。使用 Messenger API for Instagram 時須遵循《開發商政策》，特別是「Messenger 和 Instagram 訊息 API」下方所列的政策，同時亦須遵守收錄在技術文件中的所有指示。
2021 年 8 月 10 日
- 歐洲和日本的 Messenger API 更新 - 我們已回復 Messenger API 中的許多功能，這些功能之前不開放給歐洲的商家，以及在歐洲和日本與全球商家聯繫的用戶。請前往這裡查看所有恢復的功能清單。
2021 年 8 月 4 日
- 訊息轉介 Webhook 更新 - 我們已在 messaging_referrals Webhook 的 ads_context_data 區塊中新增 product_id，以允許應用程式取得動態廣告的產品編號。
2021 年 7 月 7 日
- Messenger API for Instagram - Messenger API for Instagram 已於 6 月開放所有開發人員使用，日後也將開放追蹤者人數介於 1 萬至 10 萬的 IG 商業帳號使用。我們正在將這項新功能的適用對象擴展至追蹤者人數介於 1000 至 1 萬的 IG 商業帳號。開發人員現在可以將 Instagram 傳訊功能加入應用程式，並為更多商家打造優異的 Instagram 傳訊體驗。使用 Messenger API for Instagram 時須遵循《開發商政策》，特別是「Messenger 和 Instagram 訊息 API」下方所列的政策，同時亦須遵守收錄在技術文件中的所有指示。
2021 年 6 月 22 日
- 一般型範本現在可用於 Instagram，可讓您傳送含有圖像、文字和按鈕的結構化訊息
2021 年 6 月 8 日
下列變更適用於 11.0 以上版本
2021 年 6 月 2 日
Messenger API for Instagram - 我們已開放 Messenger API for Instagram 供所有開發人員使用，讓品牌可以在 Instagram 上大規模提供訊息傳送體驗。開發人員現在可以將 Instagram 傳訊功能加入應用程式，並打造優異的 Instagram 傳訊體驗。開發人員可以協助商家透過不同的應用程式來運用現有的工作流程、推動更有意義的對話、提升顧客滿意度，以及增加銷售業績。請前往這裡瞭解詳情。使用 Messenger API for Instagram 時須遵循《開發商政策》，特別是「Messenger 和 Instagram 訊息 API」下方所列的政策，同時亦須遵守收錄在技術文件中的所有指示。
2021 年 4 月 13 日
- 歐洲和日本的 Messenger API 更新 - 我們已回復 Messenger API 中的許多功能，這些功能之前不開放給歐洲和日本的商家，以及在歐洲和日本與全球商家聯繫的用戶。請前往這裡查看所有已回復的功能清單。
2021 年 3 月 30 日
- 日本的 Messenger API 更新 - 為致力遵守《日本電信業務法》的法規，將有多個 Messenger API 不開放給日本的開發人員和商家，以及在日本與全球商家聯繫的用戶。這些 Messenger API 變更與我們在 12 月針對歐洲公告的變更類似。
2020 年 12 月 15 日
- Messaging 轉介 Webhook 更新 - 我們將 ads_context_data 區塊新增到 messaging_referrals Webhook，以允許應用程式取得貼文編號、廣告標題、圖片和影片網址。
2020 年 12 月 1 日
- 歐洲的 Messenger API 更新 - 為了遵守歐洲的新隱私規則，我們正在進行一些更新，這些更新將影響使用 Messenger API 的部分開發人員和商家。從 12 月 16 日開始，將有多個 Messenger API 不開放給歐洲的開發人員和商家，以及在歐洲與全球商家聯繫的用戶。