Iniciar sessãoIniciar teste gratuito
easyCoexistence APIs oficiais

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.

Owner or task

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.

Admin access

Uma pessoa com acesso de Administrador a uma Página na interface do Facebook pode executar todas as tarefas nessa Página.

No expiry

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.

Task access

As pessoas com acesso a tarefas gerem a Página em ferramentas como o Meta Business Suite, e não diretamente no Facebook.

1 hour

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:

pages_show_listAccess the list of Pages a person manages
pages_read_engagementRead content the Page posted, and metadata and insights about the Page
pages_manage_postsCreate, edit and delete the Page's posts
pages_manage_engagementCreate, edit and delete comments posted on the Page
pages_read_user_contentRead what others post on the Page, such as posts, comments and ratings
pages_manage_metadataSubscribe to webhooks about activity on the Page, and update its settings
pages_messagingManage and access the Page's conversations in Messenger
read_insightsRead Insights data for Pages the person owns
business_managementRead and write with the Business Manager API

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.

1New connectionIn the easyCoexistence dashboard
2FacebookFacebook's own login window opens
3ApproveThe Pages and the nine permissions
4ConnectedEach Page ready for Claude, ChatGPT or your code

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.

Create a connect session for a Facebook Page
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

  1. Check your accessMake sure your Facebook account has full control, partial control or task access on the Page.
  2. Start the connectionIn the easyCoexistence dashboard, choose New connection, then Facebook.
  3. Approve the permissionsSign in with Facebook and approve access for the Pages you want to connect.
  4. 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.
Fazer isto com a EasyCoexistence

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