Prijavite seZapočnite besplatno probno razdoblje
easyCoexistence Službeni API-ji

Prelazak s Ayrshare, Zernio ili Unipile na easyCoexistence: što se mijenja u vašem kodu

Prelazak s Ayrshare, Zernio ili Unipile na easyCoexistence mijenja četiri dijela vašeg koda: povezivanje, sada kao hostirana sesija povezivanja za svaki račun; adresiranje, putem channel_id ili connection_id uz vaš external_ref; objavljivanje, jedan POST /channels/:id/posts po računu; i događaje, potpisane po računu ili koje vam Meta šalje izravno. Svaki korisnik se još jednom prijavljuje, kroz vlastiti zaslon za odobrenje mreže.

Profile-Key

Zaglavlje kojim Ayrshare šalje zahtjev na User Profile, uz API ključ Primary Profile u Authorization.

5 minutes

Zadano trajanje poveznice za povezivanje Ayrshare iz generateJWT; do 2.880 minuta traži njihov Max Pack.

8 statuses

Statusi objava u Zernio: draft, pending_approval, scheduled, publishing, published, partial, failed i cancelled.

X-API-KEY

Zaglavlje koje Unipile API prima, na osnovnoj adresi koja je vaš vlastiti DSN, za pozive poput hostirane poveznice za autentifikaciju.

1 hour

Koliko dugo vrijedi poveznica za povezivanje easyCoexistence; jedna poveznica završava jednim brojem ili jednom prijavom na društvenu mrežu.

Što se s čim podudara?

Pojmovi se prenose; oblici se mijenjaju. Vaš korisnik, poveznica kojom se račun povezuje, identifikator kojim ga adresirate, poziv za objavu i događaji imaju svoj ekvivalent. Svaki redak slijedi vlastitu dokumentaciju pružatelja, pročitanu 3. studenoga 2026., te referentnu dokumentaciju Partner API-ja tvrtke 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

Što se mijenja kad napustite Ayrshare?

Sloj profila nestaje. Ayrshare šalje objavu na User Profile putem zaglavlja Profile-Key i šalje je na više platformi s popisom platforms na POST /api/post, s scheduleDate u UTC-u i mediaUrls za datoteke. Na easyCoexistence vaša petlja prolazi kroz kanale korisnika: po jedan POST /channels/:id/posts za svaki, s publish_at s bilo kojim vremenskim pomakom i medijima kao {url, type}. Povezivanje se seli s generateJWT, čija poveznica traje zadano 5 minuta, na sesiju povezivanja po računu koja traje sat vremena.

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
      }),
    });
  }
}

Što se mijenja kad napustite Zernio?

Kod objavljivanja manje nego kod drugih. POST /v1/posts u Zernio uzima content, popis platforms s platform i accountId, mediaItems i scheduledFor s vremenskom zonom, te prihvaća Idempotency-Key, kao i easyCoexistence. Popis postaje jedan poziv po channel_id, a scheduledFor postaje publish_at s pomakom. Statusi draft i pending_approval u Zernio nemaju ekvivalent, pa nacrti i odobrenja ostaju u vašem proizvodu. Povezivanje se seli s GET /v1/connect/{platform} uz profileId, koji vraća authUrl, na POST /connect-sessions, koji vraća url, a kasnije channel_id na vašu adresu za preusmjeravanje.

Što se mijenja kad napustite Unipile?

Uglavnom poruke. Unipile povezuje račune putem POST /api/v1/hosted/accounts/link na vašem DSN-u uz X-API-KEY, šalje putem POST /api/v1/chats/{chat_id}/messages i javlja nove poruke webhookom message_received, koji uključuje i vlastite poslane poruke računa. Na easyCoexistence WhatsApp broj ulazi u Cloud API tvrtke Meta putem značajke Coexistence, što zahtijeva aplikaciju WhatsApp Business, a Meta svoje poruke isporučuje na vaš webhook_url. Odgovori idu na send_endpoint broja s tokenom korisnika, a Instagram DM-ovi idu putem API-ja tvrtke Meta s vjerodajnicama kanala.

Moraju li se vaši korisnici ponovno povezati?

Da, jednom po računu. Pristup koji je svaki korisnik odobrio pripada aplikaciji pružatelja koja ga je tražila, pa se ne može prenijeti u drugu. Svaki račun ponovno se prijavljuje putem hostirane poveznice za povezivanje, kroz zaslon za odobrenje same mreže ili Metin skočni prozor za WhatsApp broj. Zatražite to dok je korisnik pri ruci: svaka poveznica vrijedi sat vremena, a račun može imati 50 otvorenih poveznica i stvoriti 100 na sat.

