登入開始免費試用
easyCoexistence 官方 API

如何將 Instagram 帳戶連接至 API 或 AI 代理

Instagram 帳戶透過 Instagram 登入連接至 API 或 AI 代理。帳戶擁有人以專業帳戶(Business 或 Creator)登入,並批准應用程式的五項權限,涵蓋基本存取、發佈、留言、訊息及洞察數據;應用程式隨後取得有效期 60 天的存取權杖,可再續期 60 天。若要使用私訊功能,帳戶還須在 Instagram 應用程式中開啟「允許存取訊息」。

easyCoexistence 只需一次 Instagram 自身的登入,即可連接 Instagram Business 或 Creator 帳戶,並持續更新其存取權,每 6 小時檢查一次,讓 Claude、ChatGPT 或您自己的平台能透過 Meta 官方 API 發佈、排程、回覆留言及私訊,並讀取洞察數據。

5 permissions

Meta 為 Instagram 產品列出的權限:instagram_business_basic、content_publish、manage_comments、manage_insights 及 manage_messages。

1 hour

Instagram 登入所得授權碼的有效期;該碼只能兌換一次。

60 days

長期 Instagram 用戶存取權杖的有效期,可再續期 60 天。

1 hour

easyCoexistence 連接連結在工作階段過期前的有效時間。

哪些帳戶可以連接?

Instagram 專業帳戶,即 Business 或 Creator 帳戶。Meta 的 API 對兩類帳戶的發佈、留言、私訊及洞察數據功能採用相同方式處理;個人帳戶須先在 Instagram 應用程式中,於「帳戶類型和工具」下切換為專業帳戶。使用 Instagram 登入時,帳戶擁有人會在 Instagram 自己的登入頁面,以該帳戶的 Instagram 憑證登入。

帳戶擁有人登入時會看到什麼?

Instagram 自身的登入視窗。應用程式會將擁有人導向 https://www.instagram.com/oauth/authorize,並附上其 Instagram 應用程式 ID、重新導向 URI 及所請求的權限;擁有人登入、檢視權限後予以批准。隨後 Instagram 會以授權碼將擁有人帶回應用程式,該碼有效一小時且只能使用一次,應用程式伺服器再將其兌換為存取權杖。若取消登入,將返回 error=access_denied。

每項權限有何用途?

每項功能都需要 instagram_business_basic,加上各自的權限,擁有人會在同一視窗中一併批准。easyCoexistence 請求以下五項權限,即 Meta 為 Instagram 產品列出的權限組合,讓 AI 代理能夠在該帳戶上發佈、回覆及分析成效:

instagram_business_basicThe profile and media; needed with each of the others
instagram_business_content_publishPublishing photos, carousels, Reels and Stories
instagram_business_manage_commentsReading, replying to, hiding and deleting comments, private replies and mentions
instagram_business_manage_messagesReading and replying to DMs
instagram_business_manage_insightsAccount and post metrics

如何開啟私訊功能?

在 Instagram 應用程式中,開啟「設定」,再依次進入「訊息和限時動態回覆」、「訊息控制」及「已連接的工具」,然後開啟「允許存取訊息」。Meta 規定必須先開啟此開關,應用程式才能管理帳戶的私訊;在開關開啟前,即使已獲授予訊息權限,發送亦會失敗,而發佈及留言功能仍可照常使用。

如何連接至 easyCoexistence?

在控制台中,只需一次登入:選擇「新增連接」,然後選擇 Instagram,並以專業帳戶登入。若帳戶未設定付款卡,系統會先要求您提供,因每個連接均會收費。Instagram 完成回傳後,頻道頁面會顯示「已連接」,easyCoexistence 隨即為該帳戶訂閱其留言、提及及私訊事件,並在 60 天期限屆滿前續期存取權,且每 6 小時檢查一次。

1New connectionIn the easyCoexistence dashboard
2InstagramInstagram's own login window opens
3ApproveThe professional account and its five permissions
4ConnectedReady for Claude, ChatGPT or your code

平台如何連接其客戶的帳戶?

