Messenger 開放平台總覽

Messenger 開放平台總覽詳細介紹平台的運作方式以及成功實作平台所需的條件。

Meta 的 Messenger 是一種傳訊服務，允許商家的 Facebook 粉絲專頁或 Instagram 專業帳號回覆對您的業務或社群媒體感興趣的用戶。用戶與您帳號之間的對話必須由該用戶發起。

Messenger 開放平台可供您免費使用。

運作方式

用戶在登入 Facebook 或 Instagram 時，或者在瀏覽您的行動應用程式或網站時透過 Meta 外掛程式，傳送訊息到您的商家粉絲專頁或 Instagram 商業帳號。您的商家粉絲專頁或 Instagram 專業帳號可以使用 Messenger 開放平台來處理用戶的訊息，包括傳送自動回覆、讓線上客服人員回覆，或者自動化和真人客服的組合。

傳訊流程

當用戶傳送訊息到您的商家粉絲專頁或 Instagram 專業帳號時，系統會觸發 Webhook 並向您傳送通知，告知您的商家粉絲專頁或 Instagram 專業帳號已收到訊息。然後，您的應用程式就可以呼叫 Meta 社交關係圖來取得此對話、決定適當的回覆，並在 24 小時內向該用戶傳送回覆。開放平台允許您大規模執行此操作，並提供各種對話進入點和訊息類型。

限制

• 登入 Facebook 的用戶無法傳送訊息到您的 Instagram 專業帳號，而當用戶使用 Messenger 開放平台登入 Instagram 時，也無法傳送訊息到您的 Facebook 商家粉絲專頁或 Instagram 專業帳號粉絲專頁。
• Instagram 傳訊可用於商家的任何 Instagram 專業帳號或創作者的任何 Instagram 專業帳號

必要條件

若要成功實作 Messenger 開放平台，您需要瞭解以下元件。

存取權杖

存取權杖是一種可辨識應用程式、Facebook 粉絲專頁或用戶的隱晦字串，可讓應用程式用來安全地呼叫 Meta 社交關係圖。存取權杖提供對特定端點的臨時安全存取權限，允許商家粉絲專頁或 Instagram 專業帳號傳送和接收用戶的訊息。瞭解詳情。

進階和一般存取權限

商家粉絲專頁或 Instagram 專業帳號有兩種存取層級：一般存取權限和進階存取權限。一般存取權限是您首次向 Meta 註冊應用程式時的預設存取權限層級。一般存取權限允許您取得下列用戶的資料：在應用程式具有角色的用戶（例如開發人員、測試員或管理員），或在聲明擁有應用程式的商家粉絲專頁或 Instagram 專業帳號具有角色的用戶。進階存取權限允許您的應用程式取得下列用戶的資料：使用您的應用程式但在應用程式不具有角色的用戶，或在聲明擁有應用程式的商家粉絲專頁或 Instagram 專業帳號不具有角色的用戶。深入瞭解應用程式角色 、應用程式類型 以及一般和進階存取權限 。

由於一般存取權限的範圍有限，在您的應用程式獲得進階存取權限之前，有些功能可能無法正常運作。這可能會限制您所使用的任何測試應用程式。

應用程式審查

如果應用程式需要進階存取權限來取得下列用戶資料，您必須完成應用程式審查：在應用程式不具有角色的應用程式用戶，或在聲明擁有應用程式的商家粉絲專頁或 Instagram 專業帳號不具有角色的應用程式用戶。瞭解詳情。

如果您開發的應用程式是要為自己的頁面傳送和接收訊息，則不需要進行應用程式審查。請注意，如果您計畫擷取用戶個人檔案資訊，還是需要進行應用程式審查，以取得存取用戶個人檔案 API 所需的權限。

商家驗證

如果在應用程式不具有角色或在聲明擁有應用程式的商業帳號不具有角色的應用程式用戶將會使用您的應用程式，您必須完成商家驗證。瞭解詳情。

內容傳遞網路網址

Messenger 開放平台採用內容傳遞網路（CDN）網址，可讓您擷取 Instagram 用戶分享的各種媒體內容。CDN 網址具有隱私感知功能，當內容遭刪除或過期時，不會傳回媒體。

Facebook 登入

若要讓用戶允許您的粉絲專頁或 Instagram 專業帳號對其傳送訊息，您必須要求他們的權限。為了要求這些權限，您必須實作 Facebook 登入。瞭解詳情。

Facebook 粉絲專頁

使用 Messenger 開放平台傳送和接收訊息時，需要 Facebook 粉絲專頁。瞭解詳情。

功能

交接通訊協定

如果您有多個處理訊息的應用程式（例如，一個應用程式處理自動回覆，一個應用程式處理呈報至真人服務人員），則需要實作交接通訊協定，將對話從一個應用程式傳遞到另一個應用程式。若要讓應用程式回覆訊息，該應用程式必須控制對話，且交接通訊協定允許應用程式在需要回覆訊息時要求另一個應用程式的控制權，並在應用程式傳送回覆時釋放對話的控制權。

