Guia da API de Páginas do Facebook para 2026: do seu app à primeira publicação
O caminho da API de Páginas do Facebook em 2026 parte de um app da Meta com o caso de uso Gerenciar tudo na sua Página, passa pelo Facebook Login for Business e chega a um token de acesso da Página, lido de /me/accounts, e a um primeiro POST para /{page-id}/feed na Graph API v26.0. Comentários, respostas no Messenger, webhooks e insights rodam então com o mesmo token da Página, cada um com sua própria permissão.
O app da Meta do easyCoexistence detém as permissões da Página, então um único login com o Facebook conecta uma Página, e o Claude, o ChatGPT ou a sua própria plataforma publica, agenda, responde a comentários e DMs, recebe os eventos da Página e lê os seus insights pela API oficial da Meta, com cada conexão verificada a cada 6 horas e um e-mail quando ela precisar ser reconectada.
A versão mais recente da Graph API, lançada em 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 um primeiro post, em uma Página publicada ou não publicada.
O maior ícone de app que a Meta aceita quando o app é publicado: de 512 x 512 a 1024 x 1024 pixels, em JPEG, GIF ou PNG.
Por quanto tempo a Meta mantém os dados de Insights de uma Página não publicada; os de uma Página pública são mantidos por 2 anos.
Quais são as etapas de um app da Meta até o primeiro post?
Cinco, em ordem fixa, porque cada uma depende da anterior: o app detém as permissões, o login as concede, a concessão gera o token da Página, e o token assina as chamadas. Comentários, Messenger, webhooks e insights vêm depois do primeiro post e reutilizam o mesmo token. As seções abaixo seguem as etapas em ordem e depois o trabalho que vem em seguida.
Como criar o app da Meta?
No Painel de Apps: crie um app, escolha o caso de uso Gerenciar tudo na sua Página e depois personalize-o para adicionar as permissões opcionais de que você precisa. Pronto para teste marca cada caso de uso como testado, o que a Revisão do app exige, e o Graph API Explorer executa consultas de teste com tokens e exemplos de código. Um app que vai funcionar nas Páginas de outras empresas é configurado como Tech Provider em Torne-se um Tech Provider, o que acrescenta perguntas sobre dados, a Revisão do app e um Portfólio de Negócios verificado. A configuração completa está na página de acesso à Graph API.
Onde se encaixa o Facebook Login for Business?
É assim que quem administra a Página concede acesso ao app, e a Meta o chama de login preferido para Tech Providers que criam sobre as suas ferramentas de negócios. As configurações recebem uma Redirect URI, uma URL de Deauthorize Callback e uma URL de Data Deletion Request; em seguida, uma configuração define o tipo de token, os ativos e as permissões, e o seu config_id entra no diálogo de login no lugar onde ficaria o scope. Depois que a pessoa aprova, o Facebook devolve um code que o seu servidor troca por um token de usuário.
Quais permissões e nível de acesso um app de Página precisa?
Uma permissão pages_ por tipo de trabalho, cada uma concedida no login: 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 por baixo delas. O Acesso Padrão cobre pessoas com um papel no app; Páginas administradas por qualquer outra pessoa precisam do Acesso Avançado, por meio da Revisão do app e da Verificação de Negócios. A Verificação de Acesso não é mais uma das etapas, já que a Meta a aposentou para apps Tech Provider em outubro de 2026. As dependências de cada permissão estão na página de permissões.
Como o app obtém o token da Página?
Por GET /me/accounts, chamado com um token de usuário de longa duração. O token da Página segue o token de usuário do qual veio: lido com o token de curta duração de um login recente, expira em horas, enquanto lido com um token de usuário de longa duração, obtido no servidor com fb_exchange_token, não tem data de expiração. Cada item da resposta traz o ID e o nome da Página, as tarefas da pessoa nela e o token próprio daquela Página, exclusivo para essa Página, pessoa e app. A página de tokens explica o que ainda pode encerrar um deles.
Como publicar um primeiro post?
Com POST /{page-id}/feed, uma message e o token da Página de alguém que pode executar a tarefa CREATE_CONTENT. A Meta responde com o ID do novo post, escrito {page-id}_{post-id}, e o post aparece com a voz da Página. Um campo link o transforma em post de link, e published definido como false com scheduled_publish_time o deixa guardado para depois. O próprio exemplo do guia Get Started da Meta envia os campos como 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 a Página responde a comentários?
Ela lê os comentários com GET /{page-post-id}/comments e responde como Página com POST /{comment-id}/comments e uma message. O token precisa vir de alguém que pode executar a tarefa MODERATE, ou a Meta deixa de fora os IDs dos comentários, e responder também exige pages_manage_engagement. filter=stream devolve comentários de todos os níveis em ordem cronológica. Um comentário também pode receber uma resposta privada no Messenger, enviada em até 7 dias após ele, e is_hidden no comentário o oculta ou o exibe de novo.
Como o Messenger se encaixa?
Pelo mesmo token da Página e POST /{page-id}/messages, depois que a pessoa escreveu: a mensagem dela abre uma janela de 24 horas para respostas com messaging_type RESPONSE, endereçadas ao ID com escopo de Página que veio com o webhook. O token precisa vir de alguém que pode executar a tarefa MESSAGING e ter pages_messaging. Depois da janela, só uma tag de mensagem, como HUMAN_AGENT, pode alcançar a pessoa, e desde 27 de abril de 2026 três tags antigas retornam erro 100, como explica a página de tags de mensagem.
Como os webhooks chegam ao seu servidor?
Por três partes: um endpoint HTTPS que responde à verificação hub.challenge da Meta, o produto Webhooks no Painel de Apps configurado 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 o app nessa Página. A Meta não envia nada para uma Página que não instalou o app ou que desativou a plataforma App em suas Configurações do App. Cada evento chega assinado em X-Hub-Signature-256, que o seu endpoint verifica com o segredo do app.
Como ler os insights da Página?
Com GET /{page-id}/insights, uma lista de métricas separadas por vírgula e um período de day, week ou days_28, usando um token de alguém que pode executar a tarefa ANALYZE, com read_insights e pages_read_engagement concedidas. As métricas que funcionam no fim de 2026 incluem page_media_view, page_total_media_view_unique, page_post_engagements e page_follows, e cada requisição cobre no máximo 90 dias por meio de since e until. Os dados de uma Página pública retroagem 2 anos.
Quais limites moldam o design?
Alguns poucos, definidos pela Meta e documentados com cada API, e eles decidem como uma integração enfileira o seu trabalho:
- Chamadas da API de Páginas com token de Página: 4,800 por usuário engajado da Página em 24 horas corridas.
- Send API do Messenger: 300 chamadas por segundo por Página para texto, links, reações e stickers, 10 para áudio ou vídeo.
- Conversations API: 2 chamadas por segundo por Página.
- Posts agendados com o
scheduled_publish_timepróprio da Meta: entre 10 minutos e 30 dias após a requisição; a fila do easyCoexistence aceita de 1 minuto a 90 dias. - Reels: 30 publicados pela API em um período móvel de 24 horas, aplicado em /{page-id}/
video_reels. - Respostas privadas: uma por comentário, em até 7 dias após ele.
Qual é o caminho mais curto pelo easyCoexistence?
A mesma API com a configuração já feita. O app da Meta do easyCoexistence detém as permissões, então quem administra a Página entra com o Facebook uma vez, e o Claude, o ChatGPT ou a sua própria plataforma começa no primeiro post. Cada etapa acima corresponde a algo que já funciona:
Erros comuns
- Fixar uma versão da Graph API perto do fim da vida útil. A v20.0 foi removida em 24 de setembro de 2026, e a v21.0 sai em 21 de janeiro de 2027, depois do qual as suas chamadas passam para a versão seguinte; migre para a v26.0 de forma intencional.
- Testar apenas com contas que têm um papel no app. Em desenvolvimento elas podem conceder qualquer permissão, então um fluxo que funciona para a equipe pode falhar para um cliente até que o Acesso Avançado seja aprovado.
- Pedir permissões que o app não vai usar. Cada uma precisa de uma chamada bem-sucedida nos 30 dias anteriores à Revisão do app, e uma sem uso por 90 dias pode expirar e precisa ser concedida de novo.
- Passar apenas o ID do post. Os posts de Página voltam como {page-id}_{post-id}, e comentários, edições e insights do post usam esse valor completo.
De US$ 9 a US$ 0.75 por conexão por mês, com queda conforme você adiciona conexões, e os primeiros 3 dias grátis.
O easyCoexistence é uma API e um servidor MCP multicanal que conecta agentes de IA, como o Claude e o ChatGPT, ao WhatsApp, Instagram, TikTok, Facebook e mais. No WhatsApp, ele usa o Coexistence: a empresa continua usando o número no app WhatsApp Business enquanto a IA trabalha pela API oficial da Meta.
Perguntas frequentes
Posso criar e testar em uma Página não publicada?
Sim. O guia Get Started da Meta funciona em uma Página publicada ou não publicada em que você possa executar CREATE_CONTENT, então uma Página de teste oculta basta; a Meta mantém os insights de uma Página não publicada por apenas 5 dias.
Qual versão da Graph API uma nova integração de Página deve usar?
A v26.0, a mais recente desde 29 de julho de 2026. A Meta mantém cada versão funcionando por pelo menos dois anos, então fixe a versão em cada URL e avance de forma deliberada, e não por padrão.
Um mesmo app da Meta pode atender Páginas de outras empresas?
Sim, como app Tech Provider: as suas permissões precisam de Acesso Avançado por meio da Revisão do app, e a empresa por trás do app precisa concluir a Verificação de Negócios antes de acessar dados que pertencem a outras empresas.
Quanto custa o easyCoexistence para uma Página do Facebook?
Cada Página é uma conexão, cobrada de US$ 9 a US$ 0.75 por conexão por mês conforme o seu total cresce, e os primeiros 3 dias são grátis, sem nenhum app próprio da Meta para manter.
Continue lendo
Conecte seu primeiro canal em dois minutos.
Sem esperar aprovação das plataformas. Conecte o WhatsApp, o Instagram, o TikTok ou outro canal, peça para a sua IA publicar, responder ou trazer os números, e veja funcionando.
- 3 dias grátis
- Cancele quando quiser
- Só APIs oficiais
- Monitorado 24/7
Verificado em