EntrarComeçar teste grátis
easyCoexistence APIs oficiais

Como o easyCoexistence mantém as conexões ativas: monitoramento 24/7

O easyCoexistence mantém as conexões ativas monitorando cada conexão 24/7 e renovando o acesso antes que expire. Os webhooks da Meta e verificações regulares acompanham a classificação de qualidade, o nível de mensagens, o vínculo de Coexistência e a capacidade de envio de cada número do WhatsApp; as contas de redes sociais são verificadas a cada 6 horas. Quando uma conexão cai ou precisa de um novo login, o titular recebe um e-mail, e uma plataforma com URL de eventos recebe um evento de status assinado.

  • Cada conexão monitorada 24/7
  • Tokens renovados antes de expirar
  • Um e-mail com o motivo quando uma cai
Começar teste grátis

Nada é cobrado por 3 dias. Cancele quando quiser.

Só APIs oficiaisMCP para Claude e ChatGPTToda conexão monitorada 24/73 dias grátis
About 14 days

Tempo de inatividade do celular que usa o app do WhatsApp Business, após o qual a Meta desconecta um número conectado por Coexistência, com o motivo PRIMARY_INACTIVITY.

60 days

Validade de um token de acesso renovado do Instagram; um token de longa duração pode ser renovado depois de 24 horas, antes de expirar.

1 day

Validade do token de acesso de uma conta do TikTok pela Accounts API; um refresh token válido por um ano o renova.

1 hour

Tempo de validade de um token de acesso de usuário do Google antes de expirar, o tipo usado pela conexão de um canal do YouTube.

6 hours

Frequência com que o easyCoexistence verifica se cada conta social ainda responde, renovando os tokens antes que expirem.

O que o easyCoexistence observa em cada conexão?

Tudo o que pode impedir essa conexão de funcionar, e isso varia de uma rede para outra. Um número do WhatsApp pode perder o vínculo de Coexistência, a classificação de qualidade ou a capacidade de envio, por isso esses pontos são observados. Uma conta social depende de um token que a rede pode deixar expirar ou revogar, então o token é renovado com antecedência e a conta é verificada a cada 6 horas. O painel mostra o status de cada conexão, e a página de um número acrescenta o snapshot mais recente da Meta e uma linha do tempo do que mudou:

WhatsAppCoexistence link, quality rating, messaging tier and ability to send
Instagram60-day token renewed ahead; account checked every 6 hours
FacebookPage access checked every 6 hours
TikTokOne-day token renewed on its own; account checked every 6 hours
YouTubeGoogle's one-hour token renewed; channel checked every 6 hours
LinkedIn60-day access renewed early where LinkedIn allows; checked every 6 hours

Como um número do WhatsApp é monitorado?

Por meio de duas fontes ao mesmo tempo. Os webhooks da Meta informam as mudanças na conta conforme acontecem: uma desconexão, uma mudança de qualidade, um alerta, o resultado de uma revisão, uma alteração de capacidade ou de nome de exibição. Verificações regulares então leem da Meta a classificação de qualidade, o nível de mensagens e o estado da conexão do número, junto com sua saúde de envio, que indica se ele realmente consegue iniciar conversas.

Essa última verificação identifica um número que parece conectado, mas não consegue enviar, muitas vezes porque a empresa não tem método de pagamento na Meta. A Meta informa isso como LIMITED ou BLOCKED, e o titular recebe um e-mail quando o envio é bloqueado e outro quando ele é restabelecido.

O que acontece quando um número do WhatsApp cai?

A Meta encerra o vínculo e informa o motivo, e o easyCoexistence repassa essa informação. O motivo mais comum é PRIMARY_INACTIVITY: o celular que usa o app do WhatsApp Business ficou cerca de 14 dias sem uso. Outros incluem ACCOUNT_DISCONNECTED, iniciado pela Meta ou pela empresa, CHANGE_NUMBER e USER_RE_REGISTERED.

O titular recebe um e-mail com o motivo assim que a queda é detectada, e o painel marca o número como desconectado. Refazer o fluxo de conexão com o mesmo número o traz de volta, geralmente em poucos minutos, e o easyCoexistence restaura sozinho o destino do webhook, já que a Meta o remove junto com a desconexão.

1Meta drops the linkWith a reason, such as PRIMARY_INACTIVITY
2Email to the ownerThe reason and the fix, as soon as it is detected
3Connect againMeta's flow, with the same number
4Route restoredThe webhook destination is put back

Como as contas sociais permanecem conectadas?

