登录开始免费试用
easyCoexistence 官方 API

从 Ayrshare、Zernio 或 Unipile 迁移到 easyCoexistence:代码需要改哪些地方

从 Ayrshare、Zernio 或 Unipile 迁到 easyCoexistence,需要调整四个部分的代码:连接方式改为每个账户使用托管的连接会话;寻址方式改为通过 channel_id 或 connection_id 加上您的 external_ref;发帖方式改为每个账户调用一次 POST /channels/:id/posts;事件则按账户签名发送,或由 Meta 直接推送给您。每位客户都需要通过该网络自身的授权页面重新登录一次。

Profile-Key

用于将请求指向 User Profile 的请求头,与 Authorization 中的 Primary Profile API 密钥一同使用。

5 minutes

generateJWT 生成的 Ayrshare 授权链接默认有效期;延长至最多 2,880 分钟需要 Max Pack 套餐。

8 statuses

Zernio 的帖子状态包括:draft、pending_approval、scheduled、publishing、published、partial、failed 和 cancelled。

X-API-KEY

Unipile API 在您自己的 DSN 基础 URL 上接收的请求头,用于托管授权链接等调用。

1 hour

easyCoexistence 连接链接的有效时长;每个链接只完成一个号码或一次社交账号登录。

什么对应什么?

概念可以延续,但形式有所改变。您的客户、连接账户的链接、用于寻址的 ID、发帖调用和事件,都有对应项。下表依据各服务商的官方文档(于 2026 年 11 月 3 日查阅)以及 easyCoexistence Partner API 参考文档整理:

Ayrshare, Zernio or UnipileeasyCoexistence
Your customerAn Ayrshare User Profile, a Zernio profile or the name on a Unipile linkexternal_ref on each connect session, connection and event
LinkinggenerateJWT, GET /v1/connect/{platform} or POST /api/v1/hosted/accounts/linkPOST /connect-sessions, one account per link
AddressingProfile-Key, profileId with accountId, or account_idchannel_id for a social account, connection_id for a number
AuthenticationA Bearer key, with Profile-Key on Ayrshare; X-API-KEY on UnipileAuthorization: Bearer ec_live_…
PostingOne request with a list of platforms, on Ayrshare and ZernioPOST /channels/:id/posts, one per account
Incoming eventsThe provider's webhooksSigned forwards per account; WhatsApp from Meta to your URL

离开 Ayrshare 需要改动什么?

Profile 这一层不再需要。Ayrshare 通过 Profile-Key 请求头把帖子发送到 User Profile,并在 POST /api/post 中借助 platforms 列表分发到各平台,scheduleDate 使用 UTC 时间,文件则通过 mediaUrls 提供。在 easyCoexistence 上,您的流程改为遍历客户的各个频道:每个频道调用一次 POST /channels/:id/posts,publish_at 可带任意时区偏移,媒体以 {url, type} 的形式提供。授权方式也从 generateJWT 改为每个账户一个连接会话:generateJWT 的链接默认仅有效 5 分钟,连接会话则有效一小时。

Node.js: one post per channel instead of a platforms list
const EC = "https://easycoexistence.com/api/v1";
const auth = { Authorization: `Bearer ${process.env.EC_API_KEY}` };

// Before: POST https://api.ayrshare.com/api/post with Profile-Key,
// { post, platforms: ["instagram", "facebook"], mediaUrls, scheduleDate }
async function schedule(customerId, post) {
  const { data } = await fetch(`${EC}/channels?external_ref=${customerId}`, { headers: auth })
    .then((r) => r.json());
  for (const ch of data.filter((c) => post.networks.includes(c.channel) && c.status === "connected")) {
    await fetch(`${EC}/channels/${ch.id}/posts`, {
      method: "POST",
      headers: { ...auth, "Content-Type": "application/json", "Idempotency-Key": `${post.id}-${ch.id}` },
      body: JSON.stringify({
        text: post.text,
        media: post.mediaUrls.map((url) => ({ url, type: post.type })),
        publish_at: post.scheduleDate, // ISO 8601 with Z or an offset
      }),
    });
  }
}

离开 Zernio 需要改动什么?

发帖部分的改动比其他服务商少。Zernio 的 POST /v1/posts 接收 content、由 platform 和 accountId 组成的 platforms 列表、mediaItems,以及带时区的 scheduledFor,并支持 Idempotency-Key,这一点与 easyCoexistence 一致。列表会变为每个 channel_id 一次调用,scheduledFor 则变为带偏移量的 publish_at。Zernio 的 draft 和 pending_approval 状态在 easyCoexistence 中没有对应项,因此草稿和审批需要保存在您自己的产品中。授权方式从 GET /v1/connect/{platform}(传入 profileId,返回 authUrl)改为 POST /connect-sessions(返回 url,之后在您的重定向中返回 channel_id)。

离开 Unipile 需要改动什么?

主要是消息部分。Unipile 通过 DSN 上的 POST /api/v1/hosted/accounts/link 绑定账户,使用 X-API-KEY 鉴权,通过 POST /api/v1/chats/{chat_id}/messages 发送消息,并借助 message_received Webhook 上报新消息,其中也包括该账户自己发出的消息。在 easyCoexistence 上,WhatsApp 号码通过 Coexistence 接入 Meta 的 Cloud API,这需要 WhatsApp Business 应用,Meta 会把消息投递到您的 webhook_url。回复使用客户的访问令牌发送至该号码的 send_endpoint,Instagram 私信则通过 Meta 的 API 使用该频道的凭证发送。

您的客户需要重新连接吗?

需要,每个账户一次。客户授予的访问权限属于其请求时所用的服务商应用,无法转移到另一个应用。每个账户都需要通过托管的连接链接重新登录:网络账户使用其自身的授权页面,WhatsApp 号码则使用 Meta 的弹窗。请在客户在线时发出邀请:每个链接有效一小时,同一账户最多可同时保留 50 个未完成的链接,每小时最多可创建 100 个。

如何在不停机的情况下切换?

逐个账户切换,在每位客户迁移完成之前,两家服务商并行运行。您的代码将每个账户路由到当前持有该账户的服务商;收到 channel.connected 或 connection.connected 时,即为该账户切换的时机:

  • 将每位客户的 ID 映射到 external_ref,并在 channel_id 和 connection_id 返回时与之一并保存。
  • 按客户逐个发送连接链接,优先处理发帖或收件最多的账户。
  • 收到 channel.connected 后,在 easyCoexistence 上为该账户安排待发帖子,然后在旧服务商处取消这些帖子。
  • 将该账户的事件指向您的新接收端,然后在旧服务商处解除绑定。

您的代码中哪些部分保持不变?

您的产品本身。编辑器、日历、审批流程和收件箱都保持不变,只替换其下方的适配层。媒体仍通过公开的 HTTPS 链接提供,幂等性仍依赖请求头实现,事件仍基于原始请求体进行 HMAC 验证。如果代码需要超出封装调用的功能,可以直接使用 GET /channels/:id?credentials=1 获取的凭证,调用网络自身的 API。

常见错误

  • 在账户重新连接之前就在旧服务商取消帖子。在收到 channel.connected 之前,easyCoexistence 上无法发布任何内容,因此应先重新安排,再取消。
  • 迁移使用消费者版应用运行 WhatsApp 的客户。Coexistence 仅连接 WhatsApp Business 应用的号码,因此客户需要先将号码迁移到 WhatsApp Business 应用,再打开连接链接。
  • 为客户的所有网络发送同一个链接。每个链接只完成一个号码或一次登录,因此应为每个账户创建一个会话。
  • 将 cancelled 映射为相同拼写。easyCoexistence 使用 canceled(单个 l),因此请更新代码中的所有状态比较。
使用 EasyCoexistence 完成这些操作

easyCoexistence 为您的 SaaS 提供托管连接链接、最新凭证、发布队列和签名事件,适用于客户的 WhatsApp 号码,以及其 Instagram、Facebook、TikTok、YouTube 和 LinkedIn 账户,并支持更多频道。每个频道均通过各网络的官方 API 接入,每个连接全天候 24/7 监控。每个连接每月 US$ 9 至 US$ 0.75,连接越多单价越低,前 3 天免费试用。

常见问题

迁移时能否不让客户重新登录,直接转移已连接的账户?

不能。每个网络都将访问权限绑定到请求它的应用,因此每个账户都需要通过 easyCoexistence 的连接链接登录一次。

easyCoexistence 是否支持 X、Threads 或 Telegram?

目前不支持。在其他账户迁移期间,请将这些账户保留在您现有的服务商处。新网络将加入同一个 Partner API,并以相同的每连接价格计费。

能否继续使用 Unipile 的 LinkedIn 私信?

可以继续保留。easyCoexistence 通过帖子和评论支持 LinkedIn 页面与个人主页,但不提供 LinkedIn 私信。

切换后,easyCoexistence 的费用是多少?

每个连接每月 US$ 9 至 US$ 0.75,所有网络价格相同,连接越多单价越低,前 3 天免费试用。

继续阅读

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

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

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

验证时间