Messenger 開放平台

透過 Messenger 平台使用 Instagram 傳訊

在 2024 年 7 月 23 日，我們推出了含有 Instagram 登入的 Instagram API。Instagram 專業帳號（商業或創作者帳號）不再需要連結至 Facebook 粉絲專頁，即可與顧客、粉絲或是對其商業或 Instagram 帳號感興趣的 Instagram 用戶對話、管理留言或發佈影音內容。請至我們的部落格文章深入瞭解此全新版本。

請參閱「含有 Instagram 登入的 Instagram API」瞭解詳情。

Messenger 平台允許您為大規模的 Instagram 專業帳號打造傳訊解決方案。

Instagram 傳訊適用於下列帳號：

  • 企業的任何 Instagram 專業帳號
  • 創作者的任何 Instagram 專業帳號

您可以用對話 API 檢查所管理帳號的資格。若尚未開放傳訊功能，會傳回 36103 錯誤代碼。

常見用途

  • 取得顧客傳送到 Instagram 專業收件匣的訊息
  • 接收及回應含文字、媒體、限時動態等的顧客訊息
  • 發送私人回覆給在您的 Instagram 上發佈公開貼文的用戶
  • 發送私人回覆給在您的 Instagram 貼文上發佈留言的用戶

運作方式

Messenger 開放平台允許您與對您的業務或創作感興趣的用戶進行對話。與您的 Instagram 專業帳號連結的 Facebook 粉絲專頁可用 Messenger 開放平台展開這些對話。當用戶向您的 Instagram 發送訊息時，訊息將發送到您的 Instagram 收件匣，且 Webhook 通知將發送到您的伺服器。您的傳訊應用程式有 24 小時可回應此訊息。如果需要更多時間讓真人服務人員做出回應，您可以在回應中加入標籤，以在標準 24 小時傳訊期間之外發送訊息。

Instagram 傳訊提供各種各樣的對話入口點，可讓人們啟動對話和訊息類型，以供您的傳訊應用程式回應。

Instagram 收件匣

Instagram 專業帳號有一個傳訊收件匣，可允許您控制通知並組織訊息。在預設情況下，通知為關閉狀態。您可以在「收件匣設定」中開啟通知功能。收件匣分為不同的類別：主要、一般與要求。在預設情況下，來自粉絲的全部新對話將出現在「主要」資料夾中。在實作 Instagram 傳訊之前即已存在的對話，將位於您已經將對話置於其中的資料夾中。

您從非帳號粉絲所收到的訊息將位於「要求」資料夾中。您可以選擇接受或拒絕這些要求；如果未接受，系統就不會將要求訊息標示為已讀。一旦接受要求，您就可以將對話移到「主要」或「一般」資料夾。您使用第三方應用程式回答的所有訊息要求都將移到「一般」資料夾。

收件匣限制

  • 如果您使用第三方應用程式回覆訊息，無論「設定」的配置為何，對話都會移到一般資料夾
  • 不支援收件匣資料夾，而且由 Messenger 平台傳遞的訊息不包含顯示在 Instagram 且來自 Meta 應用程式收件匣資料夾的資料夾資訊
  • 透過 API 傳遞的 Webhooks 通知或訊息在 Instagram 應用程式收件匣中將不會被視為已讀取。只有在回覆傳送後才會將訊息視為已讀取。

Business Login for Instagram

自 2022 年 11 月 9 日起，我們推出了 Business Login for Instagram 。此登入流程允許用戶將其 Instagram 帳號轉換為 Instagram 專業帳號、建立商家的 Facebook 粉絲專頁，並在登入流程中將該粉絲專頁連結至其 Instagram 專業帳號。

必備條件

本指南假設您已閱讀 Messenger 開放平台概覽並實作收發訊息和通知所需的元件。

  • Instagram 圖形 API - 此 API 允許商家和創作者使用您的應用程式管理其 Instagram 據點
  • 下列權限：
    • instagram_basic
    • instagram_manage_messages
    • pages_manage_metadata
    • pages_showlist
    • business_management
  • 在收到 Webhooks 通知後刪除訊息

自動化體驗

您可以使用以下方法之一為自動傳送訊息體驗提供提報管道：

  • 單一應用程式 - 建立自訂收件匣，以接收或回覆來自用戶的訊息。此自訂收件匣由同樣提供自動體驗的傳訊應用程式提供支援
  • 多重應用程式 - 交接通訊協定允許您將對話從一個應用程式或收件匣傳遞到另一個應用程式或收件匣。例如，一個應用程式將以自動化體驗處理對話，並在需要時將對話傳遞給另一個應用程式，以繼續與真人服務人員對話。

告知用戶您的自動化體驗

若適用法律有所規定，自動化聊天室體驗必須在以下時機告知用戶是在與自動化服務互動：

  • 在展開任何對話或訊息串時，
  • 經過很長時間後，或
  • 聊天室功能從真人互動轉換成自動化體驗時。

為以下群組服務的自動化聊天室體驗應特別注意這項要求：

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

揭露行為包括但不限於：「我是 [Page Name] 機器人」、「您正在與自動化體驗互動」、「您正在與機器人交談」，或「我是自動化聊天機器人」。

即使法律未要求，我們也建議在用戶與自動化聊天室互動時告知他們，這是最佳作法，因為這有助於管理用戶在與您的訊息體驗互動時所抱有的期望。

請前往《開發商政策》瞭解更多資訊。

僅限真人服務人員

您可以使用自訂收件匣為僅限真人服務人員的傳訊體驗提供提報管道。您的傳訊應用程式必須能：

  • 接收用戶傳送的訊息，並將其正確轉譯在自訂收件匣中
  • 透過自訂收件匣回覆訊息，並確保用戶順利收到這些訊息

限制

  • Instagram 專業帳號每次對話只能與一個顧客交談。不支援群組傳訊
  • 「要求」資料夾中已 30 天沒有活動的對話不會在 API 呼叫中傳回
  • 當顧客傳送含有分享內容的訊息時，Webhooks 通知中只會包含所分享之媒體或貼文的網址
  • 創作者的 Instagram 專業帳號必須先使用 Instagram 對話 API 傳送 API 要求，帳號才能接收 Webhooks

測試限制

  • 具有標準存取權限的應用程式只能與在應用程式中擁有角色的用戶互動
  • 在您的應用程式獲得進階存取權限之前，有些功能可能無法正常運作
  • 測試您的應用程式的用戶必須在您的應用程式上擁有角色，授予對所有必要權限的存取權限，並在 Instagram 專業帳號上擁有角色

後續步驟

  • 設定 Instagram 傳訊的 Webhooks

另請參閱