透過 Partner API 的託管連接連結。您的後端向 /api/v1/connect-sessions 發送 POST 請求,並將 channel 設為 instagram,同時提供 redirect_url,然後將客戶導向所回傳的 url;客戶在該頁面以 Instagram 登入,無需自行擁有 easyCoexistence 帳戶。瀏覽器攜帶工作階段、狀態及新的 channel_id 返回,您的後端應先透過 GET /connect-sessions/:id 確認,才可信任該結果。

Create a connect session for an Instagram account
curl -X POST https://easycoexistence.com/api/v1/connect-sessions \
  -H "Authorization: Bearer $EC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "instagram",
    "redirect_url": "https://app.example.com/connect/return",
    "external_ref": "customer_4821"
  }'

連接後會發生什麼事?

帳戶已準備就緒,可供各類工作使用。list_social_accounts 會將其返回 Claude、ChatGPT 或您自己的代理;get_social_credentials 會將其 ID 與 API 基底網址交給您的程式碼;設定後,其留言、提及及私訊事件會發送至您的端點,您可用 set_social_webhook_destination 或 PUT /api/v1/channels/:id/webhook 進行設定。

連接為何會失敗?

通常由以下四個原因之一造成,每個原因都有直接的解決方法:

  • 該帳戶為個人帳戶:請在 Instagram 應用程式中切換為 Business 或 Creator 帳戶。
  • 擁有人取消了登入:不會建立任何連接,重新開始即可開啟新視窗。
  • 該帳戶已連接至另一個 easyCoexistence 帳戶:請先在該帳戶中移除。
  • 連接連結在一小時後才開啟:請建立新的工作階段。

設定方法

  1. Make the account professionalIn the Instagram app, switch to a Business or Creator account under Account type and tools.
  2. Start the connectionIn the easyCoexistence dashboard, choose New connection, then Instagram.
  3. Approve the permissionsLog in with the professional account and approve the five permissions Instagram shows.
  4. Allow access to messagesTurn on Allow access to messages under Connected tools in the Instagram app, so DMs work.
  5. Point your AI at itAdd https://easycoexistence.com/api/mcp to Claude or ChatGPT, or call the account from your own code.

常見錯誤

  • 批准錯誤的帳戶。Instagram 的視窗會以該瀏覽器中已登入的帳戶進行登入,因此連接前請先在該處切換帳戶。
  • 僅憑重新導向的狀態便予以信任。任何人都可以在網址中輸入 status=connected,因此請由您的後端透過 GET /connect-sessions/:id 確認工作階段。
  • 在 Instagram 連接工作階段中發送 webhook_url。API 會拒絕此參數;帳戶連接後,請以 PUT /api/v1/channels/:id/webhook 設定其事件中繼。
使用 EasyCoexistence 完成這項設定

每個連接每月由 US$ 9 起,隨連接數量增加而降至 US$ 0.75,前 3 天免費試用。

常見問題

需要自己的 Meta 開發者應用程式才能連接嗎?

不需要。easyCoexistence 的 Meta 應用程式已持有 Instagram 權限,因此擁有人只需以 Instagram 登入並批准即可,無需自行建立應用程式、通過 App Review 或完成業務驗證。

Creator 帳戶可以連接嗎?

可以。Business 及 Creator 帳戶均可連接,Meta 的 API 在發佈、留言、私訊及洞察數據方面對兩者一視同仁。

可以連接多個 Instagram 帳戶嗎?

可以,每個帳戶各有其登入方式。每個帳戶即為一個連接,每月每個連接由 US$ 9 起收費,隨連接總數增加而降至 US$ 0.75。

如果該帳戶已在其他地方連接,怎麼辦?

在第一個 easyCoexistence 帳戶中仍處於連接狀態時,該帳戶無法加入第二個帳戶。這可防止任何能控制 Instagram 的人將其從付費帳戶中抽走。請先在該處移除,然後重新連接。

繼續閱讀

兩分鐘內連接您的第一個頻道。

無需等待平台審核。連接 WhatsApp、Instagram、TikTok 或其他頻道,然後請您的 AI 發佈貼文、回覆訊息或匯報數據,並看着它運作。

  • 免費試用 3 天
  • 隨時取消
  • 只用官方 API
  • 24/7 監察

驗證日期