Passer d'Ayrshare, Zernio ou Unipile à easyCoexistence : ce qui change dans votre code
Passer d'Ayrshare, Zernio ou Unipile à easyCoexistence modifie quatre parties de votre code : la connexion des comptes, désormais une session de connexion hébergée par compte ; l'adressage, par channel_id ou connection_id avec votre external_ref ; la publication, un POST /channels/:id/posts par compte ; et les événements, signés par compte ou envoyés directement par Meta vers vous. Chacun de vos clients se reconnecte une fois, via l'écran de consentement propre au réseau.
L'en-tête qui envoie une requête Ayrshare vers un User Profile, à côté de la clé API du Primary Profile dans Authorization.
Durée de validité par défaut d'un lien de connexion Ayrshare issu de generateJWT ; atteindre 2 880 minutes nécessite son Max Pack.
Statuts des publications Zernio : draft, pending_approval, scheduled, publishing, published, partial, failed et cancelled.
L'en-tête attendu par l'API d'Unipile, sur une URL de base qui est votre propre DSN, pour des appels comme le lien d'authentification hébergé.
Durée de validité d'un lien de connexion easyCoexistence ; un lien se termine avec un seul numéro ou une seule authentification à un réseau social.
À quoi correspond chaque élément ?
Les concepts se transposent ; les formes changent. Votre client, le lien qui connecte un compte, l'identifiant qui sert à l'adresser, l'appel de publication et les événements ont tous un équivalent. Chaque ligne suit la documentation du fournisseur, consultée le 3 novembre 2026, et la référence de l'API partenaire d'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 |
Que change-t-on en quittant Ayrshare ?
La couche de profils disparaît. Ayrshare envoie une publication vers un User Profile grâce à l'en-tête Profile-Key et la diffuse à l'aide d'une liste platforms sur POST /api/post, avec scheduleDate en UTC et mediaUrls pour les fichiers. Sur easyCoexistence, votre boucle parcourt les canaux du client : un POST /channels/:id/posts pour chacun, avec publish_at dans n'importe quel décalage horaire et les médias sous la forme {url, type}. La liaison passe de generateJWT, dont l'URL dure 5 minutes par défaut, à une session de connexion par compte qui dure une heure.
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
}),
});
}
}Que change-t-on en quittant Zernio ?
Moins de changements qu'avec les autres pour la publication. POST /v1/posts de Zernio prend content, une liste platforms de platform et accountId, mediaItems et scheduledFor avec un fuseau horaire, et accepte un Idempotency-Key, comme le fait easyCoexistence. La liste devient un appel par channel_id, et scheduledFor devient publish_at avec un décalage horaire. Les statuts draft et pending_approval de Zernio n'ont pas d'équivalent : les brouillons et les approbations vivent donc dans votre produit. La connexion passe de GET /v1/connect/{platform} avec profileId, qui renvoie une authUrl, à POST /connect-sessions, qui renvoie une url puis un channel_id à votre redirection.
Que change-t-on en quittant Unipile ?
Surtout la messagerie. Unipile relie les comptes via POST /api/v1/hosted/accounts/link sur votre DSN avec X-API-KEY, envoie avec POST /api/v1/chats/{chat_id}/messages et signale les nouveaux messages par un webhook message_received, qui inclut les messages envoyés par le compte lui-même. Sur easyCoexistence, un numéro WhatsApp rejoint la Cloud API de Meta via Coexistence, ce qui nécessite l'application WhatsApp Business, et Meta transmet ses messages à votre webhook_url. Les réponses partent vers le send_endpoint du numéro avec le token du client, et les DM Instagram passent par l'API de Meta avec les identifiants du canal.
Vos clients doivent-ils se reconnecter ?
Oui, une fois par compte. L'accès accordé par chaque client appartient à l'application du fournisseur qui l'a demandé ; il ne peut donc pas être transféré vers une autre. Chaque compte se connecte à nouveau via un lien de connexion hébergé, par l'écran de consentement propre au réseau, ou par la fenêtre d'authentification Meta pour un numéro WhatsApp. Demandez-le pendant que le client est disponible : chaque lien fonctionne une heure, et un compte peut détenir 50 liens ouverts et en créer 100 par heure.
Comment basculer sans interruption ?
Compte par compte, les deux fournisseurs tournant en parallèle jusqu'à ce que chaque client ait basculé. Votre code achemine chaque compte vers le fournisseur qui le détient, et channel.connected ou connection.connected marque le moment de basculer ce compte :
- Associez l'identifiant de chaque client à
external_ref, et stockezchannel_idetconnection_idà côté, au fur et à mesure de leur arrivée. - Envoyez les liens de connexion client par client, en commençant par les comptes qui publient ou reçoivent le plus.
- Sur channel.connected, planifiez les publications en attente de ce compte sur easyCoexistence, puis annulez-les chez l'ancien fournisseur.
- Redirigez les événements de ce compte vers vos nouveaux récepteurs, puis dissociez-le chez l'ancien fournisseur.
Qu'est-ce qui reste identique dans votre code ?
Votre produit. L'éditeur de publications, le calendrier, le circuit d'approbation et la boîte de réception restent tels quels ; seul l'adaptateur sous-jacent change. Les médias passent toujours par un lien HTTPS public, l'idempotence repose toujours sur un en-tête, et les événements sont toujours vérifiés par un HMAC sur le corps brut. Ce dont votre code a besoin au-delà des appels encapsulés passe directement par l'API propre au réseau, avec les identifiants issus de GET /channels/:id?credentials=1.
Erreurs courantes
- Annuler les publications chez l'ancien fournisseur avant que le compte ne se reconnecte. Tant que channel.connected n'est pas arrivé, rien ne peut être publié sur easyCoexistence : reprogrammez donc d'abord, puis annulez.
- Basculer un client dont WhatsApp tourne sur l'application grand public. Coexistence connecte les numéros de l'application WhatsApp Business ; le client doit donc faire passer le numéro sur cette application avant d'ouvrir le lien.
- Envoyer un seul lien pour tous les réseaux d'un client. Un lien se termine avec un seul numéro ou une seule authentification ; créez donc une session par compte.
- Supposer que cancelled a la même orthographe. easyCoexistence renvoie canceled, avec un seul l ; mettez à jour toute comparaison de statut de votre code.
easyCoexistence offre à votre SaaS des liens de connexion hébergés, des identifiants à jour, une file de publication et des événements signés pour les numéros WhatsApp de vos clients, ainsi que leurs comptes Instagram, Facebook, TikTok, YouTube et LinkedIn, et d'autres canaux encore, chacun passant par l'API officielle du réseau, avec une surveillance de chaque connexion 24h/24 et 7j/7. De US$ 9 à US$ 0,75 par connexion et par mois, dégressif à mesure que vous ajoutez des connexions, avec 3 jours d'essai gratuit.
Questions fréquemment posées
Puis-je migrer les comptes connectés de mes clients sans qu'ils se reconnectent ?
Non. Chaque réseau lie l'accès à l'application qui l'a demandé ; chaque compte doit donc se connecter une fois via un lien de connexion easyCoexistence.
easyCoexistence connecte-t-il X, Threads ou Telegram ?
Pas encore. Gardez ces comptes chez votre fournisseur actuel pendant que les autres migrent. Les nouveaux réseaux rejoignent la même API partenaire, au même prix par connexion à mesure qu'ils sont ajoutés.
Puis-je garder la messagerie LinkedIn chez Unipile ?
Gardez-la là-bas. easyCoexistence fonctionne sur les pages et profils LinkedIn via les publications et les commentaires, et ne propose pas de DM LinkedIn.
Combien coûte easyCoexistence après la migration ?
De US$ 9 à US$ 0,75 par connexion et par mois, identique sur chaque réseau et dégressif à mesure que vous ajoutez des connexions, avec 3 jours d'essai gratuit.
Poursuivre la lecture
Connectez votre premier canal en deux minutes.
Aucune validation de plateforme à attendre. Connectez WhatsApp, Instagram, TikTok ou un autre canal, puis demandez à votre IA de publier, de répondre ou de faire un rapport, et regardez-la travailler.
- 3 jours gratuits
- Résiliable à tout moment
- API officielles uniquement
- Supervisé 24/7
Vérifié le