BR
Guia da Pages API

API de Páginas do Facebook: Page access tokens, permissões e um jeito mais simples de conectar Páginas

Page access tokens, tarefas da Página, permissões pages_* e App Review em 2026, e como um app SaaS pode conectar as Páginas que os seus usuários gerenciam.

Page access tokens 200 OK
GETgraph.facebook.com/me/accounts?fields=id,name,tasks,access_token
Northwind BakeryFacebookPágina · controle total
access_token: {PAGE_ACCESS_TOKEN_1}
CREATE_CONTENTMODERATEMESSAGINGANALYZEADVERTISEMANAGE
Harbor YogaFacebookPágina · acesso parcial
access_token: {PAGE_ACCESS_TOKEN_2}
ANALYZEMESSAGING
Requer pages_show_list Facebook Login for Business App Review para Páginas de clientes
TOKEN Um token por Página, admin e app
Resposta curta

A API de Páginas do Facebook (a Meta a chama de Facebook Pages API) é um conjunto de endpoints da Graph API para gerenciar uma Página do Facebook: publicar e ler posts, moderar comentários, ler insights e cuidar das conversas da Página. Cada chamada exige um Page access token, obtido de uma pessoa que pode executar tarefas na Página. Para as suas próprias Páginas, gerenciadas por pessoas com uma função no seu app, não é preciso App Review; atender às Páginas dos seus clientes exige um app aprovado no App Review.

Para um SaaS que atende muitos clientes, existe um segundo modelo: os usuários conectam as contas do Facebook pela Unipile e as Páginas deles vêm junto com a conexão.

Com a Unipile

As Páginas dos seus usuários, sem token de Página para gerenciar

  1. Conecte. O seu usuário conecta a conta do Facebook pelo Hosted Auth e as Páginas dele vêm junto. Sem app da Meta, sem App Review.

  2. Liste as Páginas. Chame GET /v2/{ACCOUNT_ID}/inboxes com a sua X-API-KEY: cada Página é uma inbox PAGE_<page_id>_INBOX.

  3. Aja como a Página. Responda com POST /v2/{ACCOUNT_ID}/chats/{CHAT_ID}/messages/send, ou publique como a Página com post_as.

Definição

O que é a API de Páginas do Facebook?

É a parte da Graph API construída em torno do nó Page: endpoints que leem e alteram uma Página, os posts, os comentários e as métricas dela. As mensagens passam pela Messenger Platform e os anúncios pela Marketing API, com o mesmo Page access token.

Apesar do nome, a Graph API não é GraphQL. É uma API HTTP versionada em graph.facebook.com, organizada em nós, edges e campos. Para o panorama completo (Login, Messenger, versões, rate limits), veja como as APIs do Facebook se encaixam.

Facebook O que a Pages API cobre
Dados da PáginaLer e atualizar os dados e as configurações da PáginaGET / POST /{page-id}pages_manage_metadata · MANAGE
PostsPublicar, ler, editar e excluir posts como a PáginaPOST /{page-id}/feedpages_manage_posts · CREATE_CONTENT
ComentáriosLer, responder e excluir comentários nos posts da Página (guia da API de comentários)GET / POST /{post-id}/commentspages_read_user_content, pages_manage_engagement · MODERATE
InsightsMétricas da Página e dos postsGET /{page-id}/insightsread_insights, pages_read_engagement · ANALYZE
ConversasA caixa de entrada da Página, pela Messenger PlatformGET /{page-id}/conversationspages_messaging · MESSAGING
WebhooksEventos em tempo real no feed e na caixa de entrada da Página, depois que o seu app é instalado na Página pelo edge subscribed_appsPOST /{page-id}/subscribed_appspages_manage_metadata, pages_show_list

Limites de taxa da Facebook Pages API

As chamadas feitas com um Page access token se enquadram nos limites Business Use Case da Meta, contados por Página: 4.800 chamadas multiplicadas pelo número de usuários engajados em 24 horas, sendo usuários engajados as pessoas que interagiram com a Página nesse período. Cada resposta traz um header X-Business-Use-Case-Usage com o seu uso atual. Os limites das outras APIs do Facebook estão no nosso guia da API do Facebook.

