BR
Guia para desenvolvedores

API de comentários do Facebook: leia, responda e modere comentários

Gerencie comentários do Facebook por API em 2026: como Página, com a Graph API da Meta, ou a partir das próprias contas dos seus usuários.

Seu app · Comentários Conectado
FacebookNo post de Anna Lee
Tom BeckerSábado de manhã ainda está livre?Novo
Anna LeeSim, às 10h dá certo. Até lá!Respondido
Maya RuizVocê também faz fotos de família?Aberto
Responder como Anna LeeEnviar
GETcomments POSTcomments/{id} PATCHcomments/{id} 200 OK
Resposta curta

Uma API de comentários do Facebook permite que o seu app leia, publique, responda e modere comentários do Facebook com requisições HTTP. Existem dois caminhos: a Graph API da Meta, em que todo comentário escrito pelo seu app vem de uma Página, ou uma conta conectada, em que o seu app comenta em nome do usuário que a vinculou.

Este guia não trata da coleta de comentários públicos. Para uma visão geral, veja como as APIs do Facebook se encaixam.

Com a Unipile

Comente pelas contas dos seus usuários em 3 etapas

1

Conecte a conta

O seu usuário conecta a conta do Facebook pelo Hosted Auth. Sem app da Meta, sem App Review.

2

Chame o endpoint de comentários

Liste, responda, edite ou exclua a partir dessa conta, com o seu header X-API-KEY.

GET /v2/{account_id}/posts/{post_id}/comments
3

Capture os novos comentários

Não existe webhook de comentários: leia a lista de novo e compare com o último ID conhecido.

Definição

O que é a API de comentários do Facebook?

A Meta não tem nenhum produto chamado "Comments API". Os comentários do Facebook são nós comment da Graph API, lidos e criados pela edge /{object-id}/comments de um post, foto, vídeo ou comentário.

Na prática, uma API de comentários do Facebook significa chamadas nessa edge e nesse nó. Nós, edges e tokens: veja a nossa visão geral da Graph API do Facebook.

A Content Library da Meta fornece comentários apenas a pesquisadores aprovados, e o plugin de comentários para sites foi descontinuado em 10 de fevereiro de 2026.

Facebook Comentários na Graph API
/{post-id}/commentsLista os comentários de um post e recebe novos.
/{comment-id}O comentário: leia, atualize ou exclua.
fromQuem escreveu o comentário.
messageO texto do comentário.
created_timeQuando o comentário foi publicado.
/{comment-id}/commentsRespostas a esse comentário.
Graph API da Meta

Como obter os comentários de um post do Facebook com a Graph API?

Chame GET /{page-post-id}/comments com um Page access token. Adicione filter=stream para obter todos os níveis de resposta (o padrão, toplevel, para nos comentários de primeiro nível), summary=true para obter total_count e fields=from,message.

GET /{page-post-id}/comments?filter=stream&summary=true&order=reverse_chronological&fields=from,message,created_time

Três armadilhas

  • Tokens de usuário não retornam nada. Em um post, foto, álbum ou vídeo, um user access token recebe dados vazios.
  • IDs de comentário exigem MODERATE. Pelo Page Public Content Access, o id do comentário só é retornado se o titular do token puder executar a tarefa MODERATE na Página.
  • total_count pode contar a mais. Comentários excluídos ou privados continuam sendo contados.

Ler comentários exige os direitos do objeto pai: veja as permissões da API de Páginas do Facebook e o nosso guia sobre o token de acesso da API do Facebook.

Fonte: referência de /{object-id}/comments, v27.0, verificada em 17 de nov. de 2026.

Graph API da Meta

Como responder a um comentário do Facebook com a Graph API?

Envie POST /{comment-id}/comments com um message (ou /{page-post-id}/comments para um comentário de primeiro nível), mais uma imagem opcional em attachment_url. A Página é a autora: comentar como pessoa retorna o erro 1705.

POST /{comment-id}/comments message="Thanks, we open at 9am." access_token={PAGE_ACCESS_TOKEN}
Quem é o autor?
Northwind BakeryPage access tokenComenta como Página
Anna LeeUser access tokenErro 1705

Requer pages_manage_engagement, pages_read_engagement, pages_read_user_engagement e as tarefas MODERATE e CREATE_CONTENT.

