EntrarComeçar teste grátis
easyCoexistence APIs oficiais

Por que uma conexão com a API de Página do Facebook para de funcionar e como mantê-la ativa

Uma conexão com a Página do Facebook para de funcionar quando a Meta deixa de aceitar o token dela ou de enviar os eventos: o token veio de um login de curta duração, a pessoa trocou a senha (erro 190, subcódigo 460), perdeu o papel na Página (492) ou removeu o app em Integrações de negócios (458), uma permissão ficou 90 dias sem uso, o app ficou inativo ou a Meta restringiu a Página.

A easyCoexistence obtém o token de cada Página a partir de um login de longa duração, verifica a Página a cada 6 horas e envia um e-mail quando a Meta recusa o token, e um único login no Facebook traz a Página de volta como a mesma conexão, com suas regras de comentário e automações.

Hours

Duração dos tokens padrão de usuário e de Página da Meta; um token de Página obtido de um token de usuário de longa duração não tem data de expiração.

90 days

Sem logins, chamadas à API ou webhooks durante esse período, a Meta considera o app inativo e invalida todos os seus tokens.

Exempt

Permissões de Página como pages_manage_posts e read_insights não expiram com o período de 90 dias de acesso a dados.

page_messaging_api

A restrição Page Integrity, que impede uma Página de enviar mensagens pela Messenger Platform API.

6 hours

Com que frequência a easyCoexistence verifica cada Página conectada com uma chamada leve ao Graph, enviando e-mail ao titular se a Meta recusar o token.

O que pode fazer uma conexão de Página parar de funcionar?

Causas em quatro níveis: o login da pessoa, as permissões e a situação do app, a própria Página e a assinatura do webhook. Cada uma aparece de um jeito, e a maioria volta como erro 190 com um subcódigo que indica a causa:

Short-lived sign-in190, subcode 463: the Page token expired with the user token it came from
Password change or logout190, subcode 460
Account checkpoint190, subcode 459 or 464: the person must log in at facebook.com
Role removed from the Page190, subcode 492
App removed in Business integrations190, subcode 458, and a call to the deauthorize callback
Permission unused for 90 daysCode 10, or one from 200 to 299, on the calls that need it
App inactive for 90 daysAll of the app's tokens invalidated
Page restricted368, or 10 with subcode 1893063 for messages
Webhooks failing for an hourThe app unsubscribed from the Page's events

Por que um token de Página pode expirar em horas?

Porque ele foi lido de /me/accounts com um token de usuário de curta duração, e então também é de curta duração. Os tokens padrão de usuário e de Página da Meta expiram em horas, cerca de uma a duas no caso de um token de curta duração. Trocado no servidor com fb_exchange_token, o token de usuário dura cerca de 60 dias, e um token de Página lido com ele não tem data de expiração. A Meta não estende um token já expirado: o erro diz Session has expired, com subcódigo 463, e a pessoa precisa fazer login de novo.

O que acontece após a troca de senha ou uma verificação de segurança?

A Meta invalida os tokens da pessoa. Um logout ou uma troca de senha retorna o erro 190 com subcódigo 460, The session is invalid because the user logged out, e a Meta avisa que eventos de segurança podem invalidar tokens antes da expiração prevista. Os subcódigos 459 e 464 indicam que a própria conta precisa de atenção: a pessoa deve entrar em facebook.com para corrigir um problema e depois fazer login no app de novo. Caso contrário, a solução é um novo login, pela mesma pessoa ou por alguém com papel na Página.

O que acontece quando a pessoa perde o papel na Página?

O token dela na Página para de funcionar com o erro 190, subcódigo 492, que a Meta descreve como o usuário associado ao token de acesso da Página não ter mais um papel adequado nela. Os tokens são emitidos por Página, pessoa e app, então os tokens de outras pessoas com papel continuam funcionando. A solução é conectar a Página de novo a partir de uma conta que ainda tenha controle total ou acesso a tarefas, de preferência alguém que não esteja prestes a deixar a empresa.

O que acontece quando alguém remove o app em Integrações de negócios?

A Meta invalida os tokens de acesso de usuário que o app tinha dessa pessoa, e os tokens de Página lidos com eles também param de funcionar, com erro 190, subcódigo 458: the user has not authorized the application. A pessoa remove um app nas configurações do Facebook, em Integrações de negócios, e a Meta então chama o callback de desautorização do app. Um token de usuário do sistema é encerrado da mesma forma pelo Gerenciador de Negócios, em Configurações de Negócios, Integrações, Apps conectados, e um app pode encerrar o próprio acesso com DELETE /{user-id}/permissions.

As permissões de Página expiram após 90 dias?

Existem duas regras diferentes de 90 dias, e só uma atinge as permissões de Página. A expiração do acesso a dados, que corta um app 90 dias depois de a pessoa ter estado ativa pela última vez, não se aplica a pages_show_list, pages_manage_posts, pages_messaging, read_insights e às demais permissões de Página que a Meta lista como sem expiração. A expiração de permissão, por outro lado, sim: uma permissão que o app não usou por 90 dias pode expirar, mesmo uma aprovada na App Review, e a pessoa precisa concedê-la de novo. Chamadas que dependem dela falham com código 10 ou um da faixa 200 até um novo login concedê-la.

O app inteiro pode perder o acesso?

Sim, de três formas documentadas, sobre as quais a Meta avisa com uma notificação urgente na caixa de alertas do App Dashboard. Um app sem logins, sem chamadas à Graph API ou à Marketing API e sem notificações de webhook por 90 dias é considerado inativo, e a Meta invalida todos os seus tokens; restaurá-lo pelo App Dashboard o atualiza para a versão mais recente, mas os tokens antigos continuam inválidos e as permissões descartadas por desuso voltam pela App Review. O Data Use Checkup anual precisa ser concluído, e violar os termos ou as políticas da Meta pode limitar o acesso à API ou revogar permissões.

O que acontece quando a Meta restringe a Página?

As ações restritas falham: erro 368, temporarily blocked for policy violations, ou, para mensagens, código 10 com subcódigo 1893063. A API Page Integrity da Meta indica qual: GET /{page-id}/page_status, com pages_manage_metadata, retorna um status de ok, warning, restricted ou suspended, cada restrição ativa, como page_publish, page_read_only, page_messaging ou page_messaging_api, com seu expiration_time, e ações recomendadas como FILE_APPEAL. O campo de webhook business_integrity informa as mudanças à medida que acontecem.

Por que os eventos param enquanto as chamadas à API ainda funcionam?

Porque os webhooks falham por conta própria. Depois de uma hora de entregas com falha, a Meta envia um alerta de Webhooks desativados e cancela a assinatura do app na Página até que ela seja refeita, e não envia nada para uma Página que desativou a App platform em suas Configurações do app. O token pode continuar válido em ambos os casos, então, depois de uma interrupção, verifique GET /{page-id}/subscribed_apps e, quando o endpoint voltar a responder, faça POST nele com o token da Página.

Como detectar uma conexão quebrada antes de uma publicação falhar?

Verificando em intervalos regulares, já que a Meta não avisa o app quando um token se torna inválido. Uma chamada leve como GET /{page-id}?fields=id,name com o token da Página falha da mesma forma que uma publicação falharia. debug_token, chamado com o ID e o segredo do app como token de acesso, retorna is_valid, expires_at e as permissões concedidas, além do código de erro e do subcódigo de um token que não funciona mais; page_status informa as restrições, e o callback de desautorização anuncia um app removido.

Inspect a Page token with debug_token
curl -G "https://graph.facebook.com/v26.0/debug_token" \
  --data-urlencode "input_token=$PAGE_TOKEN" \
  --data-urlencode "access_token=$APP_ID|$APP_SECRET"

# data.is_valid, data.expires_at, data.scopes, data.granular_scopes,
# and data.error.code with data.error.subcode once the token stops working

Como reconectar uma Página?

Com o mesmo fluxo que a conectou, executado por alguém que ainda tenha papel na Página, depois de corrigir a causa quando houver uma: uma conta em checkpoint faz login em facebook.com, uma restrição segue sua ação recomendada e um endpoint com falha volta a responder com 200. O novo login retorna novas strings de token, então substitua as armazenadas em vez de manter as duas:

1Fix the causeCheckpoint, restriction or endpoint first
2Sign in againFacebook Login for Business, code exchanged on the server
3Long-lived tokenfb_exchange_token, about 60 days
4New Page tokenRead /me/accounts and replace the stored one
5Subscribe againPOST /{page-id}/subscribed_apps if events had stopped

O que a easyCoexistence faz quando a conexão de uma Página quebra?

Ela vigia as quebras que consegue ver e avisa você sobre elas. A cada 6 horas verifica cada Página conectada com GET /{page-id}?fields=id,name, e quando a Meta recusa o token com erro 190 ou 102, nessa verificação ou em qualquer chamada de ferramenta, a Página é marcada como Reconnect needed, o titular recebe um único e-mail e uma plataforma parceira recebe channel.disconnected. Outras recusas, como uma permissão ausente ou um bloqueio de política, voltam no resultado da ferramenta com o código e a mensagem da Meta.

Quando alguém remove o app em Integrações de negócios, o callback de desautorização da Meta chega à easyCoexistence, que remove as Páginas que essa pessoa conectou, apaga os tokens e os destinos de eventos, tira-as da cobrança e envia channel.removed. Entrar de novo pelo painel traz uma Página de volta como a mesma conexão, com suas regras de comentário e automações, reassinada para feed, messages e mention. Depois do status Reconnect needed, o destino de eventos também permanece; após uma remoção, set_social_webhook_destination o configura de novo com um novo segredo.

Erros comuns

  • Repetir o erro 190. Um token recusado falha da mesma forma a cada chamada, e só um novo login feito por alguém com papel na Página produz um válido.
  • Reconectar para tirar uma restrição. Um token novo deixa o status da Página como estava; o que muda isso são as ações recomendadas em page_status, como um recurso.
  • Pedir uma permissão que o produto usa raramente. Sem uso por 90 dias ela pode expirar, e as chamadas que dependem dela então falham; peça-a quando o recurso for lançado.
  • Manter o token antigo depois de reconectar. O novo login retorna uma string de token diferente, e um job que ainda guarda o antigo continua falhando com 190.
Fazendo isso com o EasyCoexistence

De US$ 9 a US$ 0.75 por conexão por mês, caindo conforme você adiciona conexões, com os primeiros 3 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

O token de uma Página para de funcionar quando o token de usuário de 60 dias expira?

Não, se ele foi lido de /me/accounts com esse token de usuário de longa duração: um token de Página assim não tem data de expiração, embora as causas desta página ainda possam encerrá-lo.

A Meta vai me avisar quando um token de Página parar de funcionar?

Não para um token que se torna inválido: a próxima chamada retorna o erro. A Meta chama o callback de desautorização do app quando alguém o remove, e avisa sobre riscos em todo o app na caixa de alertas do App Dashboard.

O token de outra pessoa pode manter a Página conectada?

Sim. Os tokens de Página são emitidos por Página, pessoa e app, então um token de alguém que ainda tenha papel na Página continua funcionando quando o acesso de uma pessoa termina.

Quanto custa a easyCoexistence para uma Página do Facebook?

De US$ 9 a US$ 0.75 por conexão por mês, definido pelo número de conexões que você tem, contando cada Página como uma, com os primeiros 3 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