
Guias de integração
Guia da API do LinkedIn
Guia da API de e-mail
Guia da API do WhatsApp
Fale com vendas
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.
graph.facebook.com/me/accounts?fields=id,name,tasks,access_token access_token: {PAGE_ACCESS_TOKEN_1}
access_token: {PAGE_ACCESS_TOKEN_2}
Um token por Página, admin e app
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.
As Páginas dos seus usuários, sem token de Página para gerenciar
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.
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.
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.
É 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.
GET / POST /{page-id}pages_manage_metadata · MANAGEPOST /{page-id}/feedpages_manage_posts · CREATE_CONTENTGET / POST /{post-id}/commentspages_read_user_content, pages_manage_engagement · MODERATEGET /{page-id}/insightsread_insights, pages_read_engagement · ANALYZEGET /{page-id}/conversationspages_messaging · MESSAGINGPOST /{page-id}/subscribed_appspages_manage_metadata, pages_show_listAs 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.
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.
No Meta for Developers, com o caso de uso "Manage everything on your Page".
App ID + App SecretSolicite pages_show_list e o que as suas funcionalidades exigem.
De curta duração; troque-o no servidor (fb_exchange_token) por um de longa duração.
Cada Página retorna o ID, as tarefas e o token.
GET /me/accountsMeta: "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.
Para testar em uma Página que você gerencia, sem escrever código:
pages_show_list e as permissões que quer testar.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.
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.
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.
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.
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 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.
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.
pages_read_engagementLer 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.
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.
Só pessoas com uma função no app podem conceder permissões.
Uma solicitação por permissão e uma empresa verificada.
Qualquer admin de Página pode conceder as permissões aprovadas.
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:
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.
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, 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.
Um problema em uma Página não afeta a caixa pessoal nem as outras Páginas.
api.unipile.com/v2/{ACCOUNT_ID}/inboxes
200 OK
PAGE_<page_id>_INBOXpost_as (API de posts do Facebook)501 api/not_implemented)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.
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." }'
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.
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.
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.
| Pergunta | Pages API da Meta | Conta conectada Unipile |
|---|---|---|
| Quem conecta a Página | Um admin da Página, pelo Facebook Login for Business no seu app da Meta | O seu usuário, pelo Hosted Auth |
| App da Meta e App Review | Obrigatórios, além de Advanced Access e verificação da empresa | Não são necessários do seu lado |
| Tokens para gerenciar | Um token de Página por Página, admin e app | Nenhum: um account_id e a sua chave de API |
| Mensagens da Página | Messenger Platform, pages_messaging, janela de 24 horas | Ler e responder; uma Página não pode iniciar uma conversa |
| Publicar como a Página | pages_manage_posts | post_as no endpoint de posts |
| Conta pessoal do admin | Indisponível para mensagens | Mesma conexão: chats pessoais, posts e perfil |
| Status por Página | Você verifica cada token por conta própria | page_<page_id> em products_connection_status |
account_id e a sua chave de APIpages_messaging, janela de 24 horaspages_manage_postspost_as no endpoint de postspage_<page_id> em products_connection_statusAinda 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.
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.
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