API de moderação de comentários da Página do Facebook: ler, responder, ocultar e eliminar comentários
Através da Graph API, uma Página do Facebook pode ler os comentários das suas publicações, responder em público como a Página, enviar uma resposta privada por comentário, ocultar um comentário ou voltar a mostrá-lo com is_hidden, e eliminá-lo. A leitura devolve os comentários de primeiro nível por ordem cronológica, por omissão, e a moderação exige um token de alguém com a tarefa MODERATE na Página.
O easyCoexistence lê comentários do Facebook com list_social_comments, responde em público ou em privado com reply_to_comment e oculta ou mostra com hide_comment, a partir do Claude, do ChatGPT ou do seu próprio código.
O filtro predefinido: comentários de primeiro nível por ordem cronológica, tal como o Facebook os ordena.
O filtro que devolve comentários de todos os níveis por ordem cronológica, que a Meta sugere para ferramentas de moderação.
A tarefa da Página necessária para ver os IDs dos comentários numa publicação da Página e para comentar como a Página.
Código de erro quando um comentário é feito como utilizador e não como a Página: There was an error posting to this wall.
Como são lidos os comentários?
GET /{page-post-id}/comments devolve os comentários de uma publicação. O filtro predefinido é toplevel, os comentários de primeiro nível por ordem cronológica, tal como o Facebook os ordena; filter=stream devolve comentários de todos os níveis por ordem cronológica, que a Meta sugere para ferramentas de moderação, e summary=true acrescenta um total_count. O campo from contém o ID de âmbito da Página do autor do comentário. list_social_comments lê até 50 comentários de primeiro nível por chamada, cada um com o seu ID, texto, autor, hora e número de respostas.
Como responde a Página em público?
POST /{page-post-id}/comments com message comenta uma publicação, e POST /{comment-id}/comments responde a um comentário, sendo a Página o autor nos dois casos. reply_to_comment publica a resposta pública; com private definido como true, envia ao autor do comentário uma mensagem no Messenger, no prazo de 7 dias após o comentário. Ninguém pode comentar nas publicações de uma Página não publicada, e comentar como utilizador e não como a Página falha com o erro 1705.
Como se ocultam e voltam a mostrar os comentários?
POST /{comment-id} com is_hidden definido como true oculta um comentário, e false volta a mostrá-lo; a Meta indica que o campo se aplica a comentários da Página. hide_comment faz as duas coisas, ocultando por omissão e voltando a mostrar o comentário com hide definido como false. As automatizações podem ocultar o comentário que as desencadeou, qualquer comentário ou um que contenha uma palavra-chave.
Os comentários podem ser eliminados?
Sim, com DELETE /{comment-id}. A tarefa MODERATE da Meta cobre a eliminação de comentários em publicações da Página, pages_read_user_content permite eliminar comentários que as pessoas publicaram na Página, e pages_manage_engagement permite eliminar comentários em publicações da Página. As ferramentas de comentários do easyCoexistence ocultam em vez de eliminar; quando um comentário tem de ser eliminado, elimine-o no Facebook ou no Meta Business Suite.
Que tarefas e permissões a moderação exige?
Um token de alguém que possa executar a tarefa MODERATE na Página: a Meta só devolve IDs de comentários numa publicação da Página a esses tokens, e exige a tarefa para comentar como a Página. As permissões são pages_read_user_content para ler o que outros escreveram e pages_manage_engagement para comentar, com pages_messaging e a tarefa MESSAGING para as respostas privadas.
Como chegam os novos comentários?
Através do webhook do feed da Página, à medida que acontecem: uma alteração com item comment e verb add, que traz o comment_id, o post_id, o autor e a mensagem. A Meta recomenda o webhook em vez de ler o feed, para evitar a limitação de pedidos. O easyCoexistence recebe-o, aplica-lhe as regras de comentário para DM e as automatizações, e reenvia-o para o seu endpoint, se tiver definido um.
Erros comuns
- Esperar ver as respostas na lista predefinida. O filtro toplevel devolve apenas os comentários de primeiro nível; para as conversas, leia a ligação comments do próprio comentário ou use filter=stream.
- Eliminar um comentário que a ocultação resolveria. Um comentário eliminado desaparece, enquanto um oculto volta com is_hidden definido como false.
- Responder às próprias respostas da Página. Estas chegam pelo webhook do feed como os outros comentários, pelo que devem ser ignoradas as que têm from.id igual ao ID da Página.
- Tratar total_count como exato. A Meta indica que pode ser superior ao número de comentários devolvidos, por causa da privacidade ou da eliminação de comentários.
As regras de comentário para DM e as automatizações respondem a comentários a qualquer hora, e as automatizações podem ocultá-los também. De US$ 9 a US$ 0.75 por ligação por mês, a descer à medida que adiciona ligações, com os primeiros 3 dias grátis.
Perguntas frequentes
Porque é que comentar como a Página devolve o erro 1705?
O comentário foi feito como utilizador e não como a Página; a mensagem da Meta diz There was an error posting to this wall.
Porque é que o total_count é superior aos comentários devolvidos?
A Meta indica que o total_count pode exceder o número de comentários devolvidos por uma leitura, por causa da privacidade ou da eliminação de comentários, pelo que deve ser tratado como um valor máximo e não como uma contagem exata.
Pode uma Página responder a uma resposta num comentário?
Sim. Publicar na ligação comments de um comentário responde a esse comentário, sendo a Página o autor.
Porque faltam IDs de comentários nos meus resultados?
A Meta só devolve IDs de comentários numa publicação da Página quando o token vem de alguém que pode executar a tarefa MODERATE nessa Página.
Continue a ler
Ligue o seu primeiro canal em dois minutos.
Sem revisões de plataformas para esperar. Ligue o WhatsApp, o Instagram, o TikTok ou outro canal, peça depois à sua IA que publique, responda ou faça um relatório, e veja-a trabalhar.
- 3 dias grátis
- Cancele quando quiser
- Só APIs oficiais
- Monitorizado 24/7
Verificado em