Como conectar uma Página do Facebook a uma API ou agente de IA
Uma Página do Facebook se conecta a uma API ou agente de IA pelo Facebook Login for Business. Quem é dono da Página ou pode executar tarefas nela entra com o Facebook e aprova as permissões de Página do app, para publicar, comentar, Messenger e insights. Em seguida, o app lê o token de acesso de cada Página em /me/accounts; esse token não tem data de expiração quando vem de um token de usuário de longa duração.
O easyCoexistence conecta suas Páginas do Facebook em um único login com o Facebook Login for Business, mantém o token de cada Página criptografado e o verifica a cada 6 horas, para que o Claude, o ChatGPT ou sua própria plataforma possam publicar, agendar, responder a comentários e DMs e ler insights pela API oficial da Meta.
Para obter o token de uma Página em nome de uma pessoa, essa pessoa precisa ser dona da Página ou poder executar uma tarefa nela.
Uma pessoa com acesso de Administrador a uma Página na interface do Facebook pode executar todas as tarefas nessa Página.
Tokens de acesso de Página de longa duração, gerados a partir de um token de usuário de longa duração, não têm data de expiração.
Pessoas com acesso a tarefas gerenciam a Página em ferramentas como o Meta Business Suite, não diretamente no Facebook.
Quanto tempo um link de conexão do easyCoexistence funciona antes que sua sessão expire.
Quem pode conectar uma Página?
Quem é dono da Página ou pode executar tarefas nela, já que a Meta emite um token de acesso de Página somente para essa pessoa. Nas configurações de acesso às Páginas do Facebook, isso significa acesso do Facebook, com controle total ou parcial, ou acesso a tarefas, usado pelo Meta Business Suite ou pelo Gerenciador de Anúncios; a visão geral da Pages API da Meta acrescenta que o acesso de Administrador cobre todas as tarefas. Cada chamada é então verificada contra as tarefas dessa pessoa, então conecte a partir da conta cujo acesso cobre o trabalho:
- Publicar conteúdo:
CREATE_CONTENT. - Responder e excluir comentários: MODERATE.
- Respostas no Messenger e respostas privadas: MESSAGING.
- Insights: ANALYZE.
O que a pessoa vê ao entrar?
A janela de login do próprio Facebook, executada pelo Facebook Login for Business. O app abre o diálogo de login do Facebook com o config_id de uma configuração que define o tipo de token, os ativos e as permissões necessárias; com uma configuração de token de acesso de usuário, a pessoa entra com a conta pessoal do Facebook e concede ao app acesso às suas Páginas. O Facebook devolve um código, que o servidor do app troca por um token de usuário e depois por um de longa duração, antes de ler /me/accounts para cada Página e seu token.
Para que serve cada permissão?
A pessoa aprova todas juntas na mesma janela, e cada uma libera parte da Graph API. O easyCoexistence solicita estas nove, para que um agente possa publicar, responder e medir na Página; cada nota é o que a referência de permissões da Meta diz que a permissão permite:
Quais Páginas viram conexões?
Cada Página que o login devolve com um token vira uma conexão própria, cobrada como qualquer outra. Uma Página já ativa em outra conta do easyCoexistence permanece lá e é informada como já conectada, para que ninguém com acesso a ela possa tirá-la de uma conta pagante. Entrar de novo depois traz as Páginas adicionadas desde então e renova o token das que já estão conectadas.
Como conectar ao easyCoexistence?
No painel, em um único login: escolha Nova conexão, depois Facebook, entre com a conta do Facebook que administra a Página e escolha as Páginas. Uma conta sem cartão cadastrado é solicitada a cadastrar um primeiro, já que cada conexão é cobrada. Quando o Facebook retorna, cada Página mostra Conectada, e o easyCoexistence a inscreve nos campos de webhook de feed, mensagens e menções, mantém o token criptografado e o verifica a cada 6 horas.
Como uma plataforma conecta as Páginas de seus clientes?
Com um link de conexão hospedado pela Partner API. Seu backend faz uma requisição POST para /api/v1/connect-sessions com channel definido como facebook e um redirect_url, depois envia o cliente para a URL que ele devolve, onde ele continua com o Facebook, sem uma conta própria no easyCoexistence. O navegador volta com a sessão, o status e um channel_id, que seu backend confirma com GET /connect-sessions/:id. Cada Página conectada no login é anunciada com um evento channel.connected e leva seu external_ref, a menos que já tenha sido marcada para outro de seus clientes.
curl -X POST https://easycoexistence.com/api/v1/connect-sessions \
-H "Authorization: Bearer $EC_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"channel": "facebook",
"redirect_url": "https://app.example.com/connect/return",
"external_ref": "customer_4821"
}'O que acontece depois que conecta?
A Página fica pronta para o que quer que atue nela. list_social_accounts a devolve ao Claude, ao ChatGPT ou ao seu próprio agente, get_social_credentials entrega o ID da Página e a base da API ao seu código, e as alterações do feed, mensagens do Messenger e menções são enviadas ao seu endpoint assim que você definir um, com set_social_webhook_destination ou PUT /api/v1/channels/:id/webhook.
Por que uma conexão pode falhar?
Geralmente por um de quatro motivos, cada um com uma correção direta:
- A pessoa não administra nenhuma Página: o Facebook não devolve nenhuma para conectar, então entre com alguém que tenha acesso a ela.
- A pessoa cancelou o login: nada é conectado, e recomeçar abre uma janela nova.
- A Página já está conectada a outra conta do easyCoexistence: remova-a lá primeiro.
- O link de conexão foi aberto depois de uma hora: crie uma nova sessão.
Como configurar
- Check your accessMake sure your Facebook account has full control, partial control or task access on the Page.
- Start the connectionIn the easyCoexistence dashboard, choose New connection, then Facebook.
- Approve the permissionsSign in with Facebook and approve access for the Pages you want to connect.
- Point your AI at itAdd https://easycoexistence.com/api/mcp to Claude or ChatGPT, or call the Page from your own code.
Erros comuns
- Conectar por meio de alguém prestes a deixar a empresa. O token da Página depende do acesso dessa pessoa e para de funcionar quando ela perde esse acesso, então entre com uma conta que vai permanecer.
- Confiar só no status do redirecionamento. Qualquer um pode digitar status=connected em uma URL, então confirme a sessão com GET /connect-sessions/:id a partir do seu backend.
- Enviar webhook_url em uma sessão de conexão do Facebook. A API recusa nesse caso; defina a retransmissão de eventos de cada Página com PUT /api/v1/channels/:id/webhook assim que ela conectar.
- Ler apenas o channel_id do redirecionamento. Um único login do Facebook pode conectar várias Páginas, então liste-as com GET /api/v1/channels, filtrando por channel e external_ref.
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
Preciso de um app de desenvolvedor próprio da Meta para conectar uma Página?
Não. O app da Meta do easyCoexistence solicita as permissões de Página, então a pessoa entra com o Facebook e as aprova, sem app, App Review ou Business Verification próprios.
Alguém com acesso a tarefas pode conectar uma Página?
Sim, se as tarefas cobrirem o trabalho: a Meta dá um token de Página a qualquer pessoa que possa executar uma tarefa na Página e depois verifica cada chamada contra as tarefas dessa pessoa.
Posso conectar várias Páginas do Facebook?
Sim. Cada Página do login vira uma conexão própria, cobrada de US$ 9 a US$ 0.75 por conexão por mês conforme seu total cresce.
E se a Página já estiver conectada em outro lugar?
Ela não pode entrar em uma segunda conta do easyCoexistence enquanto estiver ativa na primeira. Remova-a lá e depois conecte-a novamente.
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