Guia da API de Páginas do Facebook para 2026: da sua app à primeira publicação
O caminho da API de Páginas do Facebook em 2026 vai de uma app Meta com o caso de uso Manage everything on your Page, passando pelo Facebook Login for Business, até um token de acesso da Página lido em /me/accounts e a um primeiro POST para /{page-id}/feed na Graph API v26.0. Os comentários, as respostas no Messenger, os webhooks e as métricas funcionam depois com o mesmo token da Página, cada um com a sua própria permissão.
A app Meta do easyCoexistence detém as permissões da Página, por isso um único início de sessão com o Facebook liga uma Página, e o Claude, o ChatGPT ou a sua própria plataforma publica, agenda, responde a comentários e mensagens diretas, recebe os eventos da Página e lê as suas métricas através da API oficial da Meta, com cada ligação verificada de 6 em 6 horas e um e-mail quando for preciso voltar a ligá-la.
A versão mais recente da Graph API, lançada a 29 de julho de 2026; a v25.0 continua disponível até 29 de julho de 2028.
A tarefa de Página que o guia Get Started da Meta pede para publicar uma primeira publicação, numa Página publicada ou não publicada.
O maior ícone de app que a Meta aceita quando a app é publicada: de 512 x 512 a 1024 x 1024 pixels, em JPEG, GIF ou PNG.
Durante quanto tempo a Meta guarda os dados de métricas de uma Página não publicada; os de uma Página pública são guardados durante 2 anos.
Quais são os passos de uma app Meta até à primeira publicação?
Cinco, por ordem fixa, porque cada um depende do anterior: a app detém as permissões, o início de sessão concede-as, a concessão produz o token da Página e o token assina os pedidos. Os comentários, o Messenger, os webhooks e as métricas vêm depois da primeira publicação e reutilizam esse mesmo token. As secções seguintes tratam os passos por ordem e depois o trabalho que se segue.
Como se cria a app Meta?
No painel da app: crie uma app, escolha o caso de uso Manage everything on your Page e depois personalize-a para acrescentar as permissões opcionais de que precisa. Ready to test marca cada caso de uso como testado, o que o App Review exige, e o Graph API Explorer executa consultas de teste com tokens e exemplos de código. Uma app que vai funcionar nas Páginas de outras empresas é configurada como Tech Provider em Become a Tech Provider, o que acrescenta perguntas sobre dados, o App Review e um portefólio empresarial verificado. A configuração completa está na página de acesso à Graph API.
Onde entra o Facebook Login for Business?
É a forma como quem gere a Página concede acesso à app, e a Meta chama-lhe o início de sessão preferido para os Tech Providers que desenvolvem com as suas ferramentas empresariais. As suas definições recebem um Redirect URI, um Deauthorize Callback URL e um Data Deletion Request URL; depois, uma configuração indica o tipo de token, os recursos e as permissões, e o seu config_id vai no diálogo de início de sessão onde, de outra forma, estaria o scope. Depois de a pessoa aprovar, o Facebook devolve um código que o seu servidor troca por um token de utilizador.
Que permissões e nível de acesso precisa uma app de Página?
Uma permissão pages_ por tipo de trabalho, concedida em cada início de sessão: pages_manage_posts para publicar, pages_read_engagement e pages_read_user_content para ler, pages_manage_engagement para responder a comentários, pages_messaging para o Messenger, pages_manage_metadata para webhooks e read_insights para métricas, com pages_show_list na base. O Standard Access abrange pessoas com uma função na app; as Páginas geridas por outras pessoas precisam de Advanced Access, através do App Review e da Business Verification. A Access Verification já não é um dos passos, pois a Meta a retirou para as apps Tech Provider em outubro de 2026. As dependências de cada permissão estão na página de permissões.
Como é que a app obtém o token da Página?
A partir de GET /me/accounts, chamado com um token de utilizador de longa duração. O token da Página segue o token de utilizador de onde veio: lido com o token de curta duração de um início de sessão novo, expira em horas, ao passo que lido com um token de utilizador de longa duração, obtido no servidor com fb_exchange_token, não tem data de expiração. Cada entrada da resposta indica o ID e o nome da Página, as tarefas da pessoa nela e o token próprio dessa Página, único para essa Página, pessoa e app. A página sobre tokens explica o que ainda pode terminar um deles.
Como se faz a primeira publicação?
Com POST /{page-id}/feed, um campo message e o token da Página de alguém que possa executar a tarefa CREATE_CONTENT. A Meta responde com o ID da nova publicação, escrito {page-id}_{post-id}, e a publicação surge com a voz da Página. Um campo link transforma-a numa publicação de ligação, e published definido como false com scheduled_publish_time mantém-na para mais tarde. O exemplo do próprio guia Get Started da Meta envia os campos em JSON:
curl -X POST "https://graph.facebook.com/v26.0/{page-id}/feed" \
-H "Content-Type: application/json" \
-d '{
"message": "Our first post through the API",
"access_token": "{page-access-token}"
}'
# {"id": "{page-id}_{post-id}"}Como é que a Página responde a comentários?
Lê-os com GET /{page-post-id}/comments e responde como Página com POST /{comment-id}/comments e um campo message. O token tem de vir de alguém que possa executar a tarefa MODERATE, senão a Meta omite os IDs dos comentários, e responder exige também pages_manage_engagement. filter=stream devolve os comentários de todos os níveis por ordem cronológica. Um comentário pode ainda receber uma resposta privada no Messenger, enviada no prazo de 7 dias, e is_hidden no comentário oculta-o ou volta a mostrá-lo.
Como encaixa o Messenger?
Através do mesmo token da Página e de POST /{page-id}/messages, depois de uma pessoa ter escrito: a mensagem dela abre uma janela de 24 horas para respostas com messaging_type RESPONSE, dirigidas ao ID de âmbito da Página que veio com o webhook. O token tem de vir de alguém que possa executar a tarefa MESSAGING e ter pages_messaging. Depois da janela, só uma etiqueta de mensagem, como HUMAN_AGENT, pode chegar à pessoa, e desde 27 de abril de 2026 três etiquetas antigas devolvem o erro 100, como explica a página sobre etiquetas de mensagem.
Como chegam os webhooks ao seu servidor?
Através de três peças: um endpoint HTTPS que responde à verificação hub.challenge da Meta, o produto Webhooks no painel da app definido para o objeto Page com campos como feed e messages, e POST /{page-id}/subscribed_apps com o token de cada Página, que instala a app nessa Página. A Meta não envia nada para uma Página que não tenha instalado a app ou que tenha desativado a plataforma App nas suas Definições da app. Cada evento chega assinado em X-Hub-Signature-256, que o seu endpoint verifica com o segredo da app.
Como se leem as métricas da Página?
Com GET /{page-id}/insights, uma lista de métricas separadas por vírgulas e um período de day, week ou days_28, usando um token de alguém que possa executar a tarefa ANALYZE, com read_insights e pages_read_engagement concedidas. As métricas que funcionam no final de 2026 incluem page_media_view, page_total_media_view_unique, page_post_engagements e page_follows, e um pedido abrange no máximo 90 dias através de since e until. Os dados de uma Página pública recuam 2 anos.
Que limites moldam a conceção?
Alguns poucos, definidos pela Meta e documentados com cada API, e decidem a forma como uma integração põe o trabalho em fila:
- Chamadas da API de Páginas com um token da Página: 4 800 por utilizador que interagiu com a Página, num período móvel de 24 horas.
- Send API do Messenger: 300 chamadas por segundo por Página para texto, ligações, reações e autocolantes, 10 para áudio ou vídeo.
- Conversations API: 2 chamadas por segundo por Página.
- Publicações agendadas com o
scheduled_publish_timeda própria Meta: entre 10 minutos e 30 dias após o pedido; a fila da easyCoexistence aceita de 1 minuto a 90 dias. - Reels: 30 publicados através da API num período móvel de 24 horas, aplicados em /{page-id}/
video_reels. - Respostas privadas: uma por comentário, no prazo de 7 dias a contar deste.
Qual é o caminho mais curto através do easyCoexistence?
A mesma API com a configuração já feita. A app Meta do easyCoexistence detém as permissões, por isso quem gere a Página inicia sessão com o Facebook uma única vez, e o Claude, o ChatGPT ou a sua própria plataforma começa na primeira publicação. Cada passo acima corresponde a algo que já está em funcionamento:
Erros comuns
- Fixar uma versão da Graph API perto do fim da sua vida. A v20.0 foi retirada a 24 de setembro de 2026 e a v21.0 termina a 21 de janeiro de 2027, depois do que as chamadas passam para a versão seguinte; passe para a v26.0 de forma deliberada.
- Testar só com contas que têm uma função na app. Em desenvolvimento, estas podem conceder qualquer permissão, por isso um fluxo que funciona para a equipa pode falhar para um cliente até o Advanced Access ser aprovado.
- Pedir permissões que a app não vai usar. Cada uma precisa de uma chamada bem-sucedida nos 30 dias anteriores ao App Review, e uma que fique sem uso durante 90 dias pode expirar e tem de ser concedida de novo.
- Passar apenas o ID de uma publicação. As publicações da Página voltam como {page-id}_{post-id}, e os comentários, as edições e as métricas da publicação usam esse valor completo.
De US$ 9 a US$ 0.75 por ligação por mês, com preço a descer à medida que acrescenta ligações, e os primeiros 3 dias são gratuitos.
Perguntas frequentes
Posso criar e testar numa Página não publicada?
Sim. O guia Get Started da Meta funciona numa Página publicada ou não publicada onde possa executar CREATE_CONTENT, por isso uma Página de teste oculta basta; a Meta guarda as métricas de uma Página não publicada apenas durante 5 dias.
Que versão da Graph API deve usar uma nova integração de Página?
A v26.0, a mais recente desde 29 de julho de 2026. A Meta mantém cada versão a funcionar durante pelo menos dois anos, por isso fixe a versão em cada URL e avance de forma deliberada, e não por omissão.
Pode uma só app Meta servir as Páginas de outras empresas?
Sim, como app Tech Provider: as suas permissões precisam de Advanced Access através do App Review, e a empresa por detrás da app tem de concluir a Business Verification antes de aceder a dados que pertencem a outras empresas.
Quanto custa o easyCoexistence para uma Página do Facebook?
Cada Página é uma ligação, cobrada de US$ 9 a US$ 0.75 por ligação por mês à medida que o total cresce, e os primeiros 3 dias são gratuitos, sem app Meta própria para manter.
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