Kirjaudu sisäänAloita ilmainen kokeilu
easyCoexistence Viralliset API:t

Siirtyminen Ayrshare-, Zernio- tai Unipile-palvelusta easyCoexistenceen: mitä koodissasi muuttuu

Siirtyminen Ayrshare-, Zernio- tai Unipile-palvelusta easyCoexistenceen muuttaa koodisi neljä osaa: yhdistämisen, jossa jokaiselle tilille luodaan hostattu yhteysistunto; osoittamisen channel_id:llä tai connection_id:llä sekä external_ref-kentällä; julkaisun, jossa yksi POST /channels/:id/posts -kutsu tehdään tilikohtaisesti; ja tapahtumat, jotka allekirjoitetaan tilikohtaisesti tai jotka Meta lähettää suoraan sinulle. Jokainen asiakas kirjautuu kerran uudelleen sisään verkoston oman suostumusnäkymän kautta.

Profile-Key

Otsake, jolla Ayrshare-pyyntö ohjataan User Profilelle, Primary Profilen API-avaimen rinnalla Authorization-kentässä.

5 minutes

generateJWT-kutsun oletusarvoinen voimassaoloaika Ayrshare-linkitysosoitteelle; jopa 2,880 minuuttia vaatii Max Pack -paketin.

8 statuses

Zernion postauksen tilat: draft, pending_approval, scheduled, publishing, published, partial, failed ja cancelled.

X-API-KEY

Otsake, jonka Unipile-API ottaa vastaan omalla DSN-perusosoitteellasi, esimerkiksi hostatun kirjautumislinkin kutsuissa.

1 hour

Kuinka kauan easyCoexistence-yhteyslinkki toimii; yksi linkki valmistuu yhdellä numerolla tai yhdellä sosiaalisen median kirjautumisella.

Mikä vastaa mihinkin?

Käsitteet siirtyvät mukana, muodot muuttuvat. Asiakkaasi, tilin yhdistävä linkki, tunniste jolla tiliin viitataan, julkaisukutsu ja tapahtumat kaikilla on vastineensa. Jokainen rivi noudattaa palveluntarjoajan omia dokumentaatioita, luettuna 3. marraskuuta 2026, sekä easyCoexistencen Partner API -rajapinnan viitettä:

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

Mitä muuttuu, kun lähdet Ayrsharesta?

Profiilikerros poistuu. Ayrshare lähettää postauksen User Profilelle Profile-Key-otsakkeella ja jakaa sen platforms-listalla POST /api/post -kutsussa, scheduleDate UTC-muodossa ja tiedostot mediaUrls-kentässä. easyCoexistencessa silmukka kulkee asiakkaan kanavien yli: yksi POST /channels/:id/posts jokaiselle, publish_at millä tahansa UTC-siirtymällä ja media muodossa {url, type}. Yhdistäminen siirtyy generateJWT-kutsusta, jonka linkki on oletuksena voimassa 5 minuuttia, yhteysistuntoon per tili, joka on voimassa tunnin.

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

Mitä muuttuu, kun lähdet Zerniosta?

Postauksessa vähemmän kuin muilla. Zernion POST /v1/posts ottaa vastaan content-kentän, platforms-listan, jossa on platform ja accountId, mediaItems-kentän sekä scheduledFor-kentän aikavyöhykkeen kanssa, ja se kunnioittaa Idempotency-Key-otsaketta, kuten easyCoexistence tekee. Lista muuttuu yhdeksi kutsuksi per channel_id, ja scheduledFor muuttuu publish_at-kentäksi, jossa on aikaero. Zernion draft- ja pending_approval-tiloilla ei ole vastinetta easyCoexistencessa, joten luonnokset ja hyväksynnät elävät omassa tuotteessasi. Yhdistäminen siirtyy kutsusta GET /v1/connect/{platform} profileId-kentällä, joka palauttaa authUrl-osoitteen, kutsuun POST /connect-sessions, joka palauttaa url-osoitteen ja myöhemmin channel_id-tunnisteen redirect-osoitteeseesi.

Mitä muuttuu, kun lähdet Unipilestä?

Pääosin viestit. Unipile yhdistää tilit POST /api/v1/hosted/accounts/link -kutsulla DSN-osoitteellasi X-API-KEY-otsakkeella, lähettää viestejä POST /api/v1/chats/{chat_id}/messages -kutsulla ja ilmoittaa uusista viesteistä message_received-webhookin avulla, johon kuuluvat myös tilin omat lähetetyt viestit. easyCoexistencessa WhatsApp-numero liittyy Metan Cloud API:in Coexistencen kautta, mikä vaatii WhatsApp Business -sovelluksen, ja Meta toimittaa sen viestit webhook_url-osoitteeseesi. Vastaukset menevät numeron send_endpoint-osoitteeseen asiakkaan tokenilla, ja Instagram-yksityisviestit kulkevat Metan API:n kautta kanavan tunnistetiedoilla.

Pitääkö asiakkaiden yhdistää uudelleen?

Kyllä, kerran per tili. Pääsy, jonka kukin asiakas on myöntänyt, kuuluu siihen palveluntarjoajan sovellukseen, joka sitä pyysi, eikä sitä voi siirtää toiseen. Jokainen tili kirjautuu uudelleen hostatun yhteyslinkin kautta verkoston oman suostumusnäkymän tai WhatsApp-numeron Metan ponnahdusikkunan kautta. Pyydä se, kun asiakas on tavoitettavissa: jokainen linkki toimii tunnin, ja tilillä voi olla 50 avointa linkkiä ja luoda 100 tunnissa.