Documentação da Meta

Nunca como pessoa

"O autor do comentário será a Página."

Para responder em nome de cada usuário, você precisa de uma conta conectada.

  • @menções. Escreva @ e o ID da pessoa no escopo da Página (PSID). Só vale para quem comentou ou criou o post, com "Others Tagging this Page" ativado.
  • Respostas privadas. Quando can_reply_privately é true: uma mensagem do Messenger para quem comentou, em até 7 dias, com pages_messaging e a tarefa MESSAGING. Veja como enviar uma mensagem do Messenger via API.

Fontes: Comentários e @menções, Respostas privadas, v27.0, verificadas em 17 de nov. de 2026.

Moderação

Como moderar comentários de Página do Facebook por API?

Com um Page access token e pages_manage_engagement, o seu app oculta um comentário de Página, exclui esse comentário e é avisado dos novos pelo webhook feed.

Ocultar

POST /{comment-id} com is_hidden=true; false volta a exibi-lo. Somente comentários de Página.

Excluir

DELETE /{comment-id} remove o comentário e retorna {"success": true}.

Receber notificações

Inscreva a Página em feed via /{page-id}/subscribed_apps. Os eventos com item: comment trazem um verb (add, edited, remove, hide), o comment_id e o parent_id.

  • Webhooks exigem um admin. Um admin com MODERATE concede antes pages_manage_metadata. Verificação e assinaturas: veja os webhooks da API do Facebook.

Fontes: referências Comment e Page webhooks, v27.0, verificadas em 17 de nov. de 2026.

Com a Unipile

Ler, responder, editar e excluir comentários a partir de uma conta conectada

Cada usuário conecta a própria conta do Facebook pelo Hosted Auth e o seu app recebe um account_id. Por /v2/{account_id}/posts/{post_id}/comments, o seu app lista comentários e respostas e depois comenta, responde, edita e exclui os comentários da própria conta, sem app da Meta e sem token de Página. A aba Meta mostra o equivalente na Graph API.

const BASE = "https://api.unipile.com/v2";
const headers = {
  "X-API-KEY": process.env.UNIPILE_API_KEY,
  "content-type": "application/json"
};

// 1. List the comments of a post (newest first, 10 per page)
const res = await fetch(`${BASE}/${ACCOUNT_ID}/posts/${POST_ID}/comments`, { headers });
const { data, next_cursor } = await res.json();

// 2. Reply to the newest comment from the connected account
await fetch(`${BASE}/${ACCOUNT_ID}/posts/${POST_ID}/comments/${data[0].id}`, {
  method: "POST", headers,
  body: JSON.stringify({ text: "Yes, 10am works. See you there!" })
});
import os, requests

BASE = "https://api.unipile.com/v2"
headers = {"X-API-KEY": os.environ["UNIPILE_API_KEY"]}

# 1. List the comments of a post (newest first, 10 per page)
page = requests.get(f"{BASE}/{ACCOUNT_ID}/posts/{POST_ID}/comments",
                    headers=headers).json()
newest = page["data"][0]

# 2. Reply to the newest comment from the connected account
requests.post(f"{BASE}/{ACCOUNT_ID}/posts/{POST_ID}/comments/{newest['id']}",
              headers=headers, json={"text": "Yes, 10am works. See you there!"})
# 1. List the comments of a post (newest first, 10 per page)
curl --request GET \
  --url "https://api.unipile.com/v2/{ACCOUNT_ID}/posts/{POST_ID}/comments" \
  --header "X-API-KEY: {YOUR_API_KEY}"

# 2. Reply to one comment from the connected account
curl --request POST \
  --url "https://api.unipile.com/v2/{ACCOUNT_ID}/posts/{POST_ID}/comments/{COMMENT_ID}" \
  --header "X-API-KEY: {YOUR_API_KEY}" \
  --header "content-type: application/json" \
  --data '{ "text": "Yes, 10am works. See you there!" }'
# Meta Graph API: list a Page post's comments with a Page access token
curl -G "https://graph.facebook.com/v27.0/{PAGE_POST_ID}/comments" \
  -d "filter=stream" -d "summary=true" \
  -d "fields=from,message,created_time" \
  -d "access_token={PAGE_ACCESS_TOKEN}"

