Desligar uma Página do Facebook de uma aplicação
Uma Página do Facebook é desligada de uma aplicação de duas formas: a própria aplicação a remove, com DELETE /{page_id}/subscribed_apps para parar os seus webhooks e DELETE /{user-id}/permissions para a revogar, ou a pessoa que a ligou remove a aplicação em Business Integrations nas definições do Facebook. A Meta comunica essa remoção ao callback de revogação da aplicação, e um pedido de eliminação de dados ao seu callback de eliminação de dados.
A easyCoexistence remove uma Página do Facebook num único passo, a partir do painel ou da Partner API, apagando o seu token e o encaminhamento de eventos e cancelando as publicações agendadas que nunca chegaram ao Facebook.
Quando uma pessoa remove uma aplicação ligada com o Facebook Login for Business, isso invalida os tokens de acesso de utilizador que a aplicação detinha.
Um URL que a Meta contacta sempre que alguém desinstala a aplicação através do Facebook.com, sem interagir com a própria aplicação.
O que um callback de eliminação de dados tem de devolver em JSON: um URL de estado e um código de confirmação alfanumérico.
Com que frequência a Meta envia aos programadores de uma aplicação um alerta com os IDs de utilizador cujos dados têm de eliminar.
Subcódigo do erro 190 para um token cuja pessoa revogou ou nunca concedeu a autorização à aplicação: has not authorized application.
Como é que uma pessoa remove uma aplicação das suas Páginas do Facebook?
Nas definições do Facebook, com sessão iniciada como a pessoa que ligou as Páginas. A Central de Ajuda do Facebook indica os passos, e a remoção abrange as Páginas que essa pessoa concedeu, e não uma a uma:
- Clique na foto de perfil, no canto superior direito, depois em Definições e privacidade e, em seguida, em Definições.
- Clique em Business Integrations no lado esquerdo.
- Selecione a aplicação, clique em Remover e volte a clicar em Remover para confirmar.
- A partir desse momento, a aplicação deixa de poder gerir os anúncios, Páginas, grupos, eventos ou mensagens da pessoa, embora possa manter informações partilhadas anteriormente.
Qual é o destino dos tokens de acesso às Páginas?
Deixam de funcionar para essa aplicação. A Central de Ajuda do Facebook diz que uma integração removida já não pode gerir as Páginas da pessoa, e o guia Facebook Login for Business da Meta diz que a remoção invalida os tokens de acesso de utilizador que a aplicação detém para essa pessoa, aqueles de que se obtêm os tokens de Página. A Meta não envia qualquer aviso quando um token deixa de funcionar, por isso a aplicação só o descobre na chamada seguinte: uma autorização revogada devolve o erro 190 com o subcódigo 458, User {user-id} has not authorized application {app-id}. A solução é um novo início de sessão.
O que é o callback de revogação?
Um URL que a aplicação define no painel da aplicação na Meta, e que a Meta contacta sempre que alguém desinstala a aplicação através do Facebook.com sem passar pela própria aplicação. Como a Meta não informa de outra forma a aplicação de que os tokens deixaram de funcionar, o callback é o sinal para parar de usar as Páginas dessa pessoa e apagar os seus tokens. O manipulador de callbacks da easyCoexistence verifica primeiro o signed_request contra o segredo da aplicação, pelo que uma chamada forjada não altera nada.
O que tem de fazer um callback de eliminação de dados?
A documentação da Meta define o que espera e avisa que, se não o cumprir, o callback pode ser removido ou a aplicação desativada:
- Disponibilizar um URL HTTPS introduzido no campo Data Deletion Request URL nas definições da aplicação.
- Aceitar um POST cujo
signed_requesttransporta o ID de âmbito da aplicação da pessoa comouser_id. - Verificar a assinatura HMAC-SHA256 do
signed_requestcom o segredo da aplicação, como faz o código de exemplo da Meta. - Começar a eliminar os dados que a aplicação recebeu do Facebook sobre essa pessoa.
- Responder com JSON contendo url, onde a pessoa pode acompanhar o pedido, e
confirmation_code.
// signed_request, decoded
{
"algorithm": "HMAC-SHA256",
"expires": 1291840400,
"issued_at": 1291836800,
"user_id": "218471"
}
// the callback's answer
{
"url": "https://www.example.com/deletion?id=abc123",
"confirmation_code": "abc123"
}Como envia uma pessoa um pedido de eliminação de dados?
O guia de eliminação de dados da Meta descreve-o a partir das definições Aplicações e sites do Facebook: depois de remover a aplicação, a pessoa abre Ver aplicações e sites removidos, escolhe Ver ao lado da aplicação e clica em Enviar pedido, que é também a forma de a Meta sugerir para testar o callback. A Meta envia ainda aos programadores da aplicação um alerta de 21 em 21 dias com os IDs de utilizador cujos dados têm de ser eliminados, num ficheiro guardado durante 60 dias nas definições avançadas da aplicação.
Como é que a própria aplicação desliga uma Página?
Com duas chamadas Graph, consoante o alcance pretendido. DELETE /{page_id}/subscribed_apps, feito com um token de acesso de aplicação, remove a subscrição de webhook da aplicação na Página, pelo que deixam de chegar os seus eventos de feed e do Messenger. DELETE /{user-id}/permissions revoga a autorização da aplicação para essa pessoa: os seus tokens de acesso de utilizador são invalidados e ela tem de voltar a iniciar sessão e conceder acesso, como se fosse a primeira vez.
O que faz a easyCoexistence quando remove uma Página?
Remover este canal, no ecrã da Página no painel, ou DELETE /api/v1/channels/:id a partir da Partner API, cancela a subscrição da Página nos webhooks da Meta e apaga o seu token de Página, o URL de encaminhamento de eventos e o segredo de assinatura desse URL. As publicações agendadas para a Página que nunca chegaram ao Facebook são canceladas em vez de falharem, as regras de comentário para mensagem privada param, e a cobrança da ligação termina com o ciclo de faturação atual.
O que acontece quando a aplicação é removida no Facebook?
A Meta chama o callback de revogação da easyCoexistence, identificando a pessoa pelo seu ID de âmbito da aplicação. A easyCoexistence verifica o signed_request contra o segredo da aplicação, marca as Páginas que essa pessoa ligou como removidas, apaga os seus tokens e o encaminhamento de eventos, e retira-as da contagem de ligações. Um pedido de eliminação de dados faz o mesmo e responde à Meta com uma ligação para o aviso de privacidade da easyCoexistence e um código de confirmação.
Que dados ficam após a remoção?
O ID e o nome da Página ficam registados, pelo que voltar a ligá-la os restaura, e são eliminados a pedido, nos termos do aviso de privacidade da easyCoexistence. Os eventos de feed, de menções e do Messenger são reencaminhados à medida que chegam, sem qualquer cópia guardada. Com as automatizações ativas, o texto das mensagens é guardado durante 7 dias e os registos de execução das automatizações durante 30 dias, e o texto e a pré-visualização de uma publicação cancelada são apagados ao fim de 30 dias.
Como é que uma plataforma fica a saber que a Página de um cliente foi removida?
Através dos seus eventos de estado assinados. A Partner API envia channel.removed quando a Página é removida no painel, através de DELETE /api/v1/channels/:id ou nas definições do Facebook, e channel.disconnected quando a Meta deixa de aceitar o seu token e o proprietário precisa de voltar a iniciar sessão. Cada evento inclui o external_ref da plataforma quando a sessão de ligação o definiu.
Como configurar
- Remove the channel in easyCoexistenceOpen the Page's screen in the dashboard, choose Remove this channel and confirm, or call DELETE /api/v1/channels/:id from your backend.
- Remove the app in FacebookTo end the app's access to the Pages you granted, open Settings & privacy, then Settings and Business Integrations, and remove the app.
- Ask for deletionWrite to the contact in easyCoexistence's privacy notice to have the Page's remaining record deleted.
Erros comuns
- Remover a aplicação em Business Integrations para desligar uma só Página. Isso termina o acesso da aplicação a todas as Páginas que essa pessoa concedeu, por isso remova apenas esse canal na easyCoexistence.
- Remover apenas o conector no Claude ou no ChatGPT. Isso termina o acesso do assistente, mas a Página continua ligada e faturada até o seu canal ser removido na easyCoexistence.
- Responder a um callback de eliminação de dados com um corpo vazio. A Meta espera um URL de estado e um código de confirmação, e pode remover o callback ou desativar a aplicação sem eles.
- Agir sobre um callback sem verificar a assinatura. Verifique o signed_request com o segredo da aplicação, como faz o exemplo da Meta, antes de confiar no ID de utilizador que contém.
Responde por si aos callbacks de revogação e de eliminação de dados da Meta, e envia channel.removed às plataformas. De US$ 9 a US$ 0.75 por ligação por mês, descendo à medida que adiciona ligações, com os primeiros 3 dias grátis.
Perguntas frequentes
Remover uma aplicação no Facebook apaga os meus dados?
Termina o acesso da aplicação às suas Páginas e a novas informações privadas, mas a aplicação pode manter o que recebeu antes. Peça-lhe que o apague; o callback de eliminação de dados da Meta é a forma como as aplicações recebem esses pedidos.
O que acontece às publicações agendadas de uma Página removida?
Remover a Página na easyCoexistence cancela as publicações que ainda não chegaram ao Facebook, sem qualquer email de falha, e as publicações já publicadas mantêm-se na Página.
Remover uma Página cancela a cobrança?
Sim. A ligação dessa Página é faturada até ao fim do ciclo atual e depois sai da sua contagem total.
Posso voltar a ligar a Página mais tarde?
Sim. Escolha Nova ligação no painel, inicie sessão com o Facebook e selecione a Página; o registo anterior volta com um novo token.
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