登录开始免费试用
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 用户访问令牌,同时可从 GET /channels/{id}?credentials=1 获取 account_id_on_meta(即该账户的 Instagram ID)。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" }
    ]
  }'

评论和私信如何传送至您的应用?

设置目标地址后即可。使用您的 URL 调用 PUT /channels/{id}/webhook,将返回该账户的签名密钥。此后,其评论、提及和私信会在到达时被转发,并使用 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}。它会在网络层撤销访问权限,并取消仍在队列中等待的帖子,计费将于当前周期结束时停止。

常见错误

  • 向 Instagram 发送 PNG 或 WebP 图片。Meta 仅支持发布 JPEG,因此帖子会在入队前被拒绝。请先转换图片格式。
  • 在 Instagram 帖子中填写链接字段。Instagram 帖子不含链接,请求会被拒绝。请将 URL 写入正文。
  • 对超过 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 时间,队列便会在该时间发布。

easyCoexistence 每个 Instagram 账户收费多少?

每个已连接账户每月 US$ 9 起,按您连接总数所在的档位计费,最低降至 US$ 0.75,前 3 天免费试用。

继续阅读

两分钟连接您的第一个渠道。

无需等待平台审核。连接 WhatsApp、Instagram、TikTok 或其他渠道,然后让您的 AI 发布、回复或生成报告,看它如何运作。

  • 免费试用 3 天
  • 随时取消
  • 仅使用官方 API
  • 全天候 24/7 监控

验证时间