# Reply to one comment: the Page is the author
curl -X POST "https://graph.facebook.com/v27.0/{COMMENT_ID}/comments" \
  -d "message=Yes, 10am works. See you there!" \
  -d "access_token={PAGE_ACCESS_TOKEN}"

# Response: the ID of the new comment
{ "id": "{NEW_COMMENT_ID}" }

Documentação: Manage post comments. Aba Meta: /{object-id}/comments, v27.0, verificada em 17 de nov. de 2026.

Endpoints de comentários

Caminho base: https://api.unipile.com/v2/{account_id}
GET/posts/{post_id}/commentsListar os comentários de um post
GET/posts/{post_id}/comments/{comment_id}/repliesListar as respostas a um comentário
POST/posts/{post_id}/commentsAdicionar um comentário a um post
POST/posts/{post_id}/comments/{comment_id}Responder a um comentário
PATCH/posts/{post_id}/comments/{comment_id}Editar o texto de um comentário
DELETE/posts/{post_id}/comments/{comment_id}Excluir um comentário da própria conta
GET/users/me/commentsOs comentários da própria conta, 25 por página

Limites a prever

CasoRegra
Tamanho da página10 por página, seja qual for o limit; depois next_cursor
OrdemMais recentes primeiro
attachmentsUma imagem por comentário; text pode então ficar vazio
GIF animadoPublicado como imagem estática
ExcluirSomente os comentários da própria conta
Tamanho da página
10 por página, seja qual for o limit; depois next_cursor
Ordem
Mais recentes primeiro
attachments
Uma imagem por comentário; text pode então ficar vazio
GIF animado
Publicado como imagem estática
Excluir
Somente os comentários da própria conta

can_comment só aceita anyone na criação do post e não pode ser alterado depois: veja o nosso guia da API de posts do Facebook.

Reagir a comentários

A conta adiciona ou remove a própria reação com POST ou DELETE em /posts/{post_id}/comments/{comment_id}/reactions, e GET lista as reações, 10 por página. O campo reaction aceita sete valores:

facebook_likefacebook_lovefacebook_carefacebook_hahafacebook_wowfacebook_sadfacebook_angry
Listas parciais

Em Páginas muito grandes, a lista de quem reagiu pode vir parcial ou vazia; os contadores continuam exatos. Detalhes em Manage post reactions.

Conformidade

Os seus usuários comentam a partir das próprias contas

A Unipile não é um produto da Meta nem um Meta Partner; os seus usuários conectam as próprias contas e continuam sujeitos aos termos da Meta.

Novos comentários

Como saber quando chega um novo comentário?

Com a Meta, o webhook feed da Página envia cada novo comentário. A Unipile ainda não tem evento de comentário: o seu app relê os comentários dos posts acompanhados e os compara com o último ID armazenado.

1

Ler a lista

Busque os comentários de cada post acompanhado.

GET /posts/{post_id}/comments
2

Parar no último ID conhecido

Mais recentes primeiro: tudo o que está acima dele é novo.

last_seen_comment_id
3

Tratar os novos

Exiba-os e armazene o ID mais recente.

reply_counter para novas respostas

As mensagens e reações do Messenger têm, sim, webhooks em tempo real: veja a página da API do Facebook Messenger.

Decisão

Moderação de Página ou comentários de usuários: qual abordagem combina com o seu produto?

A Graph API atende uma ferramenta que modera as Páginas dos clientes, com um app da Meta e App Review. Uma conta conectada atende um produto em que os usuários respondem aos comentários em nome próprio.

CritérioGraph API da MetaConta conectada (Unipile)
AutorA PáginaO usuário, em nome próprio
Configuração do seu ladoApp da Meta, permissões, App ReviewChave de API e Hosted Auth
Ocultar um comentáriois_hidden em comentários de PáginaNão documentado
Excluir um comentárioComentários nos posts da PáginaOs comentários da própria conta
Novos comentáriosWebhook feedReler a lista
Outras redesSomente FacebookA mesma API para LinkedIn, Instagram e outras
Autor
Graph APIA Página
Conta conectadaO usuário, em nome próprio
Configuração do seu lado
Graph APIApp da Meta, permissões, App Review
Conta conectadaChave de API e Hosted Auth
Ocultar um comentário
Graph APIis_hidden em comentários de Página
Conta conectadaNão documentado
Excluir um comentário
Graph APIComentários nos posts da Página
Conta conectadaOs comentários da própria conta
Novos comentários
Graph APIWebhook feed
Conta conectadaReler a lista
Outras redes
Graph APISomente Facebook
Conta conectadaA mesma API para LinkedIn, Instagram e outras

