EntrarComeçar teste grátis
easyCoexistence APIs oficiais

Desconectar uma Página do Facebook de um app

Uma Página do Facebook é desconectada de um app de duas formas: o app a remove, com DELETE /{page_id}/subscribed_apps para interromper seus webhooks e DELETE /{user-id}/permissions para revogar a autorização, ou a pessoa que a conectou remove o app em Integrações comerciais nas configurações do Facebook. A Meta informa essa remoção ao callback de revogação do app, e uma requisição de exclusão de dados ao callback de exclusão de dados.

O easyCoexistence remove uma Página do Facebook em uma etapa, pelo painel ou pela Partner API, apagando o token e o encaminhamento de eventos e cancelando as publicações agendadas que não chegaram ao Facebook.

Business Integrations

Quando uma pessoa remove um app conectado com o Facebook Login for Business, isso invalida os tokens de acesso de usuário que ele detinha.

Deauthorize callback

Uma URL que a Meta acessa sempre que alguém desinstala o app pelo Facebook.com, sem interagir com o próprio app.

url + confirmation_code

O que um callback de exclusão de dados deve retornar em JSON: uma URL de status e um código de confirmação alfanumérico.

21 days

Com que frequência a Meta envia aos desenvolvedores do app um alerta com os IDs de usuário cujos dados eles devem excluir.

458

Subcódigo do erro 190 para um token cuja pessoa revogou ou nunca concedeu a autorização do app: has not authorized application.

Como uma pessoa remove um app das suas Páginas do Facebook?

Nas configurações do Facebook, com a conta de quem conectou as Páginas. A Central de Ajuda do Facebook descreve os passos, e a remoção vale para todas as Páginas que essa pessoa autorizou, não uma de cada vez:

  • Clique na foto do perfil no canto superior direito, depois em Configurações e privacidade e em Configurações.
  • Clique em Integrações comerciais no lado esquerdo.
  • Selecione o app, clique em Remover e depois em Remover novamente para confirmar.
  • A partir daí ele não pode mais gerenciar os anúncios, Páginas, grupos, eventos ou mensagens da pessoa, embora possa manter informações compartilhadas antes.

O que acontece com os tokens de acesso às Páginas?

Eles deixam de funcionar para esse app. A Central de Ajuda do Facebook diz que uma integração removida não pode mais gerenciar 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 usuário que o app mantém para essa pessoa, dos quais os tokens de Página são obtidos. A Meta não envia aviso quando um token deixa de funcionar, então o app só percebe na próxima chamada: uma autorização revogada retorna o erro 190 com subcódigo 458, User {user-id} has not authorized application {app-id}. A solução é um novo login.

O que é o callback de revogação?

Uma URL que o app define no App Dashboard, à qual a Meta envia uma chamada sempre que alguém desinstala o app pelo Facebook.com sem passar pelo app. Como a Meta não informa de outra forma que os tokens deixaram de funcionar, o callback é o sinal para o app parar de usar as Páginas dessa pessoa e apagar seus tokens. O handler do easyCoexistence verifica primeiro a signed_request contra o app secret, então uma chamada forjada não altera nada.

O que um callback de exclusão de dados precisa fazer?

A documentação da Meta define o que ela espera e alerta que o descumprimento pode fazer o callback ser removido ou o app ser desativado:

  • Receber requisições em uma URL HTTPS informada no campo Data Deletion Request URL das configurações do app.
  • Aceitar um POST cuja signed_request traga o ID do usuário com escopo do app como user_id.
  • Verificar a assinatura HMAC-SHA256 da signed_request com o app secret, como faz o código de exemplo da Meta.
  • Começar a excluir os dados que o app recebeu do Facebook sobre essa pessoa.
  • Responder com JSON contendo url, onde a pessoa pode acompanhar a requisição, e confirmation_code.
