如何讓客戶將 Instagram 連接至您的應用程式
您的後端呼叫 easyCoexistence 的 POST /connect-sessions,將 channel 設為 instagram,然後把客戶導向回傳的 url。客戶在該頁面以 Instagram Login 登入商業或創作者帳戶。之後客戶會帶著 channel_id 返回您的 redirect_url。GET /channels/{id}?credentials=1 會回傳 graph.instagram.com 的存取權杖,讓您的應用程式能發布內容、讀取留言並回覆私訊。
Instagram 帳戶在滾動 24 小時內可透過 API 發布的貼文數量,輪播計為一則。
Meta 支援透過 API 發布至 Instagram 的唯一圖像格式。
回覆他人 Instagram 私訊的標準時限,適用於大多數使用者操作;對方須先發出訊息。
帳戶在留言後 7 天內,透過私人回覆可向留言者發送的訊息數量。
easyCoexistence 連接連結在會話過期前有效的時長。
客戶需要做什麼才能連接?
只需按一下按鈕。您的應用程式會建立會話,將 channel 設為 instagram,並附上 redirect_url,以及客戶的 id 作為 external_ref,然後把客戶導向其 url。託管頁面會顯示您的名稱及「以 Instagram 繼續」按鈕,點擊後在同一分頁開啟 Instagram 自家的登入頁面,因此在手機上也能使用。客戶批准存取後,會帶著 status=connected 及 channel_id 返回您的 redirect_url,您的後端再透過 GET /connect-sessions/{id} 確認。
哪些 Instagram 帳戶可以連接?
專業帳戶,即商業帳戶或創作者帳戶,這正是 Meta 的 Instagram API 所支援的帳戶類型。若帳戶已透過另一個使用 easyCoexistence 的服務連接,系統會拒絕,會話的 last_error 會註明原因;客戶須先在該服務中移除該帳戶,或改用其他帳戶登入。若要收發私訊,帳戶還須在 Instagram 應用程式中開啟「允許存取訊息」,Instagram 連接指南會列明路徑。
您的應用程式會取得什麼權杖?
graph.instagram.com/v25.0 的 Instagram 使用者存取權杖,並附有 account_id_on_meta(即帳戶的 Instagram ID),可透過 GET /channels/{id}?credentials=1 取得。easyCoexistence 會在 60 天期限屆滿前妥善續期,而續期會發出新的權杖,因此每項工作開始時應重新取得憑證,不要只保存一份副本。
您的應用程式如何向帳戶發布內容?
使用 POST /channels/{id}/posts。ig_type 可選擇 IMAGE、CAROUSEL、REELS 或 STORIES;若省略,則會根據媒體自動判斷:多個檔案構成輪播,一段影片則構成 Reel。此處的輪播需要 2 至 10 個項目,圖像必須為 JPEG,正文最多 2,200 個字元,而 Instagram 貼文沒有連結欄位。若未提供 publish_at,內容會即時發布;若提供,則於該時間發布,最多可提前 90 天預約。
curl -X POST https://easycoexistence.com/api/v1/channels/$CHANNEL_ID/posts \
-H "Authorization: Bearer $EC_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: ig_post_2291" \
-d '{
"text": "Three looks for the weekend.",
"ig_type": "CAROUSEL",
"media": [
{ "url": "https://cdn.example.com/look-1.jpg", "type": "image" },
{ "url": "https://cdn.example.com/look-2.jpg", "type": "image" },
{ "url": "https://cdn.example.com/look-3.jpg", "type": "image" }
]
}'留言與私訊如何傳送至您的應用程式?
於您設定目的地後才會開始傳送。PUT /channels/{id}/webhook 附上您的 URL 後,會返回該帳戶的簽署密鑰,此後其留言、提及及私訊會在到達時即時轉發,並以 X-EC-Signature 簽署。傳送內容包括 platform、account_id、external_id,以及 Meta 的 Webhook entry 原文,其中留言和提及載於 changes,私訊則載於 messaging。
您的應用程式如何回覆留言與私訊?
透過 Meta 的 Instagram API(graph.instagram.com)進行,使用客戶的權杖,因此每則回覆都來自客戶的帳戶:
- 回覆留言:POST /<
IG_COMMENT_ID>/replies,並附上 message 欄位。 - 回覆私訊:POST /<
IG_ID>/messages,recipient 設為對方的 ID,並附上訊息內容,須在對方最後一則訊息發出後 24 小時內進行。 - 私人回覆留言:使用同一 messages 端點,recipient 設為
comment_id,每則留言限一次,須於留言後 7 天內進行。 - 隱藏或刪除留言:對 /<
IG_COMMENT_ID> 執行 POST 或 DELETE。
客戶的授權終止時會怎樣?
當 Instagram 拒絕權杖,或擁有人在 Instagram 設定中撤回授權時,您的事件 URL 會收到 channel.disconnected。之後為該客戶建立新的連接會話,即可重新連接該帳戶。若您想從自己這一端終止,DELETE /channels/{id} 會在網絡層面撤銷授權,並取消仍在佇列中等待的貼文,計費於該計費週期結束時停止。
常見錯誤
- 誤將 PNG 或 WebP 圖像傳送至 Instagram。Meta 只接受 JPEG 發布,因此貼文會在排入佇列前即被拒絕,請先轉換圖像。
- 在 Instagram 貼文中加入連結欄位。Instagram 貼文不設連結,因此請求會被拒絕,請將網址放入正文。
- 對超過 24 小時的私訊顯示回覆按鈕。Meta 只允許在對方最後一則訊息所開啟的時限內回覆。
- 對同一則留言發送第二次私人回覆。Meta 只允許一次,後續回覆須等對方回應後才可進行。
easyCoexistence 讓您的客戶透過一次託管登入,將 Instagram 連接至您的應用程式。之後,您的後端會取得續期後的權杖、貼文端點,以及經 Webhook 傳送的留言與私訊,且每項連接均 24/7 全天候受監控。同樣的呼叫亦適用於 WhatsApp、Facebook、TikTok、YouTube、LinkedIn 及更多頻道。每個連接每月 US$ 9 至 US$ 0.75,連接數量越多,單價越低,首 3 天免費。
常見問題
我需要自己的 Meta 應用程式,才能連接客戶的 Instagram 帳戶嗎?
不需要。客戶透過 easyCoexistence 的應用程式登入,您的後端則透過憑證呼叫取得權杖,用於 Meta 的 Instagram API。
客戶可以連接多個 Instagram 帳戶嗎?
可以,每次登入連接一個。為每個帳戶建立連接會話時使用相同的 external_ref,然後呼叫 GET /channels?external_ref= 即可列出該客戶的所有帳戶。
我的應用程式可以排程 Instagram 限時動態嗎?
可以。將 ig_type 設為 STORIES,附上一張圖像或一段影片及 publish_at 時間,佇列便會在該時間發布。
每個 Instagram 帳戶的 easyCoexistence 費用是多少?
每個已連接帳戶每月 US$ 9 至 US$ 0.75,按您全部連接數量所屬的級別計算,首 3 天免費。
繼續閱讀
兩分鐘內連接您的第一個頻道。
無需等待平台審核。連接 WhatsApp、Instagram、TikTok 或其他頻道,然後請您的 AI 發佈貼文、回覆訊息或匯報數據,並看着它運作。
- 免費試用 3 天
- 隨時取消
- 只用官方 API
- 24/7 監察
驗證日期