Veja também: conectar uma conta pessoal do Facebook e preços da API do Facebook Messenger.

Casos de uso

Casos de uso: comentários em ferramentas de suporte, CRMs e agentes de IA

Exiba os comentários onde os seus usuários já gerenciam as mensagens.

O mesmo modelo na outra rede da Meta: veja o nosso guia da API do Instagram.

Sua ferramenta de comunidade Facebook
Todos os comentáriosA responderConcluídos
Tom BeckerSábado de manhã ainda está livre?Pergunta
Julia ChenAs fotos impressas ficaram ótimas.Feedback
Maya RuizPreço de um ensaio em família?Vendas
GET v2/{ACCOUNT_ID}/posts/{POST_ID}/comments 200 OK

Ferramentas de suporte e comunidade

Os comentários ficam ao lado das mensagens e são respondidos pela conta do usuário.

Atividade no CRM

A ficha de um contato mostra os comentários dessa pessoa nos posts do seu usuário.

Agentes de IA com aprovação

Um agente redige uma resposta; o seu app só a envia depois que o usuário aprova.

Comece a gerenciar comentários do Facebook a partir do seu app

Modere as Páginas dos seus clientes com a Graph API. Para comentários em nome dos próprios usuários, conecte as contas deles pela Unipile.

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. A Unipile e o DMA

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

Os comentários são só uma parte: explore todos os endpoints do Facebook disponíveis com a Unipile, de mensagens a posts e reações, ou comece pelo nosso guia completo da API do Facebook.

Perguntas frequentes sobre a API de comentários do Facebook

Leitura, publicação, ocultação, exclusão, paginação e respostas privadas.

Com a Graph API, chame GET /{page-post-id}/comments com um Page access token (um token de usuário retorna dados vazios nos posts). Com a Unipile, chame GET /v2/{account_id}/posts/{post_id}/comments a partir da conta conectada do usuário.

Com a Graph API, apenas como Página: comentar como pessoa retorna o erro 1705. Com a Unipile, a conta conectada comenta em nome do próprio usuário com POST /v2/{account_id}/posts/{post_id}/comments.

Sim, em comentários de Página, com a Graph API: POST /{comment-id} com is_hidden definido como true ou false, usando um Page access token. A ocultação não está documentada do lado da Unipile.

Sim. Com a Graph API e um Page access token, DELETE /{comment-id} remove comentários nos posts da Página. Uma conta conectada pela Unipile exclui apenas os próprios comentários.

A Graph API pagina os resultados com cursores. Com a Unipile, o Facebook retorna até 10 comentários ou respostas por página, seja qual for o limit, dos mais recentes aos mais antigos; siga next_cursor para a próxima página.

Sim, com as respostas privadas da Meta: uma mensagem para a pessoa que comentou, em até 7 dias, com pages_messaging. A conversa só continua se ela responder. Veja como enviar uma mensagem do Messenger via API.

Não. A Unipile é uma empresa independente, não é Meta Partner e não é endossada nem aprovada pela Meta. Os comentários passam pelas próprias contas do Facebook dos seus usuários. Facebook é uma marca registrada da Meta Platforms, Inc.

Não. Os seus usuários conectam a própria conta do Facebook por autenticação hospedada, então você dispensa o app da Meta, a permissão pages_manage_engagement e o App Review do caminho pela Graph API.

A Unipile foi concebida no espírito do Digital Markets Act: cada usuário conecta a própria conta e decide o que escreve, e a Unipile age em nome dele sem armazenar perfis de usuários. Saiba mais na nossa página sobre o Digital Markets Act.

Sim. Cada comentário passa por uma conta sujeita aos Termos de Serviço da Meta. Mantenha usos legítimos, como responder às pessoas que comentaram nos posts do seu usuário; spam e automação não autorizada podem levar à restrição de contas.

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

Fale com um especialista