ВойтиНачать бесплатный пробный период
easyCoexistence Официальные API

Переход с Ayrshare, Zernio или Unipile на easyCoexistence: что меняется в коде

Переход с Ayrshare, Zernio или Unipile на easyCoexistence меняет четыре части вашего кода: подключение, теперь через сессию подключения на каждый аккаунт; адресацию, по channel_id или connection_id с вашим external_ref; отправку, один вызов POST /channels/:id/posts на каждый аккаунт; и события, подписанные для каждого аккаунта или присылаемые Meta напрямую вам. Каждый клиент входит ещё раз, через собственный экран согласия сети.

Profile-Key

Заголовок, которым запрос Ayrshare направляется в User Profile, рядом с API-ключом Primary Profile в Authorization.

5 minutes

Срок действия ссылки привязки Ayrshare из generateJWT по умолчанию; до 2 880 минут требуется пакет Max Pack.

8 statuses

Статусы постов Zernio: draft, pending_approval, scheduled, publishing, published, partial, failed и cancelled.

X-API-KEY

Заголовок, который принимает API Unipile, на базовом URL вашего собственного DSN, для таких вызовов, как ссылка hosted auth.

1 hour

Срок действия ссылки подключения easyCoexistence; одна ссылка завершается одним номером или одним входом через аккаунт в соцсети.

Что на что переходит?

Понятия переносятся, формы меняются. Ваш клиент, ссылка подключения аккаунта, идентификатор, по которому вы к нему обращаетесь, вызов публикации и события имеют свои аналоги. Каждая строка следует документации провайдеров, прочитанной 3 ноября 2026 г., и справочнику Partner API easyCoexistence:

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?

Уровень профилей исчезает. Ayrshare отправляет пост в User Profile через заголовок Profile-Key и распределяет его по списку platforms в POST /api/post, со scheduleDate в UTC и mediaUrls для файлов. В easyCoexistence ваш цикл проходит по каналам клиента: по одному вызову POST /channels/:id/posts на каждый, с publish_at с любым смещением часового пояса и медиа в виде {url, type}. Привязка переходит с 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?

В публикации меньше, чем у остальных. 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

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 дня бесплатно.

Читайте дальше

easyCoexistence против AyrshareAyrshare берёт плату за профиль: от US$ 149 в месяц на 14 сетях. easyCoexistence: от US$ 9 до US$ 0,75 за подключение и коннектор OAuth MCP.easyCoexistence против Zernio (ранее Late)Zernio (ранее Late): плата за каждый аккаунт, первые 2 бесплатно, 16 каналов. easyCoexistence: от US$ 9 до US$ 0,75 за подключение в месяц, мониторинг 24/7.easyCoexistence против Unipile: альтернатива для AI-агентовUnipile подключает LinkedIn, WhatsApp, Instagram и почту от US$ 55 в месяц. easyCoexistence даёт AI-агентам публиковать и отвечать через официальные API.Собственная разработка или покупка интеграций с соцсетями: API Meta, TikTok, YouTube и LinkedIn для вашего SaaSЧто требует собственная интеграция Meta, TikTok, YouTube и LinkedIn: проверки доступа, обновление токенов, вебхуки и мониторинг, против партнёрского API.Как построить планировщик постов в соцсетях на API: очередь, медиа и статусыПланировщик постов на API easyCoexistence: публикация до 90 дней вперёд, копирование медиа при планировании, шесть статусов и события постов.Как дать вашим пользователям подключать аккаунты WhatsApp, Instagram и TikTok к вашему приложениюРазмещённые ссылки для подключения номеров WhatsApp и аккаунтов соцсетей: запрос сессии, перенаправление, статусы, срок действия и повторные попытки.

Подключите первый канал за две минуты.

Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.

  • 3 дня бесплатно
  • Отмена в любой момент
  • Только официальные API
  • Мониторинг 24/7

Проверено по состоянию на