
Guias de integração
Guia da API do LinkedIn
Guia da API de e-mail
Guia da API do WhatsApp
Fale com vendas
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.
comments
POSTcomments/{id}
PATCHcomments/{id}
200 OK
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.
Comente pelas contas dos seus usuários em 3 etapas
Conecte a conta
O seu usuário conecta a conta do Facebook pelo Hosted Auth. Sem app da Meta, sem App Review.
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
Capture os novos comentários
Não existe webhook de comentários: leia a lista de novo e compare com o último ID conhecido.
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.
/{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.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.
/{page-post-id}/comments?filter=stream&summary=true&order=reverse_chronological&fields=from,message,created_time
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.
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.
/{comment-id}/comments message="Thanks, we open at 9am." access_token={PAGE_ACCESS_TOKEN}
Requer pages_manage_engagement, pages_read_engagement, pages_read_user_engagement e as tarefas MODERATE e CREATE_CONTENT.
"O autor do comentário será a Página."
Para responder em nome de cada usuário, você precisa de uma conta conectada.
@ 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.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.
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.
POST /{comment-id} com is_hidden=true; false volta a exibi-lo. Somente comentários de Página.
DELETE /{comment-id} remove o comentário e retorna {"success": true}.
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.
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.
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.
https://api.unipile.com/v2/{account_id}/posts/{post_id}/commentsListar os comentários de um post/posts/{post_id}/comments/{comment_id}/repliesListar as respostas a um comentário/posts/{post_id}/commentsAdicionar um comentário a um post/posts/{post_id}/comments/{comment_id}Responder a um comentário/posts/{post_id}/comments/{comment_id}Editar o texto de um comentário/posts/{post_id}/comments/{comment_id}Excluir um comentário da própria conta/users/me/commentsOs comentários da própria conta, 25 por página| Caso | Regra |
|---|---|
| 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 |
limit; depois next_cursortext pode então ficar vaziocan_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.
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
Em Páginas muito grandes, a lista de quem reagiu pode vir parcial ou vazia; os contadores continuam exatos. Detalhes em Manage post reactions.
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.
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.
Busque os comentários de cada post acompanhado.
GET /posts/{post_id}/comments
Mais recentes primeiro: tudo o que está acima dele é novo.
last_seen_comment_id
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.
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ério | Graph API da Meta | Conta conectada (Unipile) |
|---|---|---|
| Autor | A Página | O usuário, em nome próprio |
| Configuração do seu lado | App da Meta, permissões, App Review | Chave de API e Hosted Auth |
| Ocultar um comentário | is_hidden em comentários de Página | Não documentado |
| Excluir um comentário | Comentários nos posts da Página | Os comentários da própria conta |
| Novos comentários | Webhook feed | Reler a lista |
| Outras redes | Somente Facebook | A mesma API para LinkedIn, Instagram e outras |
is_hidden em comentários de PáginafeedVeja também: conectar uma conta pessoal do Facebook e preços da API do Facebook Messenger.
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.
v2/{ACCOUNT_ID}/posts/{POST_ID}/comments
200 OK
Os comentários ficam ao lado das mensagens e são respondidos pela conta do usuário.
A ficha de um contato mostra os comentários dessa pessoa nos posts do seu usuário.
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.
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.
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