EntrarComeçar teste grátis
easyCoexistence APIs oficiais

Migrar seu SaaS da Ayrshare, Zernio ou Unipile para o easyCoexistence: o que muda no seu código

Migrar seu SaaS da Ayrshare, Zernio ou Unipile para o easyCoexistence muda quatro partes do seu código: a vinculação, agora com uma sessão de conexão hospedada por conta; o endereçamento, por channel_id ou connection_id com o seu external_ref; a publicação, com uma chamada POST /channels/:id/posts por conta; e os eventos, assinados por conta ou enviados pela Meta diretamente para você. Cada cliente faz login mais uma vez, pela tela de consentimento da própria rede.

Profile-Key

O cabeçalho que envia uma requisição do Ayrshare a um User Profile, ao lado da chave de API do Primary Profile em Authorization.

5 minutes

Validade padrão de um link de vinculação do Ayrshare gerado por generateJWT; até 2,880 minutos exige o Max Pack.

8 statuses

Status de publicação da Zernio: draft, pending_approval, scheduled, publishing, published, partial, failed e cancelled.

X-API-KEY

O cabeçalho que a API da Unipile recebe, em uma URL base que é o seu próprio DSN, para chamadas como o link de autenticação hospedado.

1 hour

Por quanto tempo vale um link de conexão do easyCoexistence; um link termina com um número ou um login em uma rede social.

Qual é o equivalente de cada coisa?

Os conceitos são os mesmos; mudam os formatos. Seu cliente, o link que conecta uma conta, o id pelo qual você a endereça, a chamada de publicação e os eventos têm um equivalente. Cada linha segue a documentação própria de cada provedor, consultada em 3 de novembro de 2026, e a referência da Partner API do 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

O que muda ao sair da Ayrshare?

A camada de perfis desaparece. A Ayrshare envia uma publicação para um User Profile pelo cabeçalho Profile-Key e a distribui com uma lista platforms em POST /api/post, com scheduleDate em UTC e mediaUrls para os arquivos. No easyCoexistence, seu fluxo percorre os canais do cliente: um POST /channels/:id/posts para cada um, com publish_at em qualquer offset e a mídia como {url, type}. A vinculação passa de generateJWT, cuja URL dura 5 minutos por padrão, para uma sessão de conexão por conta que dura uma hora.

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

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 platforms com platform e accountId, mediaItems e scheduledFor com um fuso horário, e aceita um Idempotency-Key, como o easyCoexistence faz. A lista vira uma chamada por channel_id, e scheduledFor vira publish_at com um offset. Os status draft e pending_approval da Zernio não têm equivalente, então rascunhos e aprovações ficam no seu produto. A vinculação passa de GET /v1/connect/{platform} com profileId, que devolve um authUrl, para POST /connect-sessions, que devolve uma url e, depois, um channel_id no seu redirecionamento.

O que muda ao sair da Unipile?

Sobretudo a troca de mensagens. A Unipile vincula contas por POST /api/v1/hosted/accounts/link no seu DSN com X-API-KEY, envia com POST /api/v1/chats/{chat_id}/messages e avisa sobre novas mensagens por um webhook message_received, que também inclui as mensagens enviadas pela própria conta. No easyCoexistence, um número do WhatsApp entra na Cloud API da Meta por meio da Coexistence, que exige o app do WhatsApp Business, e a Meta entrega as mensagens dele para o seu webhook_url. As respostas vão para o send_endpoint do número com o token do cliente, e as DMs do Instagram passam pela API da Meta com as credenciais do canal.

Seus clientes precisam se conectar de novo?

Sim, uma vez por conta. O acesso que cada cliente concedeu pertence ao app do provedor que o pediu, então não pode mudar para outro. Cada conta faz login de novo por um link de conexão hospedado, pela tela de consentimento da própria rede ou pelo pop-up da Meta para um número do WhatsApp. Peça no momento em que o cliente estiver disponível: cada link vale por uma hora, e uma conta pode ter 50 links abertos e criar 100 por hora.