Fontes da Meta: visão geral da Pages API, Manage a Page, Page Insights, Webhooks for Pages, Posts, Comments, Page conversations, subscribed_apps, limites de taxa e referência de permissões. Última verificação: 17 de novembro de 2026.

Access token

Como obter um access token de Página do Facebook

Não existe uma chave da API de Páginas do Facebook. Um admin da Página faz login no seu app da Meta com o Facebook Login for Business, o que lhe dá um user access token. Em seguida, GET /me/accounts retorna todas as Páginas que ele gerencia, com as tarefas dele e um Page access token para cada uma.

1

Criar um app da Meta

No Meta for Developers, com o caso de uso "Manage everything on your Page".

App ID + App Secret
2

Adicionar o Facebook Login for Business

Solicite pages_show_list e o que as suas funcionalidades exigem.

Diálogo de login
3

Obter um user access token

De curta duração; troque-o no servidor (fb_exchange_token) por um de longa duração.

{USER_ACCESS_TOKEN}
4

Chamar /me/accounts

Cada Página retorna o ID, as tarefas e o token.

GET /me/accounts

Meta: "os Page access tokens são exclusivos de cada combinação de Página, admin e app." Dez Páginas de clientes, dez tokens para armazenar e monitorar.

A chamada de troca e a requisição /me/accounts estão prontas para copiar na aba "Meta token exchange" do bloco de código abaixo. Os tokens de usuário, de app e de usuário do sistema são explicados no nosso guia sobre o token de acesso da API do Facebook.

Obter um Page access token no Graph API Explorer

Para testar em uma Página que você gerencia, sem escrever código:

  • Escolha o seu app no menu de apps do Graph API Explorer e adicione pages_show_list e as permissões que quer testar.
  • Abra o menu "User or Page", escolha a sua Página e gere o token: o Explorer pede que você conceda as permissões.
  • Copie o token exibido no topo da ferramenta. Ele é de curta duração: troque-o como na etapa 3 por um token de Página que não expira.

Quanto tempo dura um access token de Página do Facebook?

Depende do token de usuário de partida. Um token de Página obtido com um token de usuário de curta duração dura cerca de uma hora. Troque primeiro o token de usuário por um de longa duração, chame /me/accounts de novo e, segundo a Meta, o token de Página obtido não tem data de expiração, embora ainda possa ser invalidado.

Facebook Duração dos tokens, segundo a Meta
Token de usuário de curta duraçãoCerca de uma a duas horas
Token de usuário de longa duraçãoCerca de 60 dias
Token de Página a partir de um token de usuário de curta duração"Válido por 1 hora"
Token de Página a partir de um token de usuário de longa duração"Não têm data de expiração", mas podem ser invalidados

Fontes da Meta: Access Tokens, Long-Lived Access Tokens e Get a Page Access Token; etapas do Graph API Explorer segundo o seu guia. A Meta acrescenta: "não conte com que essas durações continuem as mesmas." Última verificação: 17 de novembro de 2026.

Um access token de Página do Facebook pode nunca expirar?

Sim. Um Page access token de longa duração, obtido chamando /me/accounts com um token de usuário de longa duração, não tem data de expiração. Nas palavras da Meta, os Page access tokens de longa duração "só expiram ou são invalidados em certas condições". É esse o token de Página "permanente" de que a maioria dos guias fala. Ele não é eterno, porém: os eventos abaixo ainda o invalidam, então armazene-o, monitore os erros e preveja um fluxo de reconexão. Para Páginas da sua própria empresa, um token de usuário do sistema é a outra opção.

O que quebra um token de Página em produção

  • O admin perde a função na Página. A Meta só emite tokens de Página para pessoas com uma função na Página; obtenha um novo token com outro admin.
  • O admin sai do seu app, muda a senha ou remove o seu app. Ele precisa fazer login de novo.
  • O seu app perde uma permissão. O acesso para então para todos os clientes de uma vez.

A Meta reporta esses casos como erro 190. Os subcódigos e como verificar um token com debug_token estão detalhados no nosso guia sobre o token de acesso da API do Facebook; para um token de Página, a solução é sempre a mesma: pedir ao admin que se reconecte.

Permissões

Tarefas da Página e permissões: quem pode fazer o quê

Uma chamada só funciona se a pessoa por trás do token puder executar a tarefa correspondente na Página e se o seu app tiver a permissão correspondente, com Advanced Access para pessoas de fora do seu app.

As 8 tarefas da Página

As tarefas são o que uma pessoa pode fazer em uma Página. /me/accounts as lista por Página; um admin pode executar todas.

Facebook Tarefas da Página
ADVERTISECriar anúncios e posts não publicados da Página
ANALYZEVer os insights da Página e qual admin publicou um post ou comentário
CREATE_CONTENTPublicar conteúdo como a Página
MANAGEAtribuir e gerenciar tarefas da Página; também é necessária para atualizar os dados e as configurações da Página
MANAGE_LEADSVer e gerenciar leads
MESSAGINGEnviar mensagens como a Página
MODERATEResponder e excluir comentários nos posts da Página
VIEW_MONETIZATION_INSIGHTSVer os insights de monetização

As permissões pages_* que você vai solicitar

As permissões são o que o seu app pode fazer. Um app da Meta criado com o caso de uso "Manage everything on your Page" começa com pages_show_list, business_management e public_profile. Adicione só o que uma funcionalidade usa: cada permissão é revisada separadamente.

Facebook Permissões pages_*
pages_show_listListar as Páginas que uma pessoa gerencia: o seletor de Páginas depois do login
pages_read_engagementLer o conteúdo, os metadados, os seguidores e os insights da Página
pages_manage_postsCriar, editar e excluir posts da Página
pages_manage_engagementCriar, editar e excluir comentários publicados na Página
pages_read_user_contentLer posts e comentários de visitantes na Página e excluir os comentários deles
read_insightsLer os insights da Página, junto com pages_read_engagement
pages_messagingGerenciar e acessar as conversas da Página no Messenger
pages_manage_metadataAssinar os webhooks da Página e atualizar as configurações da Página

Ler Páginas que você não gerencia é outro caso: exige a funcionalidade Page Public Content Access, que a Meta restringe à análise ou exibição de posts e engajamento de Páginas, com App Review e Business Verification próprios.

Fontes da Meta: visão geral da Pages API (tarefas), Manage a Page (MANAGE para as configurações), Page Insights, referência de permissões (descrições resumidas) e Page Public Content Access. Última verificação: 17 de novembro de 2026.

App Review

App Review: por que funciona na sua Página, mas não nas Páginas dos seus clientes

O seu app começa com Standard Access, e a Meta afirma que "as permissões com Standard Access só podem ser solicitadas a usuários que tenham uma função no app solicitante." O seu protótipo funciona na sua Página e falha quando um cliente faz login. Atender as Páginas dele exige Advanced Access, concedido por permissão pelo App Review.

1Standard Access

Só a sua equipe

Só pessoas com uma função no app podem conceder permissões.

2Revisão

App Review

Uma solicitação por permissão e uma empresa verificada.

3Advanced Access

No ar para os clientes

Qualquer admin de Página pode conceder as permissões aprovadas.

O que um SaaS com vários clientes precisa manter

Depois de entrar no ar, cada Página de cliente é uma pequena integração própria: um login de admin, um token armazenado, as tarefas desse admin, uma verificação de saúde e um fluxo de reconexão. Nada na API de Páginas do Facebook acompanha isso por você entre os tenants. O guia de envio da Meta pede:

  • Uma gravação de tela por permissão, mostrando o usuário concedendo a permissão e a funcionalidade que a usa: "nenhuma permissão ou funcionalidade solicitada sem gravação de tela será aprovada."
  • Uma descrição por permissão, a mais específica possível.
  • Acesso para os revisores: um app público ou instruções para chegar à funcionalidade.
  • Só as permissões de que o seu app precisa.

A Meta também exige a verificação da empresa (Business Verification): "a verificação da empresa é obrigatória para obter o Advanced Access."

Fontes da Meta: níveis de acesso, guia de envio para o App Review e visão geral da Pages API ("todas as permissões e funcionalidades relacionadas a Páginas exigem aprovação pelo processo de App Review"). Última verificação: 17 de novembro de 2026.

Mensagens

Mensagens da Página do Facebook: onde a Pages API passa a vez para o Messenger

As conversas da Página não fazem parte da Pages API em si. Elas passam pela Messenger Platform, com o mesmo Page access token, a permissão pages_messaging e a tarefa MESSAGING.

As pessoas são identificadas por um Page-scoped ID (PSID), elas escrevem primeiro e a Página pode responder durante 24 horas após a última mensagem delas. Como um app SaaS lê e responde essas conversas é explicado na nossa página da API do Facebook Messenger. Para conversas em um perfil pessoal, veja a API do Facebook Messenger para contas pessoais; para o que a Meta cobra, veja os preços da API do Facebook Messenger.

Com a Unipile

Outro modelo: conectar as Páginas que os seus usuários gerenciam

Com a Unipile, o seu usuário conecta a conta do Facebook uma única vez, pelo Hosted Auth. As Páginas que ele administra são ativadas no mesmo account_id, por padrão. Sem app da Meta, sem App Review, sem token de Página do seu lado.

Seu app Sincronizado
Uma conexão
FacebookAnna LeeCaixa pessoal
FacebookNorthwind BakeryCaixa da Página
FacebookHarbor YogaCaixa da Página
Northwind Bakery 2Harbor YogaPessoal
Leo MartinA loja abre no domingo?Página
Sara KimFoto de uma encomenda de boloPágina
Omar HaddadVocê: Pronto ao meio-diaPágina
Status da conexão
Caixa pessoalConectada
Northwind BakeryConectada
Harbor YogaRequer atenção

Um problema em uma Página não afeta a caixa pessoal nem as outras Páginas.

GET api.unipile.com/v2/{ACCOUNT_ID}/inboxes 200 OK
Uma Página conectada pode
  • Ler as mensagens da Página, com cada Página aparecendo como uma caixa de entrada PAGE_<page_id>_INBOX
  • Responder nas conversas da Página
  • Publicar posts como a Página, com o parâmetro post_as (API de posts do Facebook)
  • Ler os posts da Página
Ela não pode
  • Iniciar uma nova conversa: a pessoa escreve primeiro
  • Excluir as próprias mensagens (501 api/not_implemented)
  • Publicar Stories
  • Usar os Grupos do Facebook

Cada Página informa o próprio estado em metadata.products_connection_status (chave page_<page_id>). A mesma conexão traz as mensagens pessoais do admin, e a mesma API cobre LinkedIn, WhatsApp, Instagram, Telegram, e-mail e calendários.

A mesma tarefa em código

Liste as Páginas e depois responda a uma conversa da Página. A aba "Meta Graph API" usa um token de Página, a aba "Meta token exchange" mostra como obter um token de Página que não expira e a aba "Unipile" usa a conta conectada.

# 1. List the Pages a person manages, with tasks and Page tokens
curl "https://graph.facebook.com/me/accounts?fields=id,name,tasks,access_token&access_token={USER_ACCESS_TOKEN}"

# Response (abridged)
{ "data": [ {
    "id": "{PAGE_ID}",
    "name": "Northwind Bakery",
    "tasks": ["CREATE_CONTENT", "MODERATE", "MESSAGING", "ANALYZE"],
    "access_token": "{PAGE_ACCESS_TOKEN}"
} ] }

# 2. Store one token per Page, then call Page endpoints with it
curl "https://graph.facebook.com/{PAGE_ID}/conversations?platform=messenger&access_token={PAGE_ACCESS_TOKEN}"
# 1. Server side: exchange the short lived user token for a long lived one
curl "https://graph.facebook.com/oauth/access_token?grant_type=fb_exchange_token&client_id={APP_ID}&client_secret={APP_SECRET}&fb_exchange_token={SHORT_LIVED_USER_TOKEN}"

# Response
{ "access_token": "{LONG_LIVED_USER_TOKEN}", "token_type": "bearer", "expires_in": 5183944 }

# 2. Call /me/accounts with the long lived user token:
#    the Page tokens it returns have no expiration date
curl "https://graph.facebook.com/me/accounts?fields=id,name,tasks,access_token&access_token={LONG_LIVED_USER_TOKEN}"
# 1. List the inboxes of the connected account: one per managed Page,
#    with the ID PAGE_{PAGE_ID}_INBOX
curl --request GET \
  --url "https://api.unipile.com/v2/{ACCOUNT_ID}/inboxes" \
  --header "X-API-KEY: {YOUR_API_KEY}"

# 2. List the chats of one Page inbox
curl --request GET \
  --url "https://api.unipile.com/v2/{ACCOUNT_ID}/inboxes/PAGE_{PAGE_ID}_INBOX/chats" \
  --header "X-API-KEY: {YOUR_API_KEY}"

# 3. Reply in a Page chat (chat ID PAGE_{PAGE_ID}_{THREAD_KEY})
curl --request POST \
  --url "https://api.unipile.com/v2/{ACCOUNT_ID}/chats/{CHAT_ID}/messages/send" \
  --header "X-API-KEY: {YOUR_API_KEY}" \
  --header "content-type: application/json" \
  --data '{ "text": "Yes, we open at 9am on Sunday." }'
200 OK · um Page access token por Página, admin e app
200 OK · expires_in é em segundos: cerca de 60 dias para o token de usuário
200 OK · um account_id para a caixa pessoal e todas as Páginas

Chamadas da Meta conferidas com Long-Lived Access Tokens em 17 de novembro de 2026. A ativação, os IDs das caixas de entrada e o post_as são detalhados na documentação de Páginas do Facebook.

Conformidade

Cada usuário conecta a própria conta

A Unipile é uma empresa independente, não é um app oficial da Meta nem um Meta Partner. Ela se conecta em nome de cada usuário autenticado, e cada usuário continua sujeito aos termos da Meta. Use-a para conversas com clientes nas Páginas que os seus usuários gerenciam.

Decisão

Pages API ou conta conectada: qual combina com o seu produto?

A Pages API da Meta serve para uma equipe que gerencia as próprias Páginas ou precisa de insights e anúncios. Uma conta conectada serve para um SaaS cujos usuários trazem as próprias Páginas.

PerguntaPages API da MetaConta conectada Unipile
Quem conecta a PáginaUm admin da Página, pelo Facebook Login for Business no seu app da MetaO seu usuário, pelo Hosted Auth
App da Meta e App ReviewObrigatórios, além de Advanced Access e verificação da empresaNão são necessários do seu lado
Tokens para gerenciarUm token de Página por Página, admin e appNenhum: um account_id e a sua chave de API
Mensagens da PáginaMessenger Platform, pages_messaging, janela de 24 horasLer e responder; uma Página não pode iniciar uma conversa
Publicar como a Páginapages_manage_postspost_as no endpoint de posts
Conta pessoal do adminIndisponível para mensagensMesma conexão: chats pessoais, posts e perfil
Status por PáginaVocê verifica cada token por conta própriapage_<page_id> em products_connection_status
Quem conecta a Página
Pages API da MetaUm admin da Página, pelo Facebook Login for Business no seu app da Meta
UnipileO seu usuário, pelo Hosted Auth
App da Meta e App Review
Pages API da MetaObrigatórios, além de Advanced Access e verificação da empresa
UnipileNão são necessários do seu lado
Tokens para gerenciar
Pages API da MetaUm token de Página por Página, admin e app
UnipileNenhum: um account_id e a sua chave de API
Mensagens da Página
Pages API da MetaMessenger Platform, pages_messaging, janela de 24 horas
UnipileLer e responder; uma Página não pode iniciar uma conversa
Publicar como a Página
Pages API da Metapages_manage_posts
Unipilepost_as no endpoint de posts
Conta pessoal do admin
Pages API da MetaIndisponível para mensagens
UnipileMesma conexão: chats pessoais, posts e perfil
Status por Página
Pages API da MetaVocê verifica cada token por conta própria
Unipilepage_<page_id> em products_connection_status

Ainda escolhendo entre Login, Messenger, Marketing API e Pages? A nossa grade de decisão mostra qual API do Facebook você precisa para cada tipo de produto.

Conecte Páginas sem um pipeline de tokens

Deixe cada usuário vincular a conta do Facebook uma única vez e trabalhe com as caixas de entrada e os posts das Páginas dele pela mesma API das contas de LinkedIn, WhatsApp e e-mail. Teste grátis de 7 dias, sem cartão de crédito.

Comissão Europeia
Regulamentado pela UE Digital Markets Act (DMA)

Cada usuário conecta a própria conta, sem armazenamento de perfis. A Unipile não é Meta Partner. Saiba mais

Todos os endpoints da API do Facebook em um só lugar

As Páginas são só uma parte do panorama. Veja todos os endpoints do Facebook disponíveis com a Unipile (mensagens, posts, comentários, perfis, webhooks), ou leia o guia completo da API do Facebook.

Perguntas frequentes sobre a API de Páginas do Facebook

Respostas rápidas sobre o access token de Página do Facebook, a duração dele, o App Review e as permissões.

Faça um admin da Página entrar no seu app da Meta com o Facebook Login for Business, solicitando pages_show_list. Troque o token de usuário por um de longa duração no seu servidor com grant_type=fb_exchange_token e chame GET /me/accounts: cada Página é retornada com o próprio access_token e as tarefas que o admin pode executar.

Depende do token de usuário por trás dele. Segundo a Meta, um token de Página obtido com um token de usuário de curta duração vale por 1 hora. Obtido a partir de um token de usuário de longa duração (cerca de 60 dias), o token de Página não tem data de expiração, embora um logout, uma troca de senha ou a remoção do app ainda o invalidem.

Sim. Chame /me/accounts com um token de usuário de longa duração e os tokens de Página retornados não têm data de expiração. Eles não são permanentes em todos os casos: se o admin perder a função na Página, mudar a senha ou remover o seu app, o token para de funcionar e o admin precisa se reconectar.

O seu app só tem Standard Access, então só pessoas com uma função no app podem conceder permissões a ele. Para atender as Páginas dos clientes, cada permissão precisa de Advanced Access, concedido pelo App Review com uma gravação de tela por permissão, e a Meta exige a verificação da empresa (Business Verification) para isso.

Quase toda integração começa com pages_show_list. Depois, adicione só o que você usa: pages_read_engagement para ler conteúdo e metadados, pages_manage_posts para publicar, pages_manage_engagement para comentários, pages_messaging para conversas, pages_manage_metadata para webhooks e configurações e read_insights para métricas.

Não. A Unipile é uma empresa independente, não é um Meta Partner e não é endossada, patrocinada nem aprovada pela Meta. Conectar Páginas pela Unipile também não transforma o seu produto em um app da Meta. Facebook e Messenger são marcas registradas da Meta Platforms, Inc.

Não. Em vez de um app da Meta coletando Page access tokens, os seus usuários conectam a conta do Facebook uma única vez pela autenticação hospedada da Unipile, e as Páginas que administram vêm junto com essa conexão. Não há App Review, Advanced Access nem Business Verification a cumprir do seu lado.

Ela foi construída no espírito do Digital Markets Act: cada admin de Página conecta a própria conta, a Unipile age em nome dele nas Páginas que ele já gerencia e não armazena perfis de usuários. Os detalhes estão na nossa página sobre o Digital Markets Act.

Sim. Uma Página conectada pela Unipile continua regida pelos Termos de Serviço e pelas políticas de Páginas da Meta. Limite-se a usos legítimos, como responder a clientes na caixa de entrada da Página, publicar o conteúdo da própria Página ou sincronizar conversas com um CRM; spam e automação não autorizada podem levar à restrição da conta ou da Página.

Ainda tem dúvidas? Nossa equipe está aqui para ajudar.

Fale com um especialista