Przejście z Ayrshare, Zernio lub Unipile na easyCoexistence: co zmienia się w kodzie
Przejście z Ayrshare, Zernio lub Unipile na easyCoexistence zmienia cztery części kodu: łączenie, czyli hostowaną sesję połączenia dla każdego konta; adresowanie po channel_id lub connection_id z Twoim external_ref; publikowanie, czyli jedno wywołanie POST /channels/:id/posts na konto; oraz zdarzenia, podpisane osobno dla każdego konta lub wysyłane przez Meta bezpośrednio do Ciebie. Każdy klient loguje się jeszcze raz, przez własny ekran zgody danej sieci.
Nagłówek, który wysyła żądanie Ayrshare do User Profile, obok klucza API Primary Profile w Authorization.
Domyślna ważność linku do połączenia Ayrshare z generateJWT; do 2 880 minut wymaga pakietu Max Pack.
Statusy postów Zernio: draft, pending_approval, scheduled, publishing, published, partial, failed i cancelled.
Nagłówek, którego oczekuje API Unipile, przy bazowym URL będącym Twoim własnym DSN, dla wywołań takich jak hostowany link autoryzacji.
Jak długo działa link łączący easyCoexistence; jeden link kończy się jednym numerem lub jednym logowaniem w sieci społecznościowej.
Co odpowiada czemu?
Pojęcia się przenoszą, zmieniają się kształty. Klient, link łączący konto, identyfikator, po którym je adresujesz, wywołanie publikacji i zdarzenia mają swój odpowiednik. Każdy wiersz podąża za własną dokumentacją dostawcy, odczytaną 3 listopada 2026, oraz za dokumentacją referencyjną 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 |
Co się zmienia, gdy odchodzisz z Ayrshare?
Warstwa profili znika. Ayrshare wysyła post do User Profile przez nagłówek Profile-Key i rozsyła go przez listę platforms w POST /api/post, z scheduleDate w UTC i mediaUrls dla plików. W easyCoexistence pętla przechodzi po kanałach klienta: jedno POST /channels/:id/posts na każdy, z publish_at w dowolnym offsecie i mediami jako {url, type}. Łączenie przechodzi z generateJWT, którego URL działa domyślnie 5 minut, na sesję połączenia dla każdego konta, ważną godzinę.
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
}),
});
}
}Co się zmienia, gdy odchodzisz z Zernio?
W publikowaniu zmian jest najmniej spośród trzech. POST /v1/posts w Zernio przyjmuje content, listę platforms z polami platform i accountId, mediaItems oraz scheduledFor z timezone, i honoruje Idempotency-Key, tak jak easyCoexistence. Lista zamienia się w jedno wywołanie na channel_id, a scheduledFor staje się publish_at z offsetem. Statusy draft i pending_approval w Zernio nie mają odpowiednika, więc szkice i zatwierdzenia żyją w Twoim produkcie. Łączenie przechodzi z GET /v1/connect/{platform} z profileId, który zwraca authUrl, na POST /connect-sessions, który zwraca url, a później channel_id w Twoim przekierowaniu.
Co się zmienia, gdy odchodzisz z Unipile?
Przede wszystkim w wiadomościach. Unipile łączy konta przez POST /api/v1/hosted/accounts/link na Twoim DSN z nagłówkiem X-API-KEY, wysyła przez POST /api/v1/chats/{chat_id}/messages i zgłasza nowe wiadomości zdarzeniem webhook message_received, które obejmuje także wiadomości wysłane przez samo konto. W easyCoexistence numer WhatsApp dołącza do Cloud API Meta przez Coexistence, co wymaga aplikacji WhatsApp Business, a Meta dostarcza jego wiadomości do Twojego webhook_url. Odpowiedzi idą na send_endpoint numeru z tokenem klienta, a wiadomości bezpośrednie (DM) z Instagrama przez API Meta z danymi uwierzytelniającymi kanału.
Czy klienci muszą łączyć się ponownie?
Tak, raz na konto. Dostęp, jaki przyznał każdy klient, należy do aplikacji dostawcy, która o niego poprosiła, więc nie może przejść do innej. Każde konto loguje się ponownie przez hostowany link łączący, przez ekran zgody danej sieci lub wyskakujące okno Meta dla numeru WhatsApp. Proś o to, gdy klient jest pod ręką: każdy link działa godzinę, a konto może mieć 50 otwartych linków i tworzyć 100 na godzinę.
Jak przełączyć bez przestoju?
Konto po koncie, z oboma dostawcami działającymi równolegle, aż każdy klient się przeniesie. Twój kod kieruje każde konto do dostawcy, który je trzyma, a channel.connected lub connection.connected to moment przełączenia tego konta:
- Zmapuj identyfikator każdego klienta na
external_refi zapisuj obokchannel_idorazconnection_id, gdy przychodzą. - Wysyłaj linki łączące klientom, zaczynając od kont, które publikują lub odbierają najwięcej.
- Po channel.connected zaplanuj oczekujące posty tego konta w easyCoexistence, a potem anuluj je u starego dostawcy.
- Skieruj zdarzenia tego konta do nowych odbiorników, a potem odłącz je u starego dostawcy.
Co zostaje w Twoim kodzie bez zmian?
Twój produkt. Edytor postów, kalendarz, przepływ zatwierdzeń i skrzynka odbiorcza zostają takie same, zmienia się tylko adapter pod nimi. Media nadal idą przez publiczny link HTTPS, idempotencja nadal działa przez nagłówek, zdarzenia nadal weryfikuje się przez HMAC nad surową treścią żądania, a wszystko, czego Twój kod potrzebuje ponad opakowane wywołania, idzie prosto do natywnego API sieci, z danymi z GET /channels/:id?credentials=1.
Typowe błędy
- Anulowanie postów u starego dostawcy przed ponownym połączeniem konta. Dopóki nie przyjdzie channel.connected, na easyCoexistence nic nie może się opublikować, więc najpierw przeplanuj, a dopiero potem anuluj.
- Przenoszenie klienta, którego WhatsApp działa w aplikacji konsumenckiej. Coexistence łączy numery z aplikacją WhatsApp Business, więc klient najpierw przenosi numer do WhatsApp Business, a dopiero potem otwiera link.
- Wysyłanie jednego linku dla wszystkich sieci klienta. Link kończy się jednym numerem lub jednym logowaniem, więc utwórz osobną sesję dla każdego konta.
- Mapowanie statusu cancelled na tę samą pisownię. easyCoexistence zgłasza canceled, z jednym l, więc zaktualizuj każde porównanie statusu w swoim kodzie.
easyCoexistence daje Twojemu SaaS hostowane linki łączące, świeże dane uwierzytelniające, kolejkę publikacji i podpisane zdarzenia dla numerów WhatsApp klientów oraz ich kont Instagram, Facebook, TikTok, YouTube i LinkedIn, a także kolejne kanały, każdy przez oficjalne API danej sieci, z monitorowaniem każdego połączenia 24/7. Od US$ 9 do US$ 0.75 za połączenie miesięcznie, spadając wraz z dodawaniem połączeń, z bezpłatnym okresem próbnym przez 3 dni.
Najczęściej zadawane pytania
Czy mogę przenieść połączone konta klientów bez ponownego logowania?
Nie. Każda sieć wiąże dostęp z aplikacją, która o niego poprosiła, więc każde konto loguje się raz przez link łączący easyCoexistence.
Czy easyCoexistence łączy X, Threads lub Telegram?
Na razie nie. Konta w tych sieciach zostaw u obecnego dostawcy, podczas gdy reszta się przenosi. Nowe sieci dołączają do tego samego Partner API, w tej samej cenie za połączenie, w miarę jak będą dodawane.
Czy mogę zachować wiadomości LinkedIn z Unipile?
Zostaw je tam. easyCoexistence działa na stronach i profilach LinkedIn przez posty i komentarze, a nie oferuje wiadomości bezpośrednich LinkedIn.
Ile kosztuje easyCoexistence po przejściu?
Od US$ 9 do US$ 0.75 za połączenie miesięcznie, takie samo w każdej sieci i spadające wraz z dodawaniem połączeń, z bezpłatnym okresem próbnym przez 3 dni.
Czytaj dalej
Połącz pierwszy kanał w dwie minuty.
Bez czekania na weryfikację przez platformy. Połącz WhatsApp, Instagram, TikTok lub inny kanał, a potem poproś swoją AI o opublikowanie posta, odpowiedź lub raport i zobacz, jak działa.
- 3 dni za darmo
- Rezygnacja w każdej chwili
- Tylko oficjalne API
- Monitorowanie 24/7
Zweryfikowano w