如何將 Instagram 帳戶連接至 API 或 AI 代理
Instagram 帳戶透過 Instagram 登入連接至 API 或 AI 代理。帳戶擁有人以專業帳戶(Business 或 Creator)登入,並批准應用程式的五項權限,涵蓋基本存取、發佈、留言、訊息及洞察數據;應用程式隨後取得有效期 60 天的存取權杖,可再續期 60 天。若要使用私訊功能,帳戶還須在 Instagram 應用程式中開啟「允許存取訊息」。
easyCoexistence 只需一次 Instagram 自身的登入,即可連接 Instagram Business 或 Creator 帳戶,並持續更新其存取權,每 6 小時檢查一次,讓 Claude、ChatGPT 或您自己的平台能透過 Meta 官方 API 發佈、排程、回覆留言及私訊,並讀取洞察數據。
Meta 為 Instagram 產品列出的權限:instagram_business_basic、content_publish、manage_comments、manage_insights 及 manage_messages。
Instagram 登入所得授權碼的有效期;該碼只能兌換一次。
長期 Instagram 用戶存取權杖的有效期,可再續期 60 天。
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 應用程式中,開啟「設定」,再依次進入「訊息和限時動態回覆」、「訊息控制」及「已連接的工具」,然後開啟「允許存取訊息」。Meta 規定必須先開啟此開關,應用程式才能管理帳戶的私訊;在開關開啟前,即使已獲授予訊息權限,發送亦會失敗,而發佈及留言功能仍可照常使用。
如何連接至 easyCoexistence?
在控制台中,只需一次登入:選擇「新增連接」,然後選擇 Instagram,並以專業帳戶登入。若帳戶未設定付款卡,系統會先要求您提供,因每個連接均會收費。Instagram 完成回傳後,頻道頁面會顯示「已連接」,easyCoexistence 隨即為該帳戶訂閱其留言、提及及私訊事件,並在 60 天期限屆滿前續期存取權,且每 6 小時檢查一次。
平台如何連接其客戶的帳戶?
透過 Partner API 的託管連接連結。您的後端向 /api/v1/connect-sessions 發送 POST 請求,並將 channel 設為 instagram,同時提供 redirect_url,然後將客戶導向所回傳的 url;客戶在該頁面以 Instagram 登入,無需自行擁有 easyCoexistence 帳戶。瀏覽器攜帶工作階段、狀態及新的 channel_id 返回,您的後端應先透過 GET /connect-sessions/:id 確認,才可信任該結果。
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 帳戶:請先在該帳戶中移除。
- 連接連結在一小時後才開啟:請建立新的工作階段。
設定方法
- Make the account professionalIn the Instagram app, switch to a Business or Creator account under Account type and tools.
- Start the connectionIn the easyCoexistence dashboard, choose New connection, then Instagram.
- Approve the permissionsLog in with the professional account and approve the five permissions Instagram shows.
- Allow access to messagesTurn on Allow access to messages under Connected tools in the Instagram app, so DMs work.
- 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 設定其事件中繼。
每個連接每月由 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 監察
驗證日期