大量傳訊

如果您的粉絲專頁或 Instagram 專業帳號傳送或接收大量訊息，則在訊息量減少之前，收件匣將無法再顯示新訊息或傳送新訊息。

針對 Messenger 傳訊

如果粉絲專頁每秒傳送超過 40 則訊息，或是同時不斷傳送或接收具有大量對話的訊息時，新訊息將不會顯示在粉絲專頁收件匣中，且該粉絲專頁在訊息量減少之前將無法傳送新訊息。

如果粉絲專頁達到大數量的限制，用於取得所有對話的 API 呼叫將會失敗，但是您仍然可以呼叫單一對話來取得該對話的新訊息。

針對 Instagram 傳訊

如果 Instagram 專業帳號傳送和接收的訊息超過 72,000 則時，新訊息將不會顯示在 Instagram 收件匣中，且該 Instagram 專業帳號在訊息量減少之前將無法傳送新訊息。

對話中會顯示橫幅，指出已達到限制。當訊息量減少時，這些橫幅將停止顯示。

• 您的訊息可能會延遲 您的訊息可能需要比平時更長的時間才能送達，因為 [您的帳號名稱] 正在接收大量訊息。

• 您的訊息未送達 您的訊息未送達，因為 [您的帳號名稱] 正在接收大量訊息。請稍後再試。

Instagram 專業帳號

若要傳送和接收 Instagram 訊息，您必須擁有 Instagram 專業帳號。如此可讓您的應用程式使用連結至您帳號的 Facebook 粉絲專頁存取 Meta 社交關係圖端點的資料。瞭解詳情。

Instagram 範圍編號

當用戶傳送訊息到 Instagram 專業帳號時，系統會建立一個 Instagram 範圍帳號，用於代表該應用程式的用戶。此為用戶以及與其互動之 Instagram 帳號的特定編號。如此可讓 Instagram 專業帳號在多個傳訊應用程式之間對應同一用戶的互動。

Meta 註冊

您需要以開發人員身分註冊並使用 Meta 註冊您的應用程式，以呼叫 Meta 社交關係圖。瞭解詳情。

粉絲專頁範圍編號

當用戶傳送訊息到 Facebook 粉絲專頁時，系統會建立一個粉絲專頁範圍帳號，用於代表該粉絲專頁的用戶。此為用戶以及與其互動之粉絲專頁的特定編號。如此可讓粉絲專頁在多個傳訊應用程式之間對應同一用戶的互動。

粉絲專頁任務

要求粉絲專頁存取權杖的用戶必須能夠執行 MESSAGING 以傳送訊息，以及執行 MODERATE 任務以回覆與您的傳訊應用程式連結之 Facebook 粉絲專頁的留言。瞭解詳情。

合作夥伴名錄

在我們的 Meta 合作夥伴名錄 中尋找具有 Messenger 開放平台專業知識的合作夥伴。

權限

您的應用程式需要透過「Facebook 登入」要求以下權限才能進行 Messenger 對話：

• pages_show_list
• pages_manage_metadata
• pages_messaging
• pages_read_engagement
• business_management

若要存取 Instagram 傳訊功能，您還必須要求：

• instagram_basic
• instagram_manage_messages

要求 business_management 權限

要求 business_management 權限時，請在應用程式審查提交中註明以下內容：

1. 此權限將作為 pages_messaging 和 pages_show_list 權限的相依性進行要求。
2. 若是 Instagram 傳訊，請註明要求此權限作為 instagram_manage_messages 權限的相依性。
3. 在應用程式審查螢幕錄影中，清楚地顯示粉絲專頁管理員如何導覽 Facebook 登入流程、選擇頁面或 Instagram 用戶名稱，以及提供應用程式必要的權限。

在您的應用程式中，請務必通知粉絲專頁管理員，必須明確提供應用程式權限才能管理其商家資產。您需要新增 business_management 權限作為商家專用 Facebook 登入流程的一部分。

政策

若要獲得並保留存取 Meta 社交關係圖的權限，您必須遵守 Messenger 開放平台政策、Meta 開放平台使用條款和政策，以及我們的社群守則。瞭解詳情。

Bot（機器人程式）的政策需求

不同國家／地區可能對商家粉絲專頁或 Instagram 專業帳號所傳送的訊息有不同需求。請熟悉這些政策 以及我們執行的其他開放平台政策 。

限速

Webhooks

Webhooks 為即時通知，可讓您取得傳送到商家粉絲專頁或 Instagram 專業帳號的訊息資訊，而無需呼叫可能導致限速的元 Meta 社交關係圖。您需要設定 Webhooks 才能接收傳送到商家粉絲專頁或 Instagram 專業帳號的訊息通知，以避免速率限制。

後續步驟

• 設定 Webhooks - 瞭解如何接收應用程式傳送和接收之訊息的即時 HTTP 通知。

瞭解詳情

若要瞭解有關 Messenger 開放平台的詳細資訊，請觀看我們的開發人員影片 。這些影片包括演練、最佳作法、錄製的活動等。