Como ligar uma Página do Facebook a uma API ou agente de IA
Uma Página do Facebook liga-se a uma API ou agente de IA através do Facebook Login for Business. Quem é proprietário da Página ou pode executar tarefas nela inicia sessão com o Facebook e aprova as permissões da app para a Página, para publicação, comentários, Messenger e estatísticas; a app lê depois o token de acesso de cada Página em /me/accounts, um token sem data de expiração quando provém de um token de utilizador de longa duração.
O easyCoexistence liga as suas Páginas do Facebook num único início de sessão com o Facebook Login for Business, mantém o token de cada Página cifrado e verifica-o de 6 em 6 horas, para que o Claude, o ChatGPT ou a sua própria plataforma possam publicar, agendar, responder a comentários e mensagens privadas e ler estatísticas através da API oficial da Meta.
Para obter um token de Página a partir de uma pessoa, essa pessoa tem de ser proprietária 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.
Os tokens de acesso de Página de longa duração, gerados a partir de um token de utilizador de longa duração, não têm data de expiração.
As pessoas com acesso a tarefas gerem a Página em ferramentas como o Meta Business Suite, e não diretamente no Facebook.
Quanto tempo uma ligação alojada do easyCoexistence funciona antes de a sessão expirar.
Quem pode ligar uma Página?
Quem é proprietário da Página ou pode executar tarefas nela, já que a Meta só emite um token de acesso de Página a essa pessoa. Nas definições de acesso às Páginas do Facebook, isso significa acesso ao Facebook com controlo total ou parcial, ou acesso a tarefas, usado a partir do Meta Business Suite ou do Ads Manager; a visão geral da API de Páginas da Meta acrescenta que o acesso de Administrador abrange todas as tarefas. Cada chamada é depois verificada face às tarefas dessa pessoa, por isso ligue a partir da conta cujo acesso cobre o trabalho:
- Publicar publicações:
CREATE_CONTENT. - Responder e eliminar comentários: MODERATE.
- Respostas e respostas privadas no Messenger: MESSAGING.
- Estatísticas: ANALYZE.
O que vê a pessoa ao iniciar sessão?
A janela de início de sessão do próprio Facebook, executada pelo Facebook Login for Business. A app abre o diálogo de login do Facebook com o config_id de uma configuração que indica o tipo de token, os recursos e as permissões de que precisa; com uma configuração de token de acesso de utilizador, a pessoa inicia sessão com a sua conta pessoal do Facebook e concede à app acesso às suas Páginas. O Facebook devolve um código, que o servidor da app troca por um token de utilizador e depois por um de longa duração, antes de ler /me/accounts para cada Página e o respetivo token.
Para que serve cada permissão?
A pessoa aprova-as todas em conjunto na mesma janela, e cada uma abre uma parte da Graph API. O easyCoexistence pede 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 as Páginas que se tornam ligações?
Cada Página que o início de sessão devolve com um token torna-se uma ligação própria, faturada como qualquer outra. Uma Página já ativa noutra conta do easyCoexistence mantém-se lá e é indicada como já ligada, para que ninguém com acesso a ela a possa retirar de uma conta que paga. Ao voltar a iniciar sessão mais tarde, são trazidas as Páginas acrescentadas entretanto, e é atualizado o token das que já estão ligadas.
Como ligar ao easyCoexistence?
A partir do painel, num único início de sessão: escolha Nova ligação e depois Facebook, inicie sessão com a conta do Facebook que gere a Página e selecione as Páginas. Uma conta sem cartão registado é primeiro convidada a registar um, já que cada ligação é faturada. Quando o Facebook devolve o controlo, cada Página aparece como Ligada, e o easyCoexistence subscreve-a nos campos de webhook de feed, mensagens e menções, mantém o token cifrado e verifica-o de 6 em 6 horas.
Como liga uma plataforma as Páginas dos seus clientes?
Com uma ligação alojada da API de Parceiros. O seu backend envia um pedido POST para /api/v1/connect-sessions com channel definido como facebook e um redirect_url, e depois encaminha o cliente para o url devolvido, onde ele continua com o Facebook, sem uma conta própria no easyCoexistence. O navegador regressa com a sessão, o estado e um channel_id, que o seu backend confirma com GET /connect-sessions/:id. Cada Página ligada pelo início de sessão é anunciada com um evento channel.connected e traz o seu external_ref, a menos que já tenha sido marcada para outro dos 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 de ligar?
A Página fica pronta para o que quer que a utilize. list_social_accounts devolve-a 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 ao feed, as mensagens do Messenger e as menções são enviadas para o seu endpoint assim que o definir, com set_social_webhook_destination ou PUT /api/v1/channels/:id/webhook.
Porque pode falhar uma ligação?
Normalmente por um de quatro motivos, cada um com uma solução direta:
- A pessoa não gere nenhuma Página: o Facebook não devolve nenhuma para ligar, por isso inicie sessão com alguém que tenha acesso a ela.
- A pessoa cancelou o início de sessão: nada fica ligado, e recomeçar abre uma janela nova.
- A Página já está ligada a outra conta do easyCoexistence: remova-a primeiro aí.
- O link de ligação foi aberto depois de passada a sua hora de validade: 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
- Ligar através de alguém que está prestes a sair da empresa. O token da Página assenta no acesso dessa pessoa e deixa de funcionar quando o perde, por isso inicie sessão a partir de uma conta que se mantenha.
- Confiar apenas no estado do redirecionamento. Qualquer pessoa pode escrever status=connected num URL, por isso confirme a sessão com GET /connect-sessions/:id a partir do seu backend.
- Enviar webhook_url numa sessão de ligação do Facebook. A API recusa-o nesse caso; defina o reencaminhamento de eventos de cada Página com PUT /api/v1/channels/:id/webhook assim que ela se ligar.
- Ler apenas o channel_id do redirecionamento. Um único início de sessão no Facebook pode ligar várias Páginas, por isso liste-as com GET /api/v1/channels, filtrado por channel e external_ref.
De US$ 9 a US$ 0.75 por ligação por mês, descendo à medida que acrescenta ligações, com os primeiros 3 dias grátis.
Perguntas frequentes
Preciso da minha própria app de programador da Meta para ligar uma Página?
Não. A app da Meta do easyCoexistence pede as permissões da Página, por isso a pessoa inicia sessão com o Facebook e aprova-as, sem app, App Review ou verificação da empresa próprias.
Alguém com acesso a tarefas pode ligar uma Página?
Sim, desde que as tarefas cubram o trabalho: a Meta emite um token de Página a qualquer pessoa que possa executar uma tarefa na Página e depois verifica cada chamada face às tarefas dessa pessoa.
Posso ligar várias Páginas do Facebook?
Sim. Cada Página do início de sessão torna-se uma ligação própria, faturada a US$ 9 a US$ 0.75 por ligação por mês, à medida que o total cresce.
E se a Página já estiver ligada noutro lado?
Não pode entrar numa segunda conta do easyCoexistence enquanto estiver ativa na primeira. Remova-a aí e volte a ligá-la.
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