Iniciar sessãoIniciar teste gratuito
easyCoexistence APIs oficiais

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.

Hours

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.

90 days

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.

Exempt

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.

page_messaging_api

A restrição de Integridade da Página que impede uma Página de enviar mensagens através da API da Messenger Platform.

6 hours

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:

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

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.

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 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:

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 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.
Fazer isto com a EasyCoexistence

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