Miten vaihdetaan ilman katkoksia?

Tili kerrallaan, kun molemmat palveluntarjoajat toimivat rinnakkain, kunnes jokainen asiakas on siirtynyt. Koodisi ohjaa kunkin tilin sille palveluntarjoajalle, jolla se on, ja channel.connected tai connection.connected on hetki, jolloin tili siirretään:

  • Kirjaa jokaisen asiakkaan tunnus external_ref-kenttään ja tallenna channel_id sekä connection_id sen viereen niiden saapuessa.
  • Lähetä yhteyslinkit asiakas kerrallaan, aloittaen tileistä, jotka julkaisevat tai vastaanottavat eniten.
  • Kun channel.connected saapuu, ajasta kyseisen tilin odottavat postaukset easyCoexistencessa ja peru ne sitten vanhassa palveluntarjoajassa.
  • Ohjaa kyseisen tilin tapahtumat uusiin vastaanottimiisi ja irrota tili vanhassa palveluntarjoajassa.

Mikä pysyy samana koodissasi?

Oma tuotteesi. Julkaisueditori, kalenteri, hyväksyntävirta ja postilaatikko pysyvät ennallaan, ja vain niiden alla oleva sovitin vaihtuu. Media kulkee edelleen julkisella HTTPS-linkillä, idempotenssi kulkee edelleen otsakkeella, tapahtumat varmennetaan edelleen HMAC:lla raakaan runkoon, ja mitä koodisi tarvitsee kääreiden kutsujen ulkopuolelta, menee suoraan verkoston omaan API:in GET /channels/:id?credentials=1 -kutsun tunnuksilla.

Yleiset virheet

  • Postausten perumista vanhassa palveluntarjoajassa ennen kuin tili yhdistää uudelleen. Ennen kuin channel.connected saapuu, easyCoexistencessa ei voi julkaista mitään, joten ajasta ensin ja peru toiseksi.
  • Asiakkaan siirtäminen, jonka WhatsApp toimii kuluttajasovelluksessa. Coexistence yhdistää WhatsApp Business -sovellusnumeroita, joten asiakkaan on siirrettävä numero WhatsApp Business -sovellukseen ennen linkin avaamista.
  • Yhden linkin lähettäminen kaikille asiakkaan verkostoille. Linkki valmistuu yhdellä numerolla tai yhdellä kirjautumisella, joten luo yksi istunto per tili.
  • Cancelled-tilan rinnastaminen samaan kirjoitusasuun. easyCoexistence raportoi tilan canceled yhdellä l-kirjaimella, joten päivitä koodisi kaikki tilavertailut.
Näin teet tämän EasyCoexistencen avulla

easyCoexistence antaa SaaS-tuotteellesi hostatut yhteyslinkit, tuoreet tunnistetiedot, julkaisujonon ja allekirjoitetut tapahtumat asiakkaidesi WhatsApp-numeroille sekä Instagram-, Facebook-, TikTok-, YouTube- ja LinkedIn-tileille. Lisää kanavia tulee, ja jokainen kulkee verkoston virallisen API:n kautta. Jokaista yhteyttä valvotaan 24/7. US$ 9–US$ 0.75 per yhteys kuukaudessa, hinta laskee lisäyhteyksien myötä, ja ensimmäiset 3 päivää ovat ilmaisia.

Usein kysytyt kysymykset

Voinko siirtää asiakkaideni yhdistetyt tilit ilman, että he kirjautuvat uudelleen sisään?

Et. Jokainen verkosto sitoo pääsyn sovellukseen, joka sen pyysi, joten jokainen tili kirjautuu kerran easyCoexistencen yhteyslinkin kautta.

Yhdistääkö easyCoexistence X:n, Threadsin tai Telegramin?

Ei tällä hetkellä. Pidä nämä tilit nykyisessä palveluntarjoajassasi, kun muut siirtyvät. Uudet verkostot liittyvät samaan Partner API -rajapintaan samaan hintaan per yhteys, kun ne tulevat mukaan.

Voinko säilyttää LinkedIn-yksityisviestit Unipilessä?

Pidä ne siellä. easyCoexistence toimii LinkedIn-sivuilla ja -profiileilla postausten ja kommenttien kautta, eikä tarjoa LinkedIn-yksityisviestejä.

Paljonko easyCoexistence maksaa siirtymisen jälkeen?

US$ 9–US$ 0.75 per yhteys kuukaudessa. Hinta on sama kaikissa verkostoissa ja laskee lisäyhteyksien myötä, ja ensimmäiset 3 päivää ovat ilmaisia.

Lue lisää

Yhdistä ensimmäinen kanavasi kahdessa minuutissa.

Ei alustojen tarkastuksia odotettavana. Yhdistä WhatsApp, Instagram, TikTok tai jokin muu kanava, pyydä sitten tekoälyäsi julkaisemaan, vastaamaan tai raportoimaan ja seuraa, kun se hoitaa homman.

  • 3 päivää ilmaiseksi
  • Peruuta milloin tahansa
  • Vain viralliset API:t
  • Valvottu 24/7

Vahvistettu