Iniciar sessãoIniciar teste gratuito
easyCoexistence APIs oficiais

Webhook do feed da Página do Facebook: comentários, publicações e reações

O campo feed dos webhooks de Página do Facebook assinala quase todas as alterações ao feed de uma Página à medida que acontecem. Cada alteração traz um item, como post, comment ou reaction, e um verb, como add, edit ou remove, além dos IDs envolvidos, do autor em from e do texto em message. A Meta envia-o em JSON, assinado com X-Hub-Signature-256.

A easyCoexistence subscreve cada Página que liga ao campo feed e encaminha as suas alterações para o seu endpoint HTTPS à medida que chegam, assinadas com o segredo dessa Página, enquanto as regras de comentário para DM e as automatizações atuam sobre os comentários novos.

10K likes

As notificações do feed sobre gostos de Páginas só são enviadas para Páginas com menos gostos do que este limite.

Ad posts

O campo feed não envia nada sobre as próprias publicações de anúncios, mas envia os comentários nelas.

pages_manage_metadata

A permissão que um administrador da Página com privilégios MODERATE tem de conceder para que os webhooks da Página cheguem a uma aplicação.

1,000

A Meta agrupa a maior parte das atualizações numa única entrega de webhook, embora não garanta o agrupamento.

36 hours

Durante quanto tempo a Meta continua a tentar uma entrega falhada para o endpoint da aplicação, com frequência decrescente.

O que é que o campo feed reporta?

Quase todas as alterações ao feed de uma Página, nas palavras da Meta, como publicações, comentários, reações e partilhas; o que cada alteração traz depende do seu tipo. A Meta não envia nada sobre os próprios anúncios, embora cheguem os comentários neles, e envia notificações sobre gostos da Página só enquanto a Página tiver menos de 10 000 gostos.

O que significam item e verb?

Dois campos do valor de cada alteração indicam o que aconteceu:

  • item: o que mudou, da lista da Meta, que inclui post, status, photo, video, link, share, comment, reaction e album.
  • verb: o que aconteceu, com 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_type que a nomeia.

Qual é o aspeto de uma alteração ao feed?

Um POST cujo JSON tem object definido como page e uma entrada por Página, com o ID da Página, uma hora e uma lista (array) de alterações. Este é o exemplo da própria Meta, de uma pessoa a publicar na Página:

A feed change, as Meta sends it
{
  "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>"
          }
        }
      ]
    }
  ]
}

Que campos pode uma alteração trazer?

A referência da Meta indica estes entre os campos do valor de uma alteração ao feed, presentes conforme o tipo de alteração:

  • post_id, comment_id e parent_id: a publicação, o comentário e aquilo a que pertence.
  • from: o ID e o nome de quem fez a alteração.
  • message: o texto, com link, photo, photos ou video para o conteúdo anexado.
  • created_time, e edited_time para as edições.
  • reaction_type para as reações, e is_hidden para indicar se uma publicação está oculta.
  • post: detalhes como status_type, is_published, updated_time e permalink_url.

Como se subscreve uma Página?

A aplicação 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 as permissões pages_manage_metadata e pages_show_list concedidas. A Meta só envia notificações enquanto a Página tiver a aplicação instalada e não tiver desativado a plataforma de aplicações nas suas definições. A easyCoexistence subscreve cada Página a feed, messages e mention quando a liga.

Como chegam os eventos do feed ao seu endpoint?

A Meta entrega-os à aplicação da easyCoexistence, que verifica o X-Hub-Signature-256, responde à Meta de imediato e encaminha cada entrada de uma Página ligada para o endpoint HTTPS que definiu para ela. O reencaminhamento traz um cabeçalho X-EC-Signature, um HMAC-SHA256 de um carimbo de data/hora e do corpo bruto, assinado com o segredo dessa Página, e é enviado uma única vez, sem cópia guardada e sem novas tentativas. Defina o endpoint com set_social_webhook_destination ou com PUT /channels/:id/webhook na Partner API.

Que alterações ao feed iniciam regras de comentário e automatizações?

Apenas os comentários novos: uma alteração com item comment e verb add numa das publicações da Página. As regras de comentário para DM verificam a sua mensagem em busca das palavras-chave e ignoram os comentários feitos pela própria Página, e as automatizações tratam os comentários a que nenhuma regra respondeu. Edições, ocultações, reações e publicações seguem diretamente para o seu endpoint, se tiver definido um.

Erros comuns

  • Tratar qualquer alteração ao feed como um novo comentário. Verifique item e verb: reações, edições, ocultações e remoções chegam no mesmo campo.
  • Responder aos comentários da própria Página. As respostas dela também chegam como alterações ao feed, por isso ignore as que têm from.id igual ao ID da Página.
  • Assumir uma alteração por entrega. A Meta pode agrupar até 1 000 atualizações, por isso percorra cada entrada e cada alteração nela.
  • Ler entry.time como a hora em que a alteração ocorreu. A Meta define-o como a hora em que a notificação foi enviada; created_time no valor é quando o objeto foi criado.
Fazer isto com a EasyCoexistence

De US$ 9 a US$ 0.75 por ligação por mês, descendo à medida que adiciona ligações, com os primeiros 3 dias gratuitos.

Perguntas frequentes

O webhook do feed inclui comentários?

Sim. Um comentário novo chega como alteração ao feed com item comment e verb add, trazendo comment_id, post_id, from e message.

Recebo webhooks para gostos na Página?

Só para Páginas com menos de 10 000 gostos, segundo a referência de webhooks de Página da Meta.

Os anúncios entram no webhook do feed?

Não as próprias publicações de anúncios, mas os comentários nelas são enviados.

Preciso de uma aplicação própria da Meta para receber os eventos do feed de uma Página?

Não. A Meta entrega-os à aplicação da easyCoexistence, que encaminha cada um para o endpoint que definiu para essa 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