Como trocar sem interrupção?

Conta por conta, com os dois provedores rodando lado a lado até que cada cliente tenha migrado. Seu código direciona cada conta ao provedor que a detém, e channel.connected ou connection.connected é o momento de virar essa conta:

  • Mapeie o id de cada cliente para external_ref, e guarde channel_id e connection_id ao lado conforme chegarem.
  • Envie links de conexão por cliente, começando pelas contas que mais publicam ou recebem.
  • Em channel.connected, agende as publicações pendentes dessa conta no easyCoexistence e depois cancele-as no provedor antigo.
  • Aponte os eventos dessa conta para os seus novos receptores e depois desvincule-a no provedor antigo.

O que continua igual no seu código?

O seu produto. O compositor, o calendário, o fluxo de aprovação e a caixa de entrada continuam como estão, e só o adaptador por baixo muda. A mídia ainda vai por link HTTPS público, a idempotência ainda depende de um cabeçalho, os eventos ainda são verificados com um HMAC sobre o corpo bruto, e o que o seu código precisar além das chamadas encapsuladas vai direto para a API nativa da rede, com as credenciais de GET /channels/:id?credentials=1.

Erros comuns

  • Cancelar publicações no provedor antigo antes de a conta se reconectar. Até chegar o channel.connected, nada pode ser publicado no easyCoexistence, então reagende primeiro e cancele depois.
  • Migrar um cliente cujo WhatsApp roda no app para consumidores. A Coexistence conecta números do app do WhatsApp Business, então o cliente move o número para esse app 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 login, então crie uma sessão por conta.
  • Tratar cancelled com a mesma grafia. O easyCoexistence informa canceled, com um só l, então atualize qualquer comparação de status no seu código.
Fazendo isso com o EasyCoexistence

O easyCoexistence oferece para o seu SaaS links de conexão hospedados, credenciais sempre atualizadas, uma fila de publicação e eventos assinados para os números do WhatsApp dos seus clientes e para as contas deles no Instagram, Facebook, TikTok, YouTube e LinkedIn, além de mais canais, cada um pela API oficial da rede, com cada conexão monitorada 24/7. De US$ 9 a US$ 0.75 por conexão por mês, com o valor caindo conforme você adiciona conexões, e os 3 primeiros dias grátis.

O easyCoexistence é uma API e um servidor MCP multicanal que conecta agentes de IA, como o Claude e o ChatGPT, ao WhatsApp, Instagram, TikTok, Facebook e mais. No WhatsApp, ele usa o Coexistence: a empresa continua usando o número no app WhatsApp Business enquanto a IA trabalha pela API oficial da Meta.

Perguntas frequentes

Posso migrar as contas conectadas dos meus clientes sem que eles façam login de novo?

Não. Cada rede vincula o acesso ao app que o pediu, então cada conta faz login uma vez por um link de conexão do easyCoexistence.

O easyCoexistence conecta X, Threads ou Telegram?

Ainda não. Mantenha essas contas com o seu provedor atual enquanto as outras migram. Novas redes entram na mesma Partner API, pelo mesmo preço por conexão, conforme forem adicionadas.

Posso manter as mensagens do LinkedIn na Unipile?

Mantenha ali. O easyCoexistence atua nas páginas e perfis do LinkedIn por meio de publicações e comentários, e não oferece DMs do LinkedIn.

Quanto custa o easyCoexistence depois da migração?

De US$ 9 a US$ 0.75 por conexão por mês, o mesmo em todas as redes e caindo conforme você adiciona conexões, com os 3 primeiros dias grátis.

Continue lendo

Conecte seu primeiro canal em dois minutos.

Sem esperar aprovação das plataformas. Conecte o WhatsApp, o Instagram, o TikTok ou outro canal, peça para a sua IA publicar, responder ou trazer os números, e veja funcionando.

  • 3 dias grátis
  • Cancele quando quiser
  • Só APIs oficiais
  • Monitorado 24/7

Verificado em