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.
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.
Sem logins, chamadas à API ou webhooks durante esse período, a Meta considera o app inativo e invalida todos os seus tokens.
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.
A restrição Page Integrity, que impede uma Página de enviar mensagens pela Messenger Platform API.
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:
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.
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 workingComo 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:
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.
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