Migrar o seu SaaS da Ayrshare, Zernio ou Unipile para o easyCoexistence: o que muda no seu código
Migrar o seu SaaS da Ayrshare, Zernio ou Unipile para o easyCoexistence muda quatro partes do seu código: a ligação, agora uma sessão de ligação alojada por conta; o endereçamento, por channel_id ou connection_id com o seu external_ref; a publicação, um POST /channels/:id/posts por conta; e os eventos, assinados por conta ou enviados pela Meta diretamente para si. Cada cliente volta a iniciar sessão uma vez, através do ecrã de consentimento da própria rede.
O cabeçalho que envia um pedido da Ayrshare para um User Profile, ao lado da chave de API do Primary Profile em Authorization.
Validade predefinida de um link de ligação da Ayrshare gerado por generateJWT; até 2,880 minutos exige o seu Max Pack.
Os estados de publicação da Zernio: draft, pending_approval, scheduled, publishing, published, partial, failed e cancelled.
O cabeçalho que a API da Unipile recebe, num URL base que é o seu próprio DSN, para chamadas como o link de autenticação alojado.
Duração de um link de ligação do easyCoexistence; cada link termina com um número ou um início de sessão com rede social.
Que equivalências existem?
Os conceitos mantêm-se; mudam as formas. O seu cliente, o link que liga uma conta, o identificador pelo qual a endereça, a chamada de publicação e os eventos têm todos uma correspondência. Cada linha segue a documentação do fornecedor, consultada a 3 de novembro de 2026, e a referência da Partner API do 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 |
O que muda ao sair da Ayrshare?
A camada de perfis desaparece. A Ayrshare envia uma publicação para um User Profile através do cabeçalho Profile-Key e distribui-a por uma lista de platforms em POST /api/post, com scheduleDate em UTC e mediaUrls para os ficheiros. No easyCoexistence, o seu ciclo percorre os canais do cliente: um POST /channels/:id/posts por cada um, com publish_at em qualquer deslocamento horário e os ficheiros em media como {url, type}. A ligação passa de generateJWT, cujo URL dura 5 minutos por predefinição, para uma sessão de ligação por conta que dura uma hora.
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
}),
});
}
}O que muda ao sair da Zernio?
Menos do que com os outros na publicação. O POST /v1/posts da Zernio recebe content, uma lista de platforms com platform e accountId, mediaItems e scheduledFor com um fuso horário, e aceita um Idempotency-Key, tal como o easyCoexistence. A lista passa a uma chamada por channel_id, e scheduledFor passa a publish_at com deslocamento. Os estados draft e pending_approval da Zernio não têm correspondência, por isso os rascunhos e as aprovações ficam no seu produto. A ligação passa de GET /v1/connect/{platform} com profileId, que devolve um authUrl, para POST /connect-sessions, que devolve um url e, mais tarde, um channel_id no seu redirecionamento.
O que muda ao sair da Unipile?
Sobretudo mensagens. A Unipile liga contas através de POST /api/v1/hosted/accounts/link no seu DSN com X-API-KEY, envia com POST /api/v1/chats/{chat_id}/messages e avisa de novas mensagens através de um webhook message_received, que inclui as mensagens enviadas pela própria conta. No easyCoexistence, um número do WhatsApp entra na Cloud API da Meta através da Coexistence, o que exige a app do WhatsApp Business, e a Meta entrega as suas mensagens ao seu webhook_url. As respostas seguem para o send_endpoint do número com o token do cliente, e as mensagens diretas do Instagram passam pela API da Meta com as credenciais do canal.
Os seus clientes têm de voltar a ligar as contas?
Sim, uma vez por conta. O acesso que cada cliente concedeu pertence à aplicação do fornecedor que o pediu, por isso não pode passar para outra. Cada conta inicia sessão de novo através de um link de ligação alojado, pelo ecrã de consentimento da própria rede ou pela janela pop-up da Meta para um número do WhatsApp. Peça-o quando o cliente estiver disponível: cada link funciona durante uma hora, e uma conta pode ter 50 links abertos e criar 100 por hora.
Como mudar sem interrupção?
Conta a conta, com os dois fornecedores a correr lado a lado até cada cliente ter mudado. O seu código encaminha cada conta para o fornecedor que a detém, e channel.connected ou connection.connected é o momento de mudar essa conta:
- Associe o id de cada cliente a
external_ref, e guardechannel_ideconnection_idao lado, à medida que chegam. - Envie os links de ligação cliente a cliente, começando pelas contas que mais publicam ou recebem.
- Em channel.connected, agende no easyCoexistence as publicações pendentes dessa conta e, só depois, cancele-as no fornecedor antigo.
- Aponte os eventos dessa conta para os seus novos recetores e, depois, desligue-a no fornecedor antigo.
O que se mantém no seu código?
O seu produto. O compositor, o calendário, o fluxo de aprovação e a caixa de entrada mantêm-se, e só muda o adaptador por baixo. Os ficheiros em media continuam a ir por link HTTPS público, a idempotência continua a assentar num cabeçalho, os eventos continuam a ser verificados com um HMAC sobre o corpo bruto, e tudo o que o seu código precise para além das chamadas encapsuladas vai diretamente para a API nativa da rede, com as credenciais de GET /channels/:id?credentials=1.
Erros comuns
- Cancelar publicações no fornecedor antigo antes de a conta voltar a ligar-se. Enquanto channel.connected não chegar, nada pode publicar no easyCoexistence, por isso reagende primeiro e cancele depois.
- Mudar um cliente cujo WhatsApp corre na app de consumo. A Coexistence liga números da app do WhatsApp Business, por isso o cliente deve mover o número para a app do WhatsApp Business antes de abrir o link.
- Enviar um só link para todas as redes de um cliente. Um link termina com um número ou um início de sessão, por isso crie uma sessão por conta.
- Mapear cancelled com a mesma grafia. O easyCoexistence reporta canceled, com um só l, por isso atualize qualquer comparação de estados no seu código.
O easyCoexistence oferece ao seu SaaS sessões de ligação alojadas, credenciais sempre atualizadas, uma fila de publicação e eventos assinados para os números de WhatsApp dos seus clientes e para as contas do Instagram, Facebook, TikTok, YouTube e LinkedIn, e mais canais, cada um através da API oficial da respetiva rede, com cada ligação monitorizada 24/7. De US$ 9 a US$ 0.75 por ligação por mês, a descer à medida que acrescenta ligações, com os primeiros 3 dias gratuitos.
Perguntas frequentes
Posso migrar as contas ligadas dos meus clientes sem que voltem a iniciar sessão?
Não. Cada rede liga o acesso à aplicação que o pediu, por isso cada conta inicia sessão uma vez num link de ligação do easyCoexistence.
O easyCoexistence liga X, Threads ou Telegram?
Ainda não. Mantenha essas contas no seu fornecedor atual enquanto as outras mudam. Novas redes entram na mesma Partner API, ao mesmo preço por ligação à medida que forem sendo acrescentadas.
Posso manter as mensagens do LinkedIn na Unipile?
Mantenha-as aí. O easyCoexistence funciona com páginas e perfis do LinkedIn através de publicações e comentários, e não oferece mensagens diretas do LinkedIn.
Quanto custa o easyCoexistence depois de mudar?
De US$ 9 a US$ 0.75 por ligação por mês, o mesmo em todas as redes e a descer à medida que acrescenta ligações, com os primeiros 3 dias gratuitos.
Continue a ler
Ligue o seu primeiro canal em dois minutos.
Sem revisões de plataformas para esperar. Ligue o WhatsApp, o Instagram, o TikTok ou outro canal, peça depois à sua IA que publique, responda ou faça um relatório, e veja-a trabalhar.
- 3 dias grátis
- Cancele quando quiser
- Só APIs oficiais
- Monitorizado 24/7
Verificado em