Renovando o acesso antes que expire e verificando a cada 6 horas se a conta ainda responde. Se uma rede recusar o token mesmo assim, porque o acesso foi removido nas configurações dela, a senha foi alterada ou a sessão terminou, a conta é marcada para reconexão e o titular recebe um e-mail. Cada rede define suas próprias regras de token:

  • Instagram: um token de longa duração vale 60 dias, e o easyCoexistence o renova bem antes disso.
  • Facebook: tokens de Página não têm data de expiração, então a verificação é se a Página ainda responde.
  • TikTok: o token de acesso vale um dia e é renovado com um refresh token que vale um ano.
  • YouTube: o token de acesso do Google vale uma hora e é renovado sempre que está perto de acabar.
  • LinkedIn: o acesso vale 60 dias e é renovado uma semana antes quando o LinkedIn emite um refresh token; caso contrário, o titular faz login de novo.

Quais alertas o titular recebe?

E-mails enviados ao titular da conta, um por incidente e não a cada verificação. O mesmo estado aparece no painel e pelas ferramentas MCP, então um agente de IA que perguntar se as conexões estão saudáveis o lê ali:

  • Um número do WhatsApp conectado, pela primeira vez ou de novo após uma queda.
  • Um número desconectado pela Meta, com o motivo informado por ela, quando ela informa um.
  • Envio bloqueado em um número, e envio restabelecido.
  • Uma conta social que precisa de novo login, com um botão para reconectá-la.
  • Uma automação que falhou em uma mensagem, no máximo uma vez a cada 6 horas por automação, e automações pausadas porque o provedor de IA recusou a chave delas.

Como uma plataforma fica sabendo de uma queda?

Por meio de eventos de status assinados, depois que ela define uma URL de eventos no painel, em Profile, Developers, ou com a ferramenta MCP set_partner_events_url. Um número envia connection.connected, connection.disconnected com o motivo da Meta, connection.removed, connection.suspended ou connection.token_missing, e uma conta social envia os eventos de canal correspondentes. Cada evento é um POST JSON assinado com X-EC-Signature e repetido com backoff quando o endpoint não responde 2xx.

Isso importa no WhatsApp porque a Meta envia o webhook da desconexão apenas para o callback do próprio app, nunca para a URL de um cliente, então o evento é a forma como a plataforma toma conhecimento dela. Uma queda encontrada pela verificação do próprio easyCoexistence traz detected_by health_check.

Erros comuns

  • Tomar um status conectado como sinal de que o número pode enviar. Um número pode estar conectado e ainda assim bloqueado para iniciar conversas, muitas vezes por falta de método de pagamento na Meta, algo que o e-mail de saúde de envio sinaliza.
  • Reconectar um número do WhatsApp que caiu pela opção de código por SMS ou voz. Esse caminho migra o número para fora do app do WhatsApp Business; a Coexistência reconecta com o código QR.
  • Reconectar uma conta social com outro login. Entre com a mesma conta que caiu, ou ela chega como uma nova conexão enquanto a antiga continua desconectada.
  • Guardar um token do TikTok ou do YouTube no seu próprio sistema. Eles duram um dia e uma hora, então busque credenciais novas no easyCoexistence quando cada tarefa começar.
Fazendo isso com o EasyCoexistence

O easyCoexistence monitora cada número do WhatsApp e cada conta social que você conecta, no WhatsApp, Instagram, Facebook, TikTok, YouTube, LinkedIn e mais canais, renova o acesso antes que expire e avisa você, com o motivo, quando uma conexão cai. O monitoramento faz parte do preço: de US$ 9 a US$ 0.75 por conexão por mês, caindo conforme você adiciona conexões, com 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

Com que frequência as conexões são verificadas?

Contas sociais a cada 6 horas, com tokens renovados quando estão perto de expirar. Números do WhatsApp continuamente pelos webhooks da Meta, além de verificações regulares da saúde deles e da capacidade de envio.

Qual é a regra de 14 dias do WhatsApp?

A Meta desconecta um número de Coexistência quando o celular que usa o app do WhatsApp Business fica inativo por cerca de 14 dias. O easyCoexistence envia um e-mail ao titular com esse motivo, e refazer o fluxo de conexão com o mesmo número o traz de volta.

O monitoramento tem custo extra?

Não. Cada conexão é monitorada como parte do seu preço, de US$ 9 a US$ 0.75 por conexão por mês, sem plano separado para alertas.

Uma conexão caída ainda conta na fatura?

Sim, enquanto ela puder ser reconectada, já que perceber a queda e avisar você faz parte do serviço. Remover a conexão interrompe a cobrança ao fim do ciclo, e uma que a Meta informar como perdida em definitivo sai da contagem automaticamente.

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