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

如何讓客戶將 Instagram 連接至您的應用程式

您的後端呼叫 easyCoexistence 的 POST /connect-sessions,將 channel 設為 instagram,然後把客戶導向回傳的 url。客戶在該頁面以 Instagram Login 登入商業或創作者帳戶。之後客戶會帶著 channel_id 返回您的 redirect_url。GET /channels/{id}?credentials=1 會回傳 graph.instagram.com 的存取權杖,讓您的應用程式能發布內容、讀取留言並回覆私訊。

100 posts

Instagram 帳戶在滾動 24 小時內可透過 API 發布的貼文數量,輪播計為一則。

JPEG

Meta 支援透過 API 發布至 Instagram 的唯一圖像格式。

24 hours

回覆他人 Instagram 私訊的標準時限,適用於大多數使用者操作;對方須先發出訊息。

1 private reply

帳戶在留言後 7 天內,透過私人回覆可向留言者發送的訊息數量。

1 hour

easyCoexistence 連接連結在會話過期前有效的時長。

客戶需要做什麼才能連接?

只需按一下按鈕。您的應用程式會建立會話,將 channel 設為 instagram,並附上 redirect_url,以及客戶的 id 作為 external_ref,然後把客戶導向其 url。託管頁面會顯示您的名稱及「以 Instagram 繼續」按鈕,點擊後在同一分頁開啟 Instagram 自家的登入頁面,因此在手機上也能使用。客戶批准存取後,會帶著 status=connected 及 channel_id 返回您的 redirect_url,您的後端再透過 GET /connect-sessions/{id} 確認。

1Your appPOST /connect-sessions with channel instagram
2Hosted pageYour name and Continue with Instagram
3Instagram LoginThe professional account approves access
4Back to youredirect_url with status and channel_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 天預約。

A carousel on the customer's Instagram account
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 完成這項設定

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 監察

驗證日期