What Meta posts, decoded, and the answer it expects (Meta's own examples)
// 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 uma pessoa envia uma requisição de exclusão de dados?

O guia de exclusão de dados da Meta descreve o caminho pelas configurações de Aplicativos e sites do Facebook: depois de remover o app, a pessoa abre Ver aplicativos e sites removidos, escolhe Ver ao lado do app e clica em Enviar requisição, que também é como a Meta sugere testar o callback. A Meta também envia aos desenvolvedores do app um alerta a cada 21 dias com os IDs de usuário cujos dados precisam ser excluídos, em um arquivo mantido por 60 dias nas configurações avançadas do app.

Como um app desconecta uma Página por conta própria?

Com duas chamadas à Graph API, conforme o alcance desejado. DELETE /{page_id}/subscribed_apps, feita com um app access token, remove a assinatura de webhook do próprio app na Página, então os eventos de feed e do Messenger param. DELETE /{user-id}/permissions revoga a autorização do app para essa pessoa: os tokens de acesso de usuário são invalidados, e ela precisa fazer login e conceder acesso de novo, como se fosse a primeira vez.

O que o easyCoexistence faz quando você remove uma Página?

Remover este canal, na tela da Página no painel, ou DELETE /api/v1/channels/:id da Partner API, cancela a assinatura da Página nos webhooks da Meta e apaga seu token de Página, a URL de encaminhamento de eventos e o segredo de assinatura dessa URL. As publicações agendadas para a Página que nunca chegaram ao Facebook são canceladas em vez de ficarem para falhar, as regras de comentário para DM param, e a cobrança da conexão termina com o ciclo de faturamento atual.

O que acontece quando o app é removido no Facebook?

A Meta chama o callback de revogação do easyCoexistence, identificando a pessoa pelo seu ID com escopo do app. O easyCoexistence verifica a requisição assinada com o app secret, marca as Páginas que essa pessoa conectou como removidas, apaga os tokens e o encaminhamento de eventos e as retira da contagem de conexões. Uma requisição de exclusão de dados faz o mesmo e responde à Meta com um link para o aviso de privacidade do easyCoexistence e um código de confirmação.

Quais dados permanecem após a remoção?

O ID e o nome da Página continuam registrados, então conectá-la de novo a restaura, e são excluídos a pedido, conforme o aviso de privacidade do easyCoexistence. Os eventos encaminhados de feed, menções e Messenger são repassados conforme chegam, sem cópia guardada. Com automações ativas, o texto das mensagens é mantido por 7 dias e os registros de execução das automações por 30 dias, e o texto e a prévia de uma publicação cancelada são excluídos após 30 dias.

Como uma plataforma fica sabendo que a Página de um cliente foi removida?

Pelos eventos de status assinados. A Partner API envia channel.removed quando a Página é removida no painel, por DELETE /api/v1/channels/:id ou pelas configurações do Facebook, e channel.disconnected quando a Meta deixa de aceitar o token e o titular precisa fazer login de novo. Cada evento traz o external_ref da plataforma quando a sessão de conexão o definiu.

Como configurar

  1. 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.
  2. 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.
  3. Ask for deletionWrite to the contact in easyCoexistence's privacy notice to have the Page's remaining record deleted.

Erros comuns

  • Remover o app em Integrações comerciais para tirar uma só Página. Isso encerra o acesso do app a todas as Páginas que a pessoa autorizou, então remova somente esse canal no easyCoexistence.
  • Remover apenas o conector no Claude ou no ChatGPT. Isso encerra o acesso do assistente, mas a Página continua conectada e cobrada até o canal ser removido no easyCoexistence.
  • Responder a um callback de exclusão de dados com corpo vazio. A Meta espera uma URL de status e um código de confirmação, e pode remover o callback ou desativar o app sem eles.
  • Agir sobre um callback sem verificar a assinatura. Valide a signed_request com o app secret, como faz o exemplo da Meta, antes de confiar no ID de usuário que ela contém.
Fazendo isso com o EasyCoexistence

Ele responde sozinho aos callbacks de revogação e de exclusão de dados da Meta e envia channel.removed às plataformas. De US$ 9 a US$ 0.75 por conexão por mês, com o preço caindo conforme você adiciona conexões, e os 3 primeiros 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

Remover um app no Facebook apaga meus dados?

Ele encerra o acesso do app às suas Páginas e a novas informações privadas, mas o app pode manter o que recebeu antes. Peça que ele apague esses dados; o callback de exclusão de dados da Meta é como os apps recebem essas requisições.

O que acontece com as publicações agendadas de uma Página removida?

Remover a Página no easyCoexistence cancela as publicações que ainda não chegaram ao Facebook, sem e-mail de falha, e as publicações já publicadas continuam na Página.

Remover uma Página interrompe a cobrança?

Sim. A conexão dessa Página é cobrada até o fim do ciclo atual e depois sai da sua contagem total.

Posso conectar a Página de novo depois?

Sim. Escolha Nova conexão no painel, faça login com o Facebook e selecione a Página; o registro anterior volta com um novo token.

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