Webhook do feed da Página do Facebook: eventos de comentário, post e reação
O campo feed dos webhooks de Página do Facebook informa quase todas as mudanças no feed de uma Página conforme acontecem. Cada mudança traz um item, como post, comentário ou reação, e um verb, como add, edit ou remove, além dos IDs envolvidos, o autor em from e o texto em message. A Meta envia tudo em JSON, assinado com X-Hub-Signature-256.
O easyCoexistence inscreve cada Página que você conecta no campo feed e encaminha as mudanças dela ao seu endpoint HTTPS assim que chegam, assinadas com o segredo daquela Página, enquanto as regras de comentário para DM e as automações atuam sobre os comentários novos.
Notificações do feed sobre curtidas da Página são enviadas apenas para Páginas com menos curtidas do que esta.
O campo feed não envia nada sobre os próprios posts de anúncios, mas envia os comentários neles.
Permissão que um administrador da Página com privilégios MODERATE deve conceder para que os webhooks da Página cheguem a um app.
A maioria das atualizações a Meta agrupa em uma única entrega de webhook, embora não garanta esse agrupamento.
Por quanto tempo a Meta continua repetindo uma entrega com falha para o endpoint do app, com frequência cada vez menor.
O que o campo feed informa?
Quase todas as mudanças no feed de uma Página, nas palavras da Meta, como posts, comentários, reações e compartilhamentos; o que uma mudança traz depende do seu tipo. A Meta não envia nada sobre os próprios posts de anúncios, embora os comentários neles cheguem, e envia notificações de curtidas da Página apenas enquanto a Página tiver menos de 10,000 curtidas.
O que significam item e verb?
Dois campos do valor de cada mudança dizem o que aconteceu:
- item: o que mudou, segundo a lista da Meta, que inclui post, status, photo, video, link, share, comment, reaction e album.
- verb: o que aconteceu com ele: add, edit, edited, delete, remove, hide, unhide, block, unblock, follow, mute ou update.
- Um novo comentário chega com item comment e verb add, que é o que as regras de comentário para DM procuram.
- Uma reação traz item reaction e um
reaction_typeque a nomeia.
Como é uma mudança do feed?
Um POST cujo JSON tem object definido como page e uma entrada por Página, com o ID da Página, um horário e um array de changes. Este é o exemplo da própria Meta, de uma pessoa publicando na Página:
{
"object": "page",
"entry": [
{
"id": "<PAGE_ID>",
"time": 1520544816,
"changes": [
{
"field": "feed",
"value": {
"from": { "id": "<USER_ID>", "name": "<NAME>" },
"item": "post",
"post_id": "<PAGE_POST_ID>",
"verb": "add",
"created_time": 1520544814,
"is_hidden": false,
"message": "<POST_TEXT>"
}
}
]
}
]
}Quais campos uma mudança pode trazer?
A referência da Meta lista estes entre os campos do valor de uma mudança do feed, presentes conforme o tipo da mudança:
post_id,comment_ideparent_id: o post, o comentário e aquilo a que ele pertence.- from: o ID e o nome de quem fez a mudança.
- message: o texto, com link, photo, photos ou video para conteúdo anexado.
created_time, eedited_timepara edições.reaction_typepara reações, eis_hiddenpara indicar se um post está oculto.- post: detalhes como
status_type,is_published,updated_timeepermalink_url.
Como uma Página é inscrita?
O app envia POST /{page-id}/subscribed_apps com subscribed_fields=feed e o token da Página, a partir de alguém que pode executar a tarefa CREATE_CONTENT, MANAGE ou MODERATE, com pages_manage_metadata e pages_show_list concedidas. A Meta envia notificações apenas enquanto a Página tiver o app instalado e não tiver desligado a plataforma de apps nas configurações. O easyCoexistence inscreve cada Página em feed, messages e mention quando ela é conectada.
Como os eventos do feed chegam ao seu endpoint?
A Meta entrega ao app do easyCoexistence, que verifica o X-Hub-Signature-256, responde à Meta imediatamente e encaminha cada entrada de uma Página conectada ao endpoint HTTPS que você definiu para ela. O encaminhamento leva um cabeçalho X-EC-Signature, um HMAC-SHA256 de um timestamp e do corpo bruto, assinado com o segredo daquela Página, e é enviado uma única vez, sem cópia guardada e sem nenhuma repetição. Defina o endpoint com set_social_webhook_destination ou com PUT /channels/:id/webhook na Partner API.
Quais mudanças do feed iniciam regras de comentário e automações?
Somente comentários novos: uma mudança com item comment e verb add em um dos posts da Página. As regras de comentário para DM verificam a mensagem em busca das suas palavras-chave e ignoram os comentários que a própria Página fez, e as automações atuam sobre os comentários que nenhuma regra respondeu. Edições, ocultações, reações e posts seguem direto para o seu endpoint, se você tiver definido um.
Erros comuns
- Tratar qualquer mudança do feed como comentário novo. Confira item e verb: reações, edições, ocultações e remoções chegam no mesmo campo.
- Responder aos próprios comentários da Página. As respostas dela também voltam como mudanças do feed, então ignore as que têm from.id igual ao ID da Página.
- Supor uma mudança por entrega. A Meta pode agrupar até 1,000 atualizações, então percorra cada entry e cada change dentro dela.
- Ler entry.time como o momento da mudança. A Meta o define como o momento em que a notificação foi enviada; created_time no valor é quando o objeto foi criado.
De US$ 9 a US$ 0.75 por número conectado ao mês, caindo conforme você adiciona números, com 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
O webhook do feed inclui comentários?
Sim. Um comentário novo chega como mudança do feed com item comment e verb add, trazendo comment_id, post_id, from e message.
Recebo webhooks de curtidas da Página?
Apenas para Páginas com menos de 10,000 curtidas, segundo a referência de webhooks de Página da Meta.
Posts de anúncios estão no webhook do feed?
Não os posts de anúncios em si, mas os comentários neles são enviados.
Preciso de um app próprio da Meta para receber os eventos do feed de uma Página?
Não. A Meta entrega ao app do easyCoexistence, que encaminha cada evento ao endpoint que você definiu para aquela Página.
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