代理机构社交媒体 API:从自有软件管理客户账户
代理机构社交媒体 API 让代理机构的自有软件可以为每位客户连接、发布、回复并生成报告。借助 easyCoexistence 的 Partner API,客户的 WhatsApp 号码以及 Instagram、Facebook、TikTok、YouTube 和 LinkedIn 账户,可通过附带客户 ID 的托管链接加入代理机构的账户,一个 API 密钥即可统一排期、路由和监控所有这些账户。
连接会话接受的 external_ref 最大长度,即代理机构为客户设定的 ID,并保存在每个连接上。
客户打开托管连接链接后,该链接的有效时长。
Meta 应用在 App Review 与商家验证通过后,为其不拥有或管理的 Instagram 专业账户提供服务所需的条件。
LinkedIn Page 成员为使用 rw_organization_admin 权限所需的角色,该权限用于管理 Pages 并读取其报告数据。
代理机构通过 API 移除客户连接后,停止计费的时间点。
API 如何组织代理机构的客户?
通过您的客户 ID。在每个连接会话中以 external_ref 传入,该 ID 会保存在会话创建的每个号码和账户上,并在每个状态事件中返回。GET /channels?external_ref=client_118 可列出该客户的社交账户,加上 &channel=instagram 可限定为某一网络;GET /connections?external_ref=client_118 则列出其 WhatsApp 号码。所有客户都位于代理机构的同一账户下,使用同一个 ec_live_ 密钥,因此全部数量都计入同一个价格档。
curl "https://easycoexistence.com/api/v1/channels?external_ref=client_118" \
-H "Authorization: Bearer $EC_API_KEY"
curl "https://easycoexistence.com/api/v1/connections?external_ref=client_118" \
-H "Authorization: Bearer $EC_API_KEY"客户如何授予访问权限?
通过代理机构发送的链接。向 POST /connect-sessions 发送 channel(即网络)、客户的 external_ref,以及作为 partner_name 的代理机构名称,即可返回一个 url。客户打开该链接后,在网络方自己的授权页面登录;连接 WhatsApp 号码时,则通过 Meta 弹窗并扫描二维码,随后返回代理机构的 redirect_url。通过 Facebook 或 LinkedIn 登录一次可带入多个 Page,每个 Page 各自成为一个连接,请对照客户的需求清单逐一核对。
代理机构如何为客户发布内容?
通过代理机构自身的审批流程。代理机构的软件先保留草稿,待客户确认后,再将每篇已批准的帖子连同 publish_at 发送到 POST /channels/:id/posts,最多可提前 90 天排期。GET /channels/:id/posts 可查看单个账户的日程,带状态筛选的 GET /posts 可查看所有客户的待发内容;post.published 和 post.failed 则让客户经理了解结果。LinkedIn 帖子必须经由真人审批,代理机构的确认环节本身即可满足这一要求。
代理机构如何为客户回复评论和私信?
通过按账户路由的统一收件箱。PUT /channels/:id/webhook 为每个 Instagram 账户、Facebook Page 和 TikTok 账户设置一个目的地,每条转发的评论、提及或私信都带有 account_id,该 ID 对应到具体客户。WhatsApp 号码的消息由 Meta 发送至为其设置的 webhook_url。回复通过各网络的 API 发出,所用凭证来自 GET /channels/:id?credentials=1;代理机构团队还可通过同一账户下的 MCP 连接器,在 Claude 或 ChatGPT 中跨客户处理工作。
代理机构如何为客户生成报告?
使用各网络自身的数据分析,并以客户账户的凭证调用。Instagram 和 Facebook 数据来自 Meta 的 Graph API,TikTok 数据来自其 API for Business,YouTube 数据来自 YouTube Analytics,凭证中已包含其 base 地址,LinkedIn 数据则来自其统计端点。代理机构的报告任务会在每次运行开始时为每个账户获取最新凭证,拉取该时段的数据,并归档到客户的 external_ref 之下。
代理机构如何知道客户账户需要关注?
通过经签名的状态事件。channel.disconnected 和 connection.disconnected 携带客户的 external_ref,因此代理机构的软件可以提醒该客户的客户经理,并向客户发送新的连接链接。每个连接均获得全天候 24/7 监控,连接断开时,代理机构的所有者也会收到邮件通知。客户若在网络的设置中撤回访问权限,也会以同样方式出现。
客户离开时,API 中会发生什么?
代理机构的停用任务会按 external_ref 列出客户的连接,并对每个连接调用 DELETE /channels/:id 和 DELETE /connections/:id。这些连接的计费会在当前周期结束时停止,已移除渠道上的排期帖子将被取消,已移除社交账户的访问令牌也会被丢弃。WhatsApp 号码会一直留在 Cloud API 上,直到客户在 WhatsApp Business 应用中将其断开。
常见错误
- 在客户确认之前就将帖子加入队列。排队的帖子会在设定时间直接发布,不会再次检查,因此应将草稿保留在审批环节中,待批准后再发送。
- 将 Partner API 密钥放在客户门户的前端代码中。该密钥可访问账户上每位客户的凭证,因此应将其保留在代理机构的服务器上。
- 等待客户 YouTube 频道或 LinkedIn Page 的评论事件。easyCoexistence 两者都不会接收,因此报告或收件箱任务需通过各网络的 API 读取这些数据。
easyCoexistence 为代理机构的自有软件提供统一 API,可管理客户的 WhatsApp 号码及其 Instagram、Facebook、TikTok、YouTube 和 LinkedIn 账户,并会陆续支持更多渠道。功能包括:按客户附带标签的托管连接链接、发布队列、转发的评论和私信、用于报告的最新凭证,以及全天候 24/7 监控每个连接。每个连接每月 US$ 9 起,连接越多价格越低,最低降至 US$ 0.75,前 3 天免费试用。
常见问题
客户需要自己的 easyCoexistence 账户吗?
不需要。客户打开托管链接并登录即可,连接会加入代理机构的账户,并在那里计费和监控。
代理机构能否为客户使用不同的 API 密钥?
一个账户只有一个密钥。若要使用不同密钥,就需要不同的 easyCoexistence 账户,每个账户都从第一个价格档开始计费,因此大多数代理机构改用 external_ref 来区分客户。
客户连接时能看到代理机构的名称吗?
可以。托管页面会显示作为 partner_name 发送的名称。网络方自己的授权页面则会显示 easyCoexistence 为请求访问权限的应用。
easyCoexistence 对代理机构的收费是多少?
每个客户连接每月 US$ 9 起,代理机构增加客户时价格随之降低,最低降至 US$ 0.75,各网络收费相同,前 3 天免费试用。
继续阅读
两分钟连接您的第一个渠道。
无需等待平台审核。连接 WhatsApp、Instagram、TikTok 或其他渠道,然后让您的 AI 发布、回复或生成报告,看它如何运作。
- 免费试用 3 天
- 随时取消
- 仅使用官方 API
- 全天候 24/7 监控
验证时间