Passare il tuo SaaS da Ayrshare, Zernio o Unipile a easyCoexistence: cosa cambia nel tuo codice
Passare il tuo SaaS da Ayrshare, Zernio o Unipile a easyCoexistence cambia quattro parti del codice: il collegamento, ora con una sessione di connessione ospitata per account; l'indirizzamento, tramite channel_id o connection_id con il tuo external_ref; la pubblicazione, con una POST /channels/:id/posts per account; e gli eventi, firmati per account oppure inviati da Meta direttamente a te. Ogni cliente accede di nuovo una sola volta, tramite la schermata di consenso della rete stessa.
L'intestazione che invia una richiesta Ayrshare a un User Profile, accanto alla chiave API del Primary Profile in Authorization.
Validità predefinita di un link di collegamento Ayrshare generato da generateJWT; fino a 2.880 minuti richiede il suo Max Pack.
Gli stati dei post di Zernio: draft, pending_approval, scheduled, publishing, published, partial, failed e cancelled.
L'intestazione che l'API di Unipile richiede, su un URL di base che è il tuo DSN, per chiamate come il link di autenticazione ospitato.
Per quanto tempo funziona un link di connessione di easyCoexistence; un link si completa con un solo numero o un solo accesso social.
Cosa corrisponde a cosa?
I concetti restano gli stessi; cambiano le forme. Il tuo cliente, il link che collega un account, l'id con cui lo indirizzi, la chiamata di pubblicazione e gli eventi hanno ciascuno un corrispettivo. Ogni riga segue la documentazione del provider, letta il 3 novembre 2026, e il riferimento dell'API Partner di 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 |
Cosa cambia uscendo da Ayrshare?
Il livello dei profili scompare. Ayrshare invia un post a un User Profile tramite l'intestazione Profile-Key e lo distribuisce con un elenco platforms su POST /api/post, con scheduleDate in UTC e mediaUrls per i file. Su easyCoexistence il tuo ciclo scorre i canali del cliente: una POST /channels/:id/posts per ciascuno, con publish_at in qualsiasi fuso orario e i media come {url, type}. Il collegamento passa da generateJWT, il cui URL dura 5 minuti per impostazione predefinita, a una sessione di connessione per account che dura un'ora.
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
}),
});
}
}Cosa cambia uscendo da Zernio?
Meno cambiamenti rispetto agli altri per la pubblicazione. POST /v1/posts di Zernio accetta content, un elenco platforms di platform e accountId, mediaItems e scheduledFor con un timezone, e rispetta un Idempotency-Key, come fa easyCoexistence. L'elenco diventa una chiamata per ogni channel_id, e scheduledFor diventa publish_at con un offset. Gli stati draft e pending_approval di Zernio non hanno un corrispettivo, quindi bozze e approvazioni vivono nel tuo prodotto. Il collegamento passa da GET /v1/connect/{platform} con profileId, che restituisce un authUrl, a POST /connect-sessions, che restituisce un url e in seguito un channel_id sul tuo redirect.
Cosa cambia uscendo da Unipile?
Soprattutto la messaggistica. Unipile collega gli account tramite POST /api/v1/hosted/accounts/link sul tuo DSN con X-API-KEY, invia con POST /api/v1/chats/{chat_id}/messages e segnala i nuovi messaggi con un webhook message_received, che include i messaggi che l'account stesso ha inviato. Su easyCoexistence un numero WhatsApp entra nella Cloud API di Meta tramite Coexistence, che richiede l'app WhatsApp Business, e Meta consegna i suoi messaggi al tuo webhook_url. Le risposte vanno al send_endpoint del numero con il token del cliente, e i DM di Instagram passano dall'API di Meta con le credenziali del canale.
I tuoi clienti devono ricollegarsi?
Sì, una volta per account. L'accesso concesso da ciascun cliente appartiene all'app del provider che lo ha richiesto, quindi non può passare a un'altra. Ogni account accede di nuovo tramite un link di connessione ospitato, con la schermata di consenso della rete stessa o con il popup di Meta per un numero WhatsApp. Chiedilo quando il cliente è disponibile: ogni link funziona per un'ora, e un account può avere 50 link aperti e crearne 100 all'ora.
Come si passa senza interruzioni?
Account per account, con entrambi i provider attivi in parallelo finché ogni cliente non si è spostato. Il tuo codice instrada ogni account verso il provider che lo detiene, e channel.connected oppure connection.connected è il momento in cui passare quell'account:
- Associa l'id di ogni cliente a
external_ref, e salva accantochannel_ideconnection_idman mano che arrivano. - Invia i link di connessione cliente per cliente, partendo dagli account che pubblicano o ricevono di più.
- Su channel.connected, programma i post in attesa di quell'account su easyCoexistence, poi annullali presso il vecchio provider.
- Indirizza gli eventi di quell'account verso i nuovi ricevitori, poi scollegalo dal vecchio provider.
Cosa resta uguale nel tuo codice?
Il tuo prodotto. L'editor dei post, il calendario, il flusso di approvazione e l'inbox restano come sono, e cambia solo l'adattatore sotto di essi. I media continuano ad andare tramite link HTTPS pubblico, l'idempotenza continua a passare da un'intestazione, gli eventi sono ancora verificati con un HMAC sul corpo grezzo, e tutto ciò che il tuo codice richiede oltre le chiamate incapsulate va direttamente all'API nativa della rete con le credenziali di GET /channels/:id?credentials=1.
Errori comuni
- Annullare i post presso il vecchio provider prima che l'account si ricolleghi. Finché non arriva channel.connected, nulla può essere pubblicato su easyCoexistence, quindi riprogramma prima e annulla dopo.
- Spostare un cliente il cui WhatsApp gira sull'app consumer. Coexistence collega numeri dell'app WhatsApp Business, quindi il cliente sposta il numero sull'app WhatsApp Business prima di aprire il link.
- Inviare un solo link per tutte le reti di un cliente. Un link si completa con un solo numero o un solo accesso, quindi crea una sessione per ogni account.
- Confrontare lo stato cancelled così com'è. easyCoexistence segnala canceled, con una sola l, quindi aggiorna ogni confronto di stato nel tuo codice.
easyCoexistence offre al tuo SaaS link di connessione ospitati, credenziali sempre aggiornate, una coda di pubblicazione ed eventi firmati per i numeri WhatsApp dei tuoi clienti e per i loro account Instagram, Facebook, TikTok, YouTube e LinkedIn, oltre ad altri canali, ciascuno tramite l'API ufficiale della rete, con ogni connessione monitorata 24/7. Da US$ 9 a US$ 0,75 per connessione al mese, in calo man mano che aggiungi connessioni, con i primi 3 giorni di prova gratuita.
Domande frequenti
Posso migrare gli account collegati dei miei clienti senza che rifacciano l'accesso?
No. Ogni rete lega l'accesso all'app che lo ha richiesto, quindi ogni account accede una volta tramite un link di connessione easyCoexistence.
easyCoexistence collega X, Threads o Telegram?
Non ancora. Mantieni questi account presso il tuo provider attuale mentre gli altri migrano. Le nuove reti entrano nella stessa API Partner allo stesso prezzo per connessione man mano che vengono aggiunte.
Posso mantenere la messaggistica LinkedIn di Unipile?
Tienila lì. easyCoexistence lavora su pagine e profili LinkedIn tramite post e commenti, e non offre DM su LinkedIn.
Quanto costa easyCoexistence dopo il passaggio?
Da US$ 9 a US$ 0,75 per connessione al mese, uguale su ogni rete e in calo man mano che aggiungi connessioni, con i primi 3 giorni di prova gratuita.
Continua a leggere
Collega il tuo primo canale in due minuti.
Nessuna revisione delle piattaforme da aspettare. Collega WhatsApp, Instagram, TikTok o un altro canale, poi chiedi alla tua AI di pubblicare, rispondere o fare un report, e guardala al lavoro.
- 3 giorni gratis
- Disdici quando vuoi
- Solo API ufficiali
- Monitorato 24/7
Verificato il