Kako prebaciti bez prekida rada?

Račun po račun, uz oba pružatelja koja rade usporedno dok se svaki korisnik ne preseli. Vaš kod usmjerava svaki račun onom pružatelju koji ga drži, a channel.connected ili connection.connected trenutak je za prebacivanje tog računa:

  • Svaki ID korisnika preslikajte u external_ref, a uz njega spremajte channel_id i connection_id čim stignu.
  • Šaljite poveznice za povezivanje po korisniku, počevši od računa koji najviše objavljuju ili primaju poruke.
  • Na channel.connected zakažite objave tog računa koje čekaju na platformi easyCoexistence, pa ih otkažite kod starog pružatelja.
  • Događaje tog računa usmjerite na nove primatelje, pa ga odspojite kod starog pružatelja.

Što ostaje isto u vašem kodu?

Vaš proizvod. Sastavljač, kalendar, tok odobrenja i ulazna pošta ostaju kakvi jesu, mijenja se samo adapter ispod njih. Mediji i dalje idu putem javne HTTPS poveznice, idempotentnost i dalje ide preko zaglavlja, a događaji se i dalje provjeravaju HMAC-om nad neobrađenim tijelom zahtjeva. Sve što vaš kod treba izvan omotanih poziva ide izravno na API mreže uz vjerodajnice iz GET /channels/:id?credentials=1.

Uobičajene pogreške

  • Otkazivanje objava kod starog pružatelja prije nego se račun ponovno poveže. Dok ne stigne channel.connected, na platformi easyCoexistence ništa se ne može objaviti, pa prvo zakažite, a tek onda otkažite.
  • Prebacivanje korisnika čiji WhatsApp radi u potrošačkoj aplikaciji. Coexistence povezuje brojeve WhatsApp Business aplikacije, pa korisnik prije otvaranja poveznice mora broj premjestiti u WhatsApp Business aplikaciju.
  • Slanje jedne poveznice za sve mreže korisnika. Poveznica završava jednim brojem ili jednom prijavom, pa stvorite po jednu sesiju za svaki račun.
  • Pretpostavka da je cancelled isti status kao canceled. easyCoexistence javlja canceled, s jednim l, pa ažurirajte svaku usporedbu statusa u svom kodu.
Radite ovo uz EasyCoexistence

easyCoexistence vašem SaaS-u daje hostirane poveznice za povezivanje, svježe vjerodajnice, red za objavljivanje i potpisane događaje za WhatsApp brojeve vaših korisnika te račune na mrežama Instagram, Facebook, TikTok, YouTube i LinkedIn, uz ostale kanale, svaki putem službenog API-ja mreže, uz praćenje svake veze 24/7. Od US$ 9 do US$ 0,75 po povezanom računu mjesečno, uz pad cijene kako dodajete veze, a prva 3 dana besplatno.

Često postavljana pitanja

Mogu li prenijeti povezane račune svojih korisnika bez ponovne prijave?

Ne. Svaka mreža veže pristup uz aplikaciju koja ga je zatražila, pa se svaki račun mora prijaviti jednom putem poveznice za povezivanje s platforme easyCoexistence.

Povezuje li easyCoexistence X, Threads ili Telegram?

Još ne. Te račune zadržite kod dosadašnjeg pružatelja dok se ostali prebacuju. Nove mreže pridružit će se istom Partner API-ju po istoj cijeni po povezanom računu kako se dodaju.

Mogu li LinkedIn poruke zadržati kod Unipile?

Zadržite ih kod Unipile. easyCoexistence radi s LinkedIn stranicama i profilima kroz objave i komentare, a LinkedIn DM-ove ne nudi.

Koliko košta easyCoexistence nakon prelaska?

Od US$ 9 do US$ 0,75 po povezanom računu mjesečno, isto na svim mrežama i uz pad kako dodajete veze, a prva 3 dana besplatno.

Nastavite čitati

Povežite svoj prvi kanal u dvije minute.

Bez čekanja na provjere platformi. Povežite WhatsApp, Instagram, TikTok ili drugi kanal, zatim zamolite svoju umjetnu inteligenciju da objavi, odgovori ili izradi izvješće i gledajte kako radi.

  • 3 dana besplatno
  • Otkažite bilo kada
  • Samo službeni API-ji
  • Nadzor 24/7

Provjereno na