Переход с Ayrshare, Zernio или Unipile на easyCoexistence: что меняется в коде
Переход с Ayrshare, Zernio или Unipile на easyCoexistence меняет четыре части вашего кода: подключение, теперь через сессию подключения на каждый аккаунт; адресацию, по channel_id или connection_id с вашим external_ref; отправку, один вызов POST /channels/:id/posts на каждый аккаунт; и события, подписанные для каждого аккаунта или присылаемые Meta напрямую вам. Каждый клиент входит ещё раз, через собственный экран согласия сети.
Заголовок, которым запрос Ayrshare направляется в User Profile, рядом с API-ключом Primary Profile в Authorization.
Срок действия ссылки привязки Ayrshare из generateJWT по умолчанию; до 2 880 минут требуется пакет Max Pack.
Статусы постов Zernio: draft, pending_approval, scheduled, publishing, published, partial, failed и cancelled.
Заголовок, который принимает API Unipile, на базовом URL вашего собственного DSN, для таких вызовов, как ссылка hosted auth.
Срок действия ссылки подключения easyCoexistence; одна ссылка завершается одним номером или одним входом через аккаунт в соцсети.
Что на что переходит?
Понятия переносятся, формы меняются. Ваш клиент, ссылка подключения аккаунта, идентификатор, по которому вы к нему обращаетесь, вызов публикации и события имеют свои аналоги. Каждая строка следует документации провайдеров, прочитанной 3 ноября 2026 г., и справочнику Partner API easyCoexistence:
| Ayrshare, Zernio or Unipile | easyCoexistence | |
|---|---|---|
| Your customer | An Ayrshare User Profile, a Zernio profile or the name on a Unipile link | external_ref on each connect session, connection and event |
| Linking | generateJWT, GET /v1/connect/{platform} or POST /api/v1/hosted/accounts/link | POST /connect-sessions, one account per link |
| Addressing | Profile-Key, profileId with accountId, or account_id | channel_id for a social account, connection_id for a number |
| Authentication | A Bearer key, with Profile-Key on Ayrshare; X-API-KEY on Unipile | Authorization: Bearer ec_live_… |
| Posting | One request with a list of platforms, on Ayrshare and Zernio | POST /channels/:id/posts, one per account |
| Incoming events | The provider's webhooks | Signed forwards per account; WhatsApp from Meta to your URL |
Что меняется при уходе с Ayrshare?
Уровень профилей исчезает. Ayrshare отправляет пост в User Profile через заголовок Profile-Key и распределяет его по списку platforms в POST /api/post, со scheduleDate в UTC и mediaUrls для файлов. В easyCoexistence ваш цикл проходит по каналам клиента: по одному вызову POST /channels/:id/posts на каждый, с publish_at с любым смещением часового пояса и медиа в виде {url, type}. Привязка переходит с generateJWT, чья ссылка по умолчанию действует 5 минут, на сессию подключения для каждого аккаунта, которая действует час.
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?
В публикации меньше, чем у остальных. POST /v1/posts у Zernio принимает content, список platforms с platform и accountId, mediaItems и scheduledFor с timezone и, как и easyCoexistence, учитывает заголовок Idempotency-Key. Список превращается в один вызов на каждый channel_id, а scheduledFor становится publish_at со смещением. У статусов Zernio draft и pending_approval нет аналогов, поэтому черновики и согласования живут в вашем продукте. Привязка переходит с GET /v1/connect/{platform} с profileId, который возвращает authUrl, на POST /connect-sessions, который возвращает url, а позже channel_id при возврате на ваш redirect.
Что меняется при уходе с Unipile?
В основном переписка. Unipile привязывает аккаунты через POST /api/v1/hosted/accounts/link на вашем DSN с X-API-KEY, отправляет через POST /api/v1/chats/{chat_id}/messages и сообщает о новых сообщениях вебхуком message_received, который включает собственные отправленные сообщения аккаунта. В easyCoexistence номер WhatsApp подключается к Cloud API Meta через Coexistence, для чего нужно приложение WhatsApp Business, а Meta доставляет его сообщения на ваш webhook_url. Ответы уходят на send_endpoint номера с токеном клиента, а личные сообщения Instagram идут через API Meta с учётными данными канала.
Должны ли клиенты переподключаться?
Да, по одному разу на аккаунт. Доступ, который дал каждый клиент, принадлежит приложению провайдера, которое его запросило, поэтому переехать к другому он не может. Каждый аккаунт входит заново по ссылке подключения, через собственный экран согласия сети или всплывающее окно Meta для номера WhatsApp. Запрашивайте, когда клиент на связи: каждая ссылка работает час, а у аккаунта может быть 50 открытых ссылок и можно создать 100 в час.
Как переключиться без простоя?
Аккаунт за аккаунтом, при параллельной работе обоих провайдеров, пока каждый клиент не переедет. Ваш код направляет каждый аккаунт к тому провайдеру, у которого он сейчас находится, а событие channel.connected или connection.connected означает момент переключения этого аккаунта:
- Сопоставьте id каждого клиента с
external_refи сохраняйте рядомchannel_idиconnection_idпо мере их поступления. - Отправляйте ссылки подключения по клиентам, начиная с аккаунтов, которые публикуют или получают больше всего.
- По channel.connected запланируйте ожидающие публикации посты этого аккаунта в easyCoexistence, а затем отмените их у старого провайдера.
- Направьте события этого аккаунта на новые приёмники, и только потом отвяжите его у старого провайдера.
Что остаётся прежним в вашем коде?
Ваш продукт. Редактор, календарь, поток согласования и входящие остаются как есть, меняется только адаптер под ними. Медиа по-прежнему идёт по публичной ссылке HTTPS, идемпотентность по-прежнему держится на заголовке, события по-прежнему проверяются через HMAC по сырому телу, а всё, что вашему коду нужно сверх обёрнутых вызовов, уходит прямо в API самой сети с учётными данными из GET /channels/:id?credentials=1.
Распространённые ошибки
- Отмена постов у старого провайдера до переподключения аккаунта. Пока не придёт channel.connected, в easyCoexistence ничего не публикуется, поэтому сначала перенесите расписание, и только потом отмените.
- Перенос клиента, у которого WhatsApp работает в обычном приложении. Coexistence подключает номера приложения WhatsApp Business, поэтому клиент переводит номер в WhatsApp Business до открытия ссылки.
- Отправка одной ссылки на все сети клиента. Ссылка завершается одним номером или одним входом, поэтому создавайте сессию на каждый аккаунт.
- Сохранение написания cancelled. easyCoexistence сообщает canceled, с одной l, поэтому обновите все сравнения статусов в коде.
easyCoexistence даёт вашему SaaS ссылки подключения, свежие учётные данные, очередь публикации и подписанные события для номеров WhatsApp ваших клиентов, а также их аккаунтов Instagram, Facebook, TikTok, YouTube и LinkedIn и другие каналы. Каждый через официальный API сети, и каждое подключение отслеживается 24/7. От US$ 9 до US$ 0,75 за подключение в месяц, с понижением по мере добавления подключений, первые 3 дня бесплатно.
Часто задаваемые вопросы
Можно ли перенести подключённые аккаунты клиентов без повторного входа?
Нет. Каждая сеть привязывает доступ к приложению, которое его запросило, поэтому каждый аккаунт входит один раз по ссылке подключения easyCoexistence.
Подключает ли easyCoexistence X, Threads или Telegram?
Пока нет. Оставьте эти аккаунты у текущего провайдера, пока остальные переезжают. Новые сети присоединятся к тому же Partner API по той же цене за подключение.
Можно ли оставить личные сообщения LinkedIn в Unipile?
Оставьте их там. easyCoexistence работает со страницами и профилями LinkedIn через посты и комментарии и не предлагает личных сообщений LinkedIn.
Сколько стоит easyCoexistence после переезда?
От US$ 9 до US$ 0,75 за подключение в месяц, одинаково для всех сетей и с понижением по мере добавления подключений, первые 3 дня бесплатно.
Читайте дальше
Подключите первый канал за две минуты.
Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.
- 3 дня бесплатно
- Отмена в любой момент
- Только официальные API
- Мониторинг 24/7
Проверено по состоянию на