Porque deixa de funcionar a ligação à API da Página do Facebook, e como a manter ativa
Uma ligação a uma Página do Facebook deixa de funcionar quando a Meta deixa de aceitar o seu token ou deixa de enviar os seus eventos: o token veio de um início de sessão de curta duração, a pessoa alterou a palavra-passe (erro 190, subcódigo 460), perdeu a função na Página (492) ou removeu a aplicação em Integrações empresariais (458), uma permissão ficou sem uso durante 90 dias, a aplicação esteve inativa, ou a Meta restringiu a Página.
A easyCoexistence obtém o token de cada Página a partir de um início de sessão de longa duração, verifica a Página a cada 6 horas e envia-lhe um e-mail quando a Meta recusa o token, e um início de sessão no Facebook traz a Página de volta como a mesma ligação, com as suas regras de comentários e automatizações.
Validade dos tokens predefinidos de utilizador e de Página da Meta; um token de Página obtido a partir de um token de utilizador de longa duração não tem data de expiração.
Sem inícios de sessão, chamadas à API nem webhooks durante este período, a Meta considera a aplicação inativa 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 acesso aos dados de 90 dias.
A restrição de Integridade da Página que impede uma Página de enviar mensagens através da API da Messenger Platform.
A frequência com que a easyCoexistence verifica cada Página ligada com uma chamada Graph leve, enviando e-mail ao proprietário se a Meta recusar o token.
Que pode fazer uma ligação a uma Página deixar de funcionar?
As causas existem em quatro níveis: o início de sessão da pessoa, as permissões e o estado da aplicação, a própria Página e a subscrição do webhook. Cada uma se manifesta de forma diferente, e a maioria devolve o erro 190 com um subcódigo que indica a causa:
Porque expira um token de Página em poucas horas?
Porque foi lido em /me/accounts com um token de utilizador de curta duração e, por isso, também ele é de curta duração. Os tokens predefinidos de utilizador e de Página da Meta expiram em poucas horas, cerca de uma a duas horas no caso de um token de curta duração. Trocado no servidor com fb_exchange_token, o token de utilizador 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 prolonga um token já expirado: o erro indica que a sessão expirou, com subcódigo 463, e a pessoa tem de voltar a iniciar sessão.
O que acontece após uma alteração da palavra-passe ou uma verificação de segurança?
A Meta invalida os tokens da pessoa. Um fim de sessão ou uma alteração da palavra-passe devolve o erro 190 com subcódigo 460, A sessão é inválida porque o utilizador terminou a sessão, e a Meta avisa que eventos de segurança podem invalidar tokens antes da expiração prevista. Os subcódigos 459 e 464 significam que a própria conta precisa de atenção: a pessoa tem de iniciar sessão em facebook.com para corrigir um problema e, depois, voltar a iniciar sessão na aplicação. Caso contrário, a solução é um novo início de sessão, feito pela mesma pessoa ou por outra com uma função na Página.
O que acontece quando a pessoa perde a sua função na Página?
O token da Página deixa de funcionar com o erro 190, subcódigo 492, que a Meta descreve como o utilizador associado ao token de acesso da Página já não ter uma função adequada na Página. Os tokens são emitidos por Página, pessoa e aplicação, por isso os tokens de outras pessoas com função continuam a funcionar. A solução é voltar a ligar a Página a partir de uma conta que ainda tenha controlo total ou acesso a tarefas, de preferência uma que não esteja prestes a sair da empresa.
O que acontece quando alguém remove a aplicação em Integrações empresariais?
A Meta invalida os tokens de acesso de utilizador que a aplicação tinha para essa pessoa, e os tokens de Página lidos com eles também deixam de funcionar, com o erro 190, subcódigo 458: o utilizador não autorizou a aplicação. As pessoas removem uma aplicação nas definições do Facebook, em Integrações empresariais, e a Meta chama então o callback de desautorização da aplicação. Um token de utilizador de sistema termina do mesmo modo no Gestor de Negócios, em Definições de Negócio, Integrações, Aplicações ligadas, e uma aplicação pode terminar o seu próprio acesso com DELETE /{user-id}/permissions.
As permissões de Página expiram ao fim de 90 dias?
Existem duas regras de 90 dias diferentes, e só uma afeta as permissões de Página. A expiração do acesso aos dados, que corta a aplicação 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 nem às restantes permissões de Página que a Meta indica como não expirando. A expiração de permissões, sim: uma permissão que a aplicação não usou durante 90 dias pode expirar, mesmo que tenha sido aprovada na Revisão da aplicação, e a pessoa tem de a conceder de novo. As chamadas que a exigem falham com o código 10 ou com um código da gama 200 até um novo início de sessão a conceder.
A aplicação inteira pode perder o acesso?
Sim, de três formas documentadas, que a Meta anuncia com uma notificação urgente na caixa de alertas do Painel da aplicação. Uma aplicação sem inícios de sessão, sem chamadas à Graph API ou à Marketing API e sem notificações de webhook durante 90 dias é considerada inativa, e a Meta invalida todos os seus tokens; restaurá-la a partir do Painel da aplicação atualiza-a para a versão mais recente, mas os tokens antigos continuam inválidos e as permissões retiradas por desuso voltam a passar pela Revisão da aplicação. A Verificação de Utilização de Dados anual tem de ser concluída, e o incumprimento dos termos ou das 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 restringidas falham: erro 368, bloqueado temporariamente por violação de políticas, ou, para mensagens, código 10 com subcódigo 1893063. A API de Integridade da Página da Meta indica qual: GET /{page-id}/page_status, com pages_manage_metadata, devolve um estado de ok, warning, restricted ou suspended, cada restrição ativa, como page_publish, page_read_only, page_messaging ou page_messaging_api, com o respetivo expiration_time, e ações recomendadas como FILE_APPEAL. O campo de webhook business_integrity comunica as alterações à medida que acontecem.
Porque param os eventos enquanto as chamadas à API continuam a funcionar?
Porque os webhooks falham segundo as suas próprias regras. Após uma hora de entregas falhadas, a Meta envia um alerta de Webhooks desativados e cancela a subscrição da aplicação à Página até que a subscreva de novo, e a Meta não envia nada a uma Página que tenha desativado a plataforma da aplicação nas Definições da aplicação. O token pode continuar válido em ambos os casos; por isso, após uma interrupção, verifique GET /{page-id}/subscribed_apps e, quando o endpoint voltar a responder, faça um POST para ele com o token da Página.
Como se deteta uma ligação avariada antes de uma publicação falhar?
Através de verificações programadas, pois a Meta não avisa a aplicação quando um token se torna inválido. Uma chamada leve como GET /{page-id}?fields=id,name com o token da Página falha do mesmo modo que uma publicação falharia. debug_token, chamado com o ID e o segredo da aplicação como token de acesso, devolve is_valid, expires_at e os âmbitos concedidos, bem como o código de erro e o subcódigo de um token que já não funciona; page_status indica as restrições, e o callback de desautorização anuncia uma aplicação removida.
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 se volta a ligar uma Página?
Com o mesmo fluxo que a ligou, executado por alguém que ainda tenha uma função na Página, depois de corrigir a causa, quando houver uma: uma conta com verificação de segurança inicia sessão em facebook.com, uma restrição segue a ação recomendada e um endpoint com falhas volta a responder com 200. O novo início de sessão devolve novas strings de token, por isso substitua as guardadas em vez de manter ambas:
O que faz a easyCoexistence quando uma ligação a uma Página se quebra?
Vigia as quebras que consegue ver e avisa-o sobre elas. A cada 6 horas verifica cada Página ligada com GET /{page-id}?fields=id,name, e quando a Meta recusa o token com o erro 190 ou 102, nessa verificação ou em qualquer chamada de ferramenta, a Página é marcada como Precisa de nova ligação, o proprietário recebe um e-mail e uma plataforma parceira recebe channel.disconnected. Outras recusas, como uma permissão em falta ou um bloqueio por política, chegam no resultado da ferramenta com o código e a mensagem da Meta.
Quando alguém remove a aplicação em Integrações empresariais, o callback de desautorização da Meta chega à easyCoexistence, que remove as Páginas que essa pessoa ligou, apaga os seus tokens e destinos de eventos, retira-as da fatura e envia channel.removed. Voltar a iniciar sessão a partir do painel traz uma Página de volta como a mesma ligação, com as suas regras de comentários e automatizações, subscrita de novo a feed, messages e mention. Após o estado Precisa de nova ligação, o destino de eventos mantém-se; após uma remoção, set_social_webhook_destination define-o de novo com um novo segredo.
Erros comuns
- Voltar a tentar com o erro 190. Um token recusado falha da mesma forma em cada chamada, e só um novo início de sessão, feito por alguém com uma função na Página, produz um válido.
- Voltar a ligar para levantar uma restrição. Um novo token deixa o estado da Página como estava; as ações recomendadas em page_status, como um recurso, são o que a altera.
- Pedir uma permissão que o produto raramente usa. Sem uso durante 90 dias pode expirar, e as chamadas que a exigem falham; peça-a quando a funcionalidade for lançada.
- Manter o token antigo após voltar a ligar. O novo início de sessão devolve uma string de token diferente, e um processo que ainda use a antiga continua a falhar com 190.
De US$ 9 a US$ 0.75 por ligação por mês, que desce à medida que acrescenta ligações, com os primeiros 3 dias gratuitos.
Perguntas frequentes
Um token de Página deixa de funcionar quando expira o token de utilizador de 60 dias?
Não, se tiver sido lido a partir de /me/accounts com esse token de utilizador de longa duração: um token de Página assim não tem data de expiração, embora as causas descritas nesta página ainda o possam terminar.
A Meta avisa-me quando um token de Página deixa de funcionar?
Não no caso de um token que fica inválido: a chamada seguinte devolve o erro. A Meta chama o callback de desautorização da aplicação quando alguém a remove, e avisa sobre riscos gerais à aplicação na caixa de alertas do Painel da aplicação.
Pode o token de outra pessoa manter a Página ligada?
Sim. Os tokens de Página são emitidos por Página, pessoa e aplicação, por isso um token de outra pessoa que ainda tenha função na Página continua a funcionar 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 ligação por mês, definido pelo número de ligações, contando cada Página como uma, 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