BR
Guia para desenvolvedores

Guia da API do Facebook: Graph API, acesso, limites e contas conectadas

O que as APIs do Facebook da Meta cobrem em 2026, como obter access tokens e passar pelo App Review, o que a API oficial não permite mais e como um app SaaS pode conectar as próprias contas do Facebook dos seus usuários.

Seu app Ao vivo
FacebookAnna LeePessoal FacebookNorthwind BakeryPágina
Post
Northwind BakeryComo Página · Agora

Nosso cardápio de outono chega na segunda.

243
Julia NashO pão de abóbora voltou!
Mensagens
Maya RossPara Northwind Bakery
Vocês entregam aos domingos?
Sim, das 9h ao meio-dia.
Visto
Webhooks Nova mensagem Nova reação
GETchats POSTmessages/send POSTposts 200 OK
Resposta curta

Sim, o Facebook tem uma API: a Graph API, a interface HTTP da Meta para ler e gravar dados do Facebook. Produtos como a Pages API, a Messenger Platform e a Marketing API são construídos sobre ela. O acesso passa por um app da Meta, por access tokens concedidos por usuários ou Páginas e por permissões aprovadas no App Review.

Este guia relaciona cada API do Facebook ao tipo de conta que ela atende, explica o acesso e os limites, lista o que a Meta removeu e depois mostra outro modelo para apps SaaS: deixar cada usuário conectar a própria conta do Facebook pela API do Facebook Messenger da Unipile.

Definição

Existe uma API do Facebook?

Sim. A Meta expõe os dados do Facebook aos desenvolvedores pela Graph API, uma API HTTP versionada. Todos os outros produtos para desenvolvedores do Facebook, da gestão de Páginas ao Messenger e aos anúncios, são conjuntos de endpoints da Graph API com permissões e revisão próprias.

Não existe uma chave de API única. O que você obtém depende de quem são os dados: uma pessoa que faz login no seu app, uma Página do Facebook que ela gerencia ou uma conta de anúncios. Cada caso tem seu próprio tipo de token e sua própria revisão pela Meta.

Facebook De quem são os dados que você lê?
Um usuárioUser access token do Facebook Login, limitado às permissões que a pessoa concede.
Uma PáginaPage access token, para quem tem uma tarefa nessa Página.
Uma conta de anúnciosAcesso à Marketing API por meio de uma empresa e dos seus usuários do sistema.
Graph API

O que é a Graph API do Facebook?

A Graph API é a API HTTP por trás de toda integração com o Facebook. Todas as requisições vão para graph.facebook.com, e quase todo endpoint exige um access token. Os dados são organizados como um grafo de nós, arestas e campos.

Nodes

Objetos

Um objeto único com um ID: um usuário, uma Página, um post, um comentário, uma foto. Exemplo: GET /{page-id}.

Edges

Conexões

Coleções ligadas a um nó, como os posts de uma Página ou os comentários de um post. Exemplo: GET /{page-id}/feed.

Fields

Propriedades

Os dados que você pede sobre um nó, selecionados com o parâmetro fields. Exemplo: ?fields=id,message,created_time.

Versões e o Graph API Explorer

Cada requisição pode indicar uma versão no caminho, como /v27.0/, lançada em 4 de novembro de 2026. A Meta lança várias versões por ano e mantém cada uma por pelo menos dois anos, então planeje as atualizações: o changelog informa até que data cada versão continua disponível. O Graph API Explorer permite testar chamadas antes de escrever código, e a aba Meta Graph API do exemplo de código abaixo mostra uma primeira requisição: ler o feed de uma Página.

Fonte: changelog da Graph API da Meta, que indicava a v27.0 (lançada em 4 de novembro de 2026) como versão mais recente. Última verificação: 17 de novembro de 2026.

Mapa

As APIs do Facebook em resumo

Cada API do Facebook atende a um tipo de conta. Escolher a certa começa com uma pergunta simples: você age em nome de uma pessoa, de uma Página ou de um anunciante?

APIO que fazConta atendidaAcesso necessário
Graph APILê e grava objetos do FacebookUsuários, Páginas, empresasApp da Meta, access token, permissões
Pages APIPublica posts, modera comentários, lê dados da Página. Guia: API de posts do FacebookPáginas do FacebookPage access token, tarefas da Página, App Review
Messenger PlatformEnvia e recebe conversas da PáginaPáginas do Facebook e contas profissionais do InstagramPage token, permissão de mensagens, App Review
Marketing APICria anúncios e lê o desempenho delesContas de anúnciosVerificação da empresa, permissões de anúncios
Conversions APIEnvia eventos web e offline para anúnciosEmpresas que anunciamPixel ou conjunto de dados, system user token
Facebook LoginFaz o login das pessoas no seu appUsuários do FacebookApp da Meta com Facebook Login
Graph API
O que fazLê e grava objetos do Facebook
ContaUsuários, Páginas, empresas
AcessoApp da Meta, access token, permissões
Pages API
O que fazPublica posts, modera comentários, lê dados da Página. Guia: API de posts do Facebook
ContaPáginas do Facebook
AcessoPage access token, tarefas da Página, App Review
Messenger Platform
O que fazEnvia e recebe conversas da Página
ContaPáginas do Facebook e contas profissionais do Instagram
AcessoPage token, permissão de mensagens, App Review
Marketing API
O que fazCria anúncios e lê o desempenho deles
ContaContas de anúncios
AcessoVerificação da empresa, permissões de anúncios
Conversions API
O que fazEnvia eventos web e offline para anúncios
ContaEmpresas que anunciam
AcessoPixel ou conjunto de dados, system user token
Facebook Login
O que fazFaz o login das pessoas no seu app
ContaUsuários do Facebook
AcessoApp da Meta com Facebook Login

As mensagens no Instagram passam pela mesma Messenger Platform: veja nosso guia da API do Messenger para Instagram. O WhatsApp tem sua própria plataforma, explicada no guia da API do WhatsApp.

Decisão

De qual API do Facebook você precisa?

Parta do que o seu produto faz, não da lista de APIs. Cada situação abaixo aponta para uma API e seus requisitos de acesso.

Você publica na sua própria Página

Pages API

Page access token de um administrador da Página, tarefas da Página, App Review. Guia da API de Páginas do Facebook.

Você responde a quem envia mensagens para a sua Página

Messenger Platform

Page token, pages_messaging, janela de mensagens de 24 horas.

Você veicula ou mede anúncios

Marketing API e Conversions API

Acesso à conta de anúncios, verificação da empresa, usuários do sistema.

Você permite login com o Facebook

Facebook Login

Um app da Meta com o Facebook Login configurado.

Seus usuários conectam as próprias contas no seu SaaS

API da Unipile

Contas pessoais e as Páginas que elas gerenciam, por autenticação hospedada.

Acesso

Como obter acesso à API do Facebook

Não existe uma chave de API avulsa. Você cria um app da Meta, as pessoas concedem access tokens a ele pelo Facebook Login, e a Meta revisa as permissões que o seu app solicita antes que ele possa atender o público.

1

Crie uma conta de desenvolvedor da Meta

Cadastre-se no Meta for Developers com a sua conta do Facebook.

2

Crie um app da Meta

Escolha o tipo de app e o caso de uso, depois anote o App ID e o App Secret.

3

Adicione o Facebook Login for Business

Usuários e administradores de Páginas fazem login e concedem permissões ao seu app.

4

Solicite permissões

Por exemplo pages_show_list, pages_manage_posts ou pages_messaging.

5

Passe pelo App Review

O Advanced Access é obrigatório antes que pessoas sem função no seu app possam usá-lo.

Access tokens: usuário, Página, app e usuário do sistema

TokenAge em nome deUso típico
User access tokenAge em nome de uma pessoa que fez login no seu appDe curta duração por padrão, pode ser trocado por um token de longa duração
Page access tokenAge em nome de uma Página, obtido em /me/accountsExigido pela maioria dos endpoints da Pages API e do Messenger
App access tokenAge em nome do próprio appConfigurações do app e alguns dados públicos
System user tokenAge em nome de uma empresa, sem uma pessoaTarefas servidor a servidor, anúncios e Páginas da empresa
User access token
Age em nome deAge em nome de uma pessoa que fez login no seu app
Uso típicoDe curta duração por padrão, pode ser trocado por um token de longa duração
Page access token
Age em nome deAge em nome de uma Página, obtido em /me/accounts
Uso típicoExigido pela maioria dos endpoints da Pages API e do Messenger
App access token
Age em nome deAge em nome do próprio app
Uso típicoConfigurações do app e alguns dados públicos
System user token
Age em nome deAge em nome de uma empresa, sem uma pessoa
Uso típicoTarefas servidor a servidor, anúncios e Páginas da empresa

A duração varia conforme o tipo. Segundo a Meta, os user tokens de curta duração costumam durar de uma a duas horas e os de longa duração cerca de 60 dias, enquanto os system user tokens podem ser configurados para não expirar com o tempo; a Meta avisa que essas durações podem mudar sem aviso prévio. O passo a passo completo, da geração do token à troca e à depuração, está no nosso guia de token de acesso da API do Facebook, e o Page access token do Facebook é tratado no guia da Page API.

Permissões, tarefas da Página e App Review

A maioria dos endpoints da Pages API precisa de um Page access token de uma pessoa que pode executar uma tarefa na Página, como CREATE_CONTENT ou MODERATE. No modo de desenvolvimento, só pessoas com função no seu app podem usá-lo. Para atender outros usuários, cada permissão precisa de Advanced Access, concedido após o App Review, e apps empresariais muitas vezes também exigem a verificação da empresa.

Fontes: guia de access tokens e visão geral da Pages API da Meta. Última verificação: 17 de novembro de 2026.

Tempo real

Webhooks da API do Facebook: receba eventos em tempo real

Em vez de fazer polling, a Meta envia eventos para um endpoint HTTPS seu: novas mensagens da Página, confirmações de leitura e reações. A configuração leva quatro etapas.

1

Verifique o seu endpoint

A Meta envia uma requisição GET com hub.mode, hub.verify_token e hub.challenge. Confira o token e devolva o challenge.

2

Inscreva a Página

Chame POST /{page-id}/subscribed_apps com um Page access token e os campos de que você precisa, como messages.

3

Valide cada payload

Cada evento traz um header X-Hub-Signature-256, uma assinatura SHA256 gerada com o seu App Secret.

4

Responda rápido

Devolva 200 OK rapidamente. No Messenger, a Meta exige uma resposta em até 5 segundos e desativa a inscrição após uma hora de falhas.

Facebook Campos de webhook do Messenger
messagesUma pessoa envia uma mensagem para a Página
message_readsA pessoa leu a sua mensagem
message_deliveriesA sua mensagem foi entregue
message_reactionsA pessoa reagiu a uma mensagem
messaging_postbacksA pessoa tocou em um botão ou item de menu
POST /{page-id}/subscribed_apps success

Com a Unipile, você registra uma única URL de webhook e recebe mensagens novas, editadas e excluídas, confirmações de leitura e reações de todas as contas do Facebook conectadas, no mesmo formato dos seus outros canais.

Fontes: guia de primeiros passos com Webhooks e webhooks do Messenger da Meta. Última verificação: novembro de 2026.

Limites

O que a API oficial do Facebook não permite fazer

Várias coisas que as pessoas esperam de uma API do Facebook foram removidas ou nunca foram oferecidas a apps de terceiros. Conhecê-las cedo poupa semanas de trabalho de design.

  • Publicar em um perfil pessoal. A permissão publish_actions foi descontinuada em 24 de abril de 2018 e os apps a perderam em 1º de agosto de 2018. Os apps podem publicar em Páginas, não na linha do tempo de uma pessoa.
  • Usar Grupos do Facebook. A Meta descontinuou a Groups API com a Graph API v19.0 em 23 de janeiro de 2024, incluindo a permissão publish_to_groups.
  • Enviar mensagens a partir de uma conta pessoal. A Messenger Platform permite que uma Página do Facebook ou uma conta profissional do Instagram responda às pessoas. A janela padrão de mensagens é de 24 horas após a última mensagem da pessoa. Veja como funciona com uma API do Facebook Messenger para contas pessoais.

Fontes: changelog do Facebook Login, anúncio da Graph API v19.0 e visão geral da Messenger Platform da Meta. Última verificação: novembro de 2026.

Precisa das conversas dos seus próprios usuários?

Se o seu app precisa do Messenger, de posts e de comentários das contas que os seus usuários conectam por conta própria, veja a API do Facebook Messenger da Unipile.

Rate limits

Rate limits e versões da API do Facebook

A Graph API contabiliza as chamadas em dois sistemas, conforme o token que você usa.

Rate limit da plataforma 200 x usuários chamadas por hora Chamadas feitas com um token de usuário ou de app, contabilizadas com base no número de usuários do seu app.
Business Use Case, Páginas 4.800 x usuários engajados chamadas a cada 24 horas Chamadas a endpoints de Páginas com um Page token ou system user token.

Leia os headers de uso que a Meta devolve em cada resposta, desacelere antes de atingir o limite e atualize a versão da Graph API antes que a versão que você chama seja desativada.

Fonte: guia de rate limiting da Meta. Última verificação: novembro de 2026.

Erros

Erros comuns da API do Facebook e como corrigi-los

Os erros da Graph API voltam com um code, muitas vezes um error_subcode, e um fbtrace_id para compartilhar com o suporte da Meta. Leia o código antes de tentar de novo: só alguns erros desaparecem com o tempo.

CódigoO que significaO que fazer
190Access token expirado ou inválido (subcódigos 463, 467)Obtenha um novo token; peça ao usuário para fazer login de novo. Veja o guia de token de acesso da API do Facebook
10, 200 a 299Permissão não concedida ou removidaSolicite a permissão de novo, verifique o App Review
4, 17, 613Chamadas demais para o app ou para o usuárioPause e tente de novo com backoff
100Parâmetro ou ID inválidoVerifique o ID e o token enviados
368Bloqueio temporário por violação das políticasAguarde e revise o que foi enviado
506Post duplicadoAltere o conteúdo antes de publicar de novo
10 / 2018278Mensagem enviada fora da janela permitidaResponda apenas enquanto a janela de mensagens estiver aberta
Código 190
O que significaAccess token expirado ou inválido (subcódigos 463, 467)
O que fazerObtenha um novo token; peça ao usuário para fazer login de novo. Veja o guia de token de acesso da API do Facebook
Código 10, 200 a 299
O que significaPermissão não concedida ou removida
O que fazerSolicite a permissão de novo, verifique o App Review
Código 4, 17, 613
O que significaChamadas demais para o app ou para o usuário
O que fazerPause e tente de novo com backoff
Código 100
O que significaParâmetro ou ID inválido
O que fazerVerifique o ID e o token enviados
Código 368
O que significaBloqueio temporário por violação das políticas
O que fazerAguarde e revise o que foi enviado
Código 506
O que significaPost duplicado
O que fazerAltere o conteúdo antes de publicar de novo
Código 10 / 2018278
O que significaMensagem enviada fora da janela permitida
O que fazerResponda apenas enquanto a janela de mensagens estiver aberta

Fontes: tratamento de erros da Graph API e códigos de erro do Messenger da Meta. Última verificação: novembro de 2026.

Preços

A API do Facebook é gratuita?

Em grande parte, sim. A Meta não vende acesso à Graph API. O que custa dinheiro é a publicidade, alguns tipos de mensagem e o tempo de engenharia para construir e manter uma integração funcionando.

Acesso à Graph APISem taxaA Meta não cobra pelas chamadas à Graph API. O seu custo é a configuração do app, o App Review e a manutenção.
Conversas no MessengerUso gratuitoA Meta descreve a Messenger Platform como de uso gratuito; as mensagens de marketing são cobradas pela sua conta de anúncios.
AnúnciosSeu investimento em mídiaChamar a Marketing API é gratuito, mas as campanhas que ela cria são pagas como qualquer outro anúncio.

Os custos por tipo de mensagem, as mudanças de cobrança de 2026 e o custo real de manter um app da Meta estão no nosso guia de preços, que responde em detalhe se a API do Facebook é gratuita. Se os seus usuários conectam as próprias contas pela Unipile, você paga à Unipile por conta conectada: veja os preços da API.

Documentação

Onde encontrar a documentação da API do Facebook

Toda a documentação oficial fica no Meta for Developers. A Meta está migrando suas páginas para developers.facebook.com/documentation/, e vários links antigos em /docs/ agora redirecionam para lá. Estas seis páginas respondem à maioria das dúvidas de integração; para Instagram, WhatsApp, Threads, anúncios e IA, veja nosso guia da API da Meta.

Com a Unipile

Outro modelo: conecte as contas do Facebook dos seus usuários

CRMs, helpdesks, agentes de IA e inboxes multicanal precisam das conversas e dos posts dos próprios usuários. Com a Unipile, cada usuário vincula a sua conta do Facebook por uma página de autenticação hospedada, e o seu app chama uma única REST API em nome dele, sem app da Meta nem App Review do seu lado.

Seu app Sincronizado
Contas vinculadas
FacebookAnna LeeConta pessoal
FacebookNorthwind BakeryPágina
Vincular conta
Inbox 2PáginaPessoal
Leo MartinA loja abre hoje?Página
Sara KimFoto enviadaPessoal
Clube do livroTom: Até as 7Grupo
Omar HaddadVistoPágina
Publicado como Página
Northwind BakeryAgora mesmo

Nosso cardápio de outono começa na segunda.

24 reações2 comentários
Julia NashO pão de abóbora voltou!
Ben TorresVocês aceitam encomendas?
GET api.unipile.com/v2/{ACCOUNT_ID}/chats 200 OK
ÁreaO que a API da Unipile cobre no Facebook
ConexãoHosted Auth ou Custom Auth, com as credenciais do usuário e autenticação de dois fatores, cookies do navegador ou a extensão UniLogin
MensagensListar chats e mensagens, iniciar um chat, enviar mensagens e anexos, editar, excluir, encaminhar, reações, confirmações de leitura, chats em grupo
Posts e comentáriosLer, criar, editar e excluir posts; listar, adicionar, responder, editar e excluir comentários; reações em posts e comentários
Usuários e relaçõesPerfis, seguidores e seguindo, solicitações de amizade (enviar, aceitar, recusar, cancelar)
WebhooksMensagens novas, atualizadas e excluídas, confirmações de leitura e de entrega, novas reações, atualizações de chats
Páginas do FacebookLer e responder às mensagens de uma Página que o usuário gerencia e publicar posts como a Página. Uma Página não pode iniciar uma conversa nem excluir as suas mensagens
Não suportadoStories, mensagens fixadas, bloqueio de usuários
Conexão
Hosted Auth ou Custom Auth, com as credenciais do usuário e autenticação de dois fatores, cookies do navegador ou a extensão UniLogin
Mensagens
Listar chats e mensagens, iniciar um chat, enviar mensagens e anexos, editar, excluir, encaminhar, reações, confirmações de leitura, chats em grupo
Posts e comentários
Ler, criar, editar e excluir posts; listar, adicionar, responder, editar e excluir comentários; reações em posts e comentários
Usuários e relações
Perfis, seguidores e seguindo, solicitações de amizade (enviar, aceitar, recusar, cancelar)
Webhooks
Mensagens novas, atualizadas e excluídas, confirmações de leitura e de entrega, novas reações, atualizações de chats
Páginas do Facebook
Ler e responder às mensagens de uma Página que o usuário gerencia e publicar posts como a Página. Uma Página não pode iniciar uma conversa nem excluir as suas mensagens
Não suportado
Stories, mensagens fixadas, bloqueio de usuários

Os usuários podem conectar uma conta pessoal do Facebook, e as Páginas que eles gerenciam ficam disponíveis pelos mesmos endpoints. A mesma API também cobre LinkedIn, WhatsApp, Instagram, Telegram, e-mail e calendários. Lista completa na tabela de recursos por provedor.

Listar chats e enviar uma mensagem

Depois que um usuário conecta a conta, você recebe um account_id. Cada chamada usa a sua chave de API da Unipile no header X-API-KEY. A segunda aba mostra, para comparação, uma primeira chamada à Graph API da Meta: ler os posts mais recentes de uma Página com um Page access token.

# 1. Listar os chats do Facebook de uma conta conectada
curl --request GET \
  --url "https://api.unipile.com/v2/{ACCOUNT_ID}/chats" \
  --header "X-API-KEY: {YOUR_API_KEY}"

# 2. Responder em um desses chats
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": "Obrigado pela mensagem, seu pedido sai hoje." }'
# Ler os 3 posts mais recentes de uma Página (Graph API v27.0)
# Requer um Page access token com pages_read_engagement e pages_read_user_content
curl "https://graph.facebook.com/v27.0/{PAGE_ID}/feed?fields=id,message,created_time&limit=3&access_token={PAGE_ACCESS_TOKEN}"

# Resposta (resumida)
{ "data": [ {
    "id": "{PAGE_ID}_{POST_ID}",
    "message": "Nosso cardápio de outono começa na segunda.",
    "created_time": "2026-11-16T09:30:00+0000"
  } ],
  "paging": {
    "cursors": { "before": "{CURSOR}", "after": "{CURSOR}" },
    "next": "https://graph.facebook.com/v27.0/{PAGE_ID}/feed?..."
  } }
200 OK · mensagem enviada pela conta do usuário
200 OK · posts de uma Página, um Page token por Página

Configuração passo a passo no quickstart do Facebook. Requisição da Graph API conferida com a referência do feed da Página da Meta em 17 de novembro de 2026.

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 age em nome de usuários autenticados, e os seus usuários continuam sujeitos aos termos da Meta. Use-a em cenários legítimos, como atendimento ao cliente, CRM e conversas diretas.

Referência da API

Endpoints da API do Facebook com a Unipile

Resposta curta

A Unipile expõe o Facebook por meio de uma única API REST. Os endpoints V2 cobrem chats e mensagens do Messenger, posts, comentários, reações, perfis, solicitações de amizade, Páginas do Facebook e webhooks. Cada chamada aponta para uma conta conectada pelo seu account_id, então uma única integração atende uma conta pessoal e as Páginas que ela gerencia, sem nenhum app da Meta do seu lado.

AçãoMétodo e caminhoPessoal / PáginaGuia
Mensagens
Listar chatsGET/v2/{account_id}/chatsPessoalMessenger para contas pessoais
Listar as mensagens de um chatGET/v2/{account_id}/chats/{chat_id}/messagesPessoal + Página
Baixar um anexoGET/v2/{account_id}/chats/{chat_id}/messages/{message_id}/attachments/{attachment_id}Pessoal + Página
Iniciar um novo chatPOST/v2/{account_id}/chats/sendPessoalComo enviar uma mensagem no Messenger
Enviar uma mensagem, texto ou anexosPOST/v2/{account_id}/chats/{chat_id}/messages/sendPessoal + Página
Listar, adicionar ou remover reações a mensagensGETPOSTDELETE/v2/{account_id}/chats/{chat_id}/messages/{message_id}/reactionsPessoal
Marcar uma mensagem como lidaPOST/v2/{account_id}/chats/{chat_id}/messages/{message_id}/readPessoal
Posts
Listar os posts de um usuário ou de uma PáginaGET/v2/{account_id}/users/{user_id}/postsPessoal + PáginaGuia da API de posts do Facebook
Obter um postGET/v2/{account_id}/posts/{post_id}Pessoal + Página
Criar um postPOST/v2/{account_id}/postsPessoal + Página
Editar ou excluir um postPATCHDELETE/v2/{account_id}/posts/{post_id}Pessoal + Página
Comentários
Listar os comentários de um postGET/v2/{account_id}/posts/{post_id}/commentsPessoalLer e responder comentários
Listar as respostas a um comentárioGET/v2/{account_id}/posts/{post_id}/comments/{comment_id}/repliesPessoal
Adicionar um comentárioPOST/v2/{account_id}/posts/{post_id}/commentsPessoal
Responder a um comentárioPOST/v2/{account_id}/posts/{post_id}/comments/{comment_id}Pessoal
Editar ou excluir um comentárioPATCHDELETE/v2/{account_id}/posts/{post_id}/comments/{comment_id}Pessoal
Reações
Listar, adicionar ou remover reações a postsGETPOSTDELETE/v2/{account_id}/posts/{post_id}/reactionsPessoalReações no guia de comentários
Listar, adicionar ou remover reações a comentáriosGETPOSTDELETE/v2/{account_id}/posts/{post_id}/comments/{comment_id}/reactionsPessoal
Perfis e relações
Obter um perfilGET/v2/{account_id}/users/{user_id}PessoalSincronizar contatos com o seu CRM
Listar amigosGET/v2/{account_id}/users/me/relationsPessoal
Listar seguidores ou seguidosGET/v2/{account_id}/users/{user_id}/followersGET/v2/{account_id}/users/{user_id}/followingPessoal
Enviar ou listar solicitações de amizadePOSTGET/v2/{account_id}/users/me/relation-requestsPessoal
Aceitar, recusar ou cancelar uma solicitaçãoPOST/v2/{account_id}/users/me/relation-requests/{request_id}/acceptPOST/v2/{account_id}/users/me/relation-requests/{request_id}/cancelPessoal
Páginas do Facebook
Encontrar as Páginas da contaGET/v2/{account_id}/inboxesPáginaPasso a passo da API de Páginas do Facebook
Listar os chats de uma PáginaGET/v2/{account_id}/inboxes/PAGE_{page_id}_INBOX/chatsPágina
Responder como a PáginaPOST/v2/{account_id}/chats/PAGE_{page_id}_{thread_key}/messages/sendPágina
Publicar um post como a PáginaPOST/v2/{account_id}/posts com post_asPágina
Webhooks
Registrar um endpoint de webhookPOST/v2/webhooks/endpointsPessoal + PáginaSincronização do CRM em tempo real com webhooks
Eventos de mensagemmessage.new, message.update, message.delete, message.receipt.read, message.receipt.delivery, message.reaction.newPessoal + Página
Eventos de chatchat.update, chat.deletePessoal
Mensagens
Listar chatsGET/v2/{account_id}/chatsPessoal
Listar as mensagens de um chatGET/v2/{account_id}/chats/{chat_id}/messagesPessoal + Página
Baixar um anexoGET/v2/{account_id}/chats/{chat_id}/messages/{message_id}/attachments/{attachment_id}Pessoal + Página
Iniciar um novo chatPOST/v2/{account_id}/chats/sendPessoal
Enviar uma mensagem, texto ou anexosPOST/v2/{account_id}/chats/{chat_id}/messages/sendPessoal + Página
Listar, adicionar ou remover reações a mensagensGETPOSTDELETE/v2/{account_id}/chats/{chat_id}/messages/{message_id}/reactionsPessoal
Marcar uma mensagem como lidaPOST/v2/{account_id}/chats/{chat_id}/messages/{message_id}/readPessoal
Posts
Listar os posts de um usuário ou de uma PáginaGET/v2/{account_id}/users/{user_id}/postsPessoal + Página
Obter um postGET/v2/{account_id}/posts/{post_id}Pessoal + Página
Criar um postPOST/v2/{account_id}/postsPessoal + Página
Editar ou excluir um postPATCHDELETE/v2/{account_id}/posts/{post_id}Pessoal + Página
Comentários
Listar os comentários de um postGET/v2/{account_id}/posts/{post_id}/commentsPessoal
Listar as respostas a um comentárioGET/v2/{account_id}/posts/{post_id}/comments/{comment_id}/repliesPessoal
Adicionar um comentárioPOST/v2/{account_id}/posts/{post_id}/commentsPessoal
Responder a um comentárioPOST/v2/{account_id}/posts/{post_id}/comments/{comment_id}Pessoal
Editar ou excluir um comentárioPATCHDELETE/v2/{account_id}/posts/{post_id}/comments/{comment_id}Pessoal
Reações
Listar, adicionar ou remover reações a postsGETPOSTDELETE/v2/{account_id}/posts/{post_id}/reactionsPessoal
Listar, adicionar ou remover reações a comentáriosGETPOSTDELETE/v2/{account_id}/posts/{post_id}/comments/{comment_id}/reactionsPessoal
Perfis e relações
Obter um perfilGET/v2/{account_id}/users/{user_id}Pessoal
Listar amigosGET/v2/{account_id}/users/me/relationsPessoal
Listar seguidores ou seguidosGET/v2/{account_id}/users/{user_id}/followersGET/v2/{account_id}/users/{user_id}/followingPessoal
Enviar ou listar solicitações de amizadePOSTGET/v2/{account_id}/users/me/relation-requestsPessoal
Aceitar, recusar ou cancelar uma solicitaçãoPOST/v2/{account_id}/users/me/relation-requests/{request_id}/acceptPOST/v2/{account_id}/users/me/relation-requests/{request_id}/cancelPessoal
Páginas do Facebook
Encontrar as Páginas da contaGET/v2/{account_id}/inboxesPágina
Listar os chats de uma PáginaGET/v2/{account_id}/inboxes/PAGE_{page_id}_INBOX/chatsPágina
Responder como a PáginaPOST/v2/{account_id}/chats/PAGE_{page_id}_{thread_key}/messages/sendPágina
Publicar um post como a PáginaPOST/v2/{account_id}/posts com post_asPágina
Webhooks
Registrar um endpoint de webhookPOST/v2/webhooks/endpointsPessoal + Página
Eventos de mensagemmessage.new, message.update, message.delete, message.receipt.read, message.receipt.delivery, message.reaction.newPessoal + Página
Eventos de chatchat.update, chat.deletePessoal

Autenticação. Cada requisição leva a sua chave de API da Unipile no header X-API-KEY. Seus usuários conectam a própria conta do Facebook pelo Hosted Auth, então você nunca cria um app da Meta, não passa pelo App Review e não armazena nenhum token de Página. Compare com um access token da API do Facebook e veja o detalhamento de preços da API do Messenger para os custos.

Endpoints extraídos da documentação V2 do Facebook da Unipile e da sua tabela de funcionalidades por provedor. Última verificação: 17 de novembro de 2026.

Casos de uso

API do Facebook por caso de uso

A maioria das integrações com o Facebook se encaixa em uma destas famílias. Veja como cada uma aparece dentro de um produto.

Seu CRM
ContatosNegócios
ContatoEtapa
Julia ChenA demo está mantida?QualificadoFacebook
Lucas MeyerMe envie o orçamentoPropostaFacebook
Sofia RiveraAssinado, obrigado!GanhoFacebook
Daniel MoreauFalamos na segundaNovoFacebook

Integração do Facebook Messenger com CRM

Sincronize as conversas com as fichas de contato para que as equipes de vendas e suporte respondam a partir do CRM. Veja a integração do Facebook Messenger com CRM.

Cada conversa salva no contato certo, sem copiar e colar.

Seu helpdesk
TicketsClientes
SolicitaçãoStatus
Mia OwensOnde está meu pedido? #4521AbertoFacebook
Elena GarciaReembolso recebido #4498ResolvidoFacebook
Gabriel LopezFoto anexada #4530PendenteFacebook
Anna RossiNão consigo entrar #4476AbertoFacebook

Chat do Facebook e Messenger

Responda às pessoas que enviam mensagens a uma Página pela Messenger Platform, ou aos contatos de uma conta conectada. Veja como enviar uma mensagem.

Solicitações do Facebook respondidas na ferramenta de suporte de sempre.

Sua ferramenta social
Publicar comoFacebookNorthwind BakeryFacebookAnna Lee
Pão de fermentação natural fresquinho toda manhã, a partir das 7h.
Publicar
Nosso cardápio de outono começa na segundaPágina · HojePublicado
Obrigado por 10 ótimos anos!Página · 2 de out.Editado

API de posts do Facebook

Crie, edite e leia posts. A API oficial publica apenas em Páginas, enquanto uma conta conectada pode publicar como o seu usuário. Leia o guia da API de posts do Facebook.

Posts escritos, publicados e editados a partir do seu próprio produto.

Sua ferramenta de comunidade
Comentários no post de Anna Lee: Nosso cardápio de outono começa na segunda
ComentárioTema
Ben TorresVocês aceitam encomendas?PerguntaFacebook
Julia NashO pão de abóbora voltou!FeedbackFacebook
Kai OkaforÉ sem glúten?PerguntaFacebook
Priya RaoDá para reservar para 20 pessoas?VendasFacebook

API de comentários do Facebook

Liste os comentários de um post e depois responda, edite ou exclua a partir da própria conta conectada do usuário. Os comentários sempre saem dessa conta, nunca de uma Página: comentar como Página passa pela Pages API da Meta. Leia o guia da API de comentários do Facebook.

Perguntas feitas em um post identificadas e encaminhadas para a equipe certa.

API de Páginas do Facebook

Publique e modere o conteúdo de uma Página do Facebook, com um Page access token e as tarefas de Página certas. Leia o guia da API de Páginas do Facebook.

Preço da API do Facebook Messenger

A Meta descreve a Messenger Platform como de uso gratuito, enquanto as mensagens de marketing são cobradas via anúncios. O custo real é o tempo de integração e de revisão. Veja o detalhamento completo.

Está criando uma inbox única para várias redes? Veja como funciona uma API de mensagens unificada e consulte nosso guia da API do Instagram para a outra rede da Meta.

Escolha a API certa para o seu produto

A Graph API da Meta é a ferramenta certa quando o seu app gerencia as próprias Páginas ou anúncios. Quando o seu produto precisa das conversas e dos posts da conta de cada usuário, conecte essas contas pela Unipile e use uma única API para o Facebook e os seus outros canais.

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. Nossa abordagem do Digital Markets Act

Perguntas frequentes sobre a API do Facebook

Respostas rápidas sobre chaves, versões, níveis de acesso, parceria com a Meta, conformidade e Grupos.

Os desenvolvedores a usam para gerenciar Páginas do Facebook (posts, comentários, insights), responder às conversas da Página pela Messenger Platform, veicular e medir anúncios e fazer o login das pessoas com o Facebook Login. Cada uso depende de um produto da Graph API com permissões próprias.

Não existe uma chave única. Crie um app da Meta no Meta for Developers para obter um App ID e um App Secret e, em seguida, obtenha access tokens: tokens de usuário pelo Facebook Login, tokens de Página em /me/accounts. As permissões usadas pelo público precisam de Advanced Access após o App Review.

A Graph API é a API HTTP de base para objetos do Facebook, como usuários, Páginas, posts e comentários. A Marketing API é um conjunto de endpoints da Graph API para contas de anúncios, campanhas, públicos e relatórios, com permissões e requisitos empresariais próprios.

Não com a API oficial da Meta: os apps perderam a permissão publish_actions em 1º de agosto de 2018 e só podem publicar em Páginas. Com a Unipile, um usuário que conecta a própria conta do Facebook pode criar posts a partir dela pelos endpoints de Posts, dentro dos termos da Meta.

Não. A Meta descontinuou a Groups API com a Graph API v19.0 em janeiro de 2024, incluindo a permissão publish_to_groups. A Unipile também não cobre os Grupos do Facebook.

Em novembro de 2026, o changelog da Meta indicava a v27.0 como a versão mais recente da Graph API. A Meta lança várias versões por ano e mantém cada uma disponível por pelo menos dois anos, então consulte o changelog da Graph API antes de fixar uma versão.

Não. A Unipile é uma empresa independente que trabalha ao lado da Graph API da Meta, não para a Meta. Ela não é um Meta Partner nem um app oficial da Meta, e não é endossada, patrocinada nem aprovada pela Meta. Facebook e Messenger são marcas registradas da Meta Platforms, Inc.

Não. As etapas de app da Meta, Facebook Login e App Review descritas neste guia valem para a API oficial da Meta. Com a Unipile, cada usuário vincula a própria conta do Facebook, e as Páginas que gerencia, por uma página de autenticação hospedada, então você pula essas etapas do seu lado.

Ela foi projetada no espírito do Digital Markets Act: em vez de um único app ler muitas contas, cada usuário conecta a própria conta e a Unipile age em nome dele, sem armazenar perfis de usuários. Detalhes na nossa página sobre o Digital Markets Act.

Sim. Quer você chame a Graph API ou a Unipile, as contas do Facebook continuam sujeitas aos Termos de Serviço da Meta. Limite-se a usos legítimos, como atendimento ao cliente, CRM e conversas que as pessoas esperam; spam e automação não autorizada podem levar à restrição de uma conta.

O seu app ainda está limitado às pessoas que têm uma função nele. Com o Standard Access, as permissões só podem ser solicitadas a administradores, desenvolvedores e testadores do app. Para atender às Páginas de outras pessoas, cada permissão precisa de Advanced Access, aprovado pelo App Review, e a Meta exige a Verificação da Empresa para isso.

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

Fale com um especialista