Iniciar sessãoIniciar teste gratuito
easyCoexistence APIs oficiais

Campos de webhook da Página do Facebook: a lista completa

A referência de webhooks de Página da Meta documenta 64 campos de subscrição: feed para publicações, comentários e reações, mention para menções à Página, campos do Messenger como messages, message_echoes, messaging_postbacks e message_reads, e campos de perfil como name, picture, hours e website. Cada um exige pages_manage_metadata, e uma aplicação recebe um campo depois de este estar subscrito tanto ao nível da aplicação como pela Página através de subscribed_apps.

O easyCoexistence subscreve cada Página que liga a feed, messages e mention, e encaminha esses eventos para o seu endpoint HTTPS à medida que chegam, assinados com X-EC-Signature, enquanto as regras de comentários e as automações atuam sobre novos comentários e mensagens.

64

Campos de subscrição documentados na referência de webhooks de Página da Meta, desde feed e mention até aos campos do Messenger e de perfil.

pages_manage_metadata

Permissão que um administrador da Página com privilégios MODERATE tem de conceder antes de os webhooks da Página chegarem a uma aplicação.

message_echoes

Um campo separado do Messenger para as mensagens que a Página envia, disponível apenas para conversas do Messenger.

ADVERTISE

Tarefa da Página necessária para subscrever leadgen, com leads_retrieval, ads_management, pages_read_engagement e pages_manage_metadata.

Both levels

Só os campos subscritos tanto na Página como na aplicação produzem webhooks.

Como estão organizados os campos de webhook da Página?

A Meta documenta-os numa única referência para o objeto Page, e distribuem-se por três famílias: atividade na Página e à sua volta, conversas do Messenger e alterações aos dados da própria Página. Os campos de feed, de menção e de perfil chegam em entry.changes, cada um com o seu campo identificado, ou como changed_fields quando a aplicação desativou Include Values; os eventos do Messenger chegam em entry.messaging ou, para uma aplicação que não é dona da conversa, em entry.standby.

Que campos indicam atividade na Página?

Doze campos cobrem conteúdo e atividade, e não conversas. Um comentário novo, por exemplo, chega em feed como uma alteração com item definido como comment e verb definido como add, juntamente com reações, partilhas e as publicações da própria Página. O que cada um envia, na referência da Meta:

feedNearly all changes to the Page's feed: posts, comments, reactions, shares; likes only below 10,000 likes
mentionNew mentions of the Page in posts and comments; some IDs it returns cannot be queried
ratingsNew ratings, and comments or reactions on a rating
videosChanges to the encoding status of a video on the Page
live_videosChanges to a live video's status, with its ID
leadgenNew leads from the Page's lead ads, with leadgen_id, form_id and ad_id
group_feedComments on the Page's posts in the business's Facebook Group
product_reviewA product item's review status: pending, approved, rejected or outdated
inbox_labelsLabel changes on people in the Page inbox: the user, the action and the label
page_upcoming_changeUpcoming changes to the Page, with their type and effective time
page_change_proposalProposals to change the Page, created, accepted or rejected
invoice_access_invoice_draft_changeChanges to an invoice draft, such as its shipping address

Que campos transportam eventos do Messenger?

O Messenger tem a lista mais longa, e o guia de webhooks do Messenger da Meta diz o que cada campo envia. Estes treze cobrem as conversas de uma Página; standby, que transporta mensagens para uma aplicação que não é dona da conversa, está documentado nesse guia e não na referência da Página:

messagesA message from a person, through any entry point, with text or attachments
message_echoesA message the Page sent, with the app_id of the app that sent it
message_deliveriesA message from the Page was delivered
message_readsThe person read a message from the Page
message_reactionsThe person reacted to a message from the Page
message_editsThe person edited a message they had sent
messaging_postbacksA tap on a postback button, Get Started or a persistent menu item
messaging_referralsThe person came back to the conversation through an m.me link or an ad
messaging_optinsA Messenger plugin click, an accepted message request or a checkbox opt-in
messaging_handoversThread control passed, taken or requested between apps
messaging_policy_enforcementA policy warning, block or unblock on the Page's messaging
messaging_account_linkingThe person linked or unlinked their account with the business
response_feedbackFeedback buttons, such as thumbs up or down, on a message the Page sent

Que outros campos do Messenger existem?

Dez outros servem produtos específicos, desde chamadas até comércio e relatórios de integridade:

  • send_cart: uma mensagem com informação de carrinho ou encomenda; message_context: deteções que os modelos da Meta fazem sobre uma mensagem, com um nome de evento e uma pontuação.
  • calls, call_settings_update e call_permission_reply: chamadas de voz do Messenger, alterações às definições de chamada da Página e a resposta de uma pessoa a um pedido de permissão para ligar.
  • messaging_customer_information: o que uma pessoa introduziu num ecrã de informação do cliente; messaging_in_thread_lead_form_submit: um formulário de interessado submetido dentro da conversa.
  • message_template_status_update: o estado de revisão de um template de mensagem de utilidade foi alterado.
  • business_integrity e messaging_integrity: atualizações de integridade, com violações, restrições e ações em business_integrity.

Que campos reportam alterações ao perfil da Página?

Vinte e nove campos reportam alterações aos dados da própria Página, um campo por dado, cada um chegando como uma alteração que o identifica:

  • Identidade: name, picture, category, que comporta até três categorias, e description, a Story Description.
  • Dados empresariais: company_overview, mission, founded, products, general_info, general_manager, members, awards e affiliation.
  • Contacto e local: email, phone, website, location, hours, current_location, hometown, parking e public_transit.
  • Estabelecimento: price_range, payment_options, attire e culinary_team.
  • Pessoal: birthday, personal_info e personal_interests.

Que permissão precisa cada campo?

pages_manage_metadata para qualquer um deles, concedida por um administrador da Página com privilégios MODERATE, e mais para alguns. A Página é subscrita através de subscribed_apps, e os guias da Meta definem o token e as permissões para cada tipo de campo; para receber eventos sobre pessoas fora dos papéis próprios da aplicação, as permissões exigem também Advanced Access:

PermissionsTask of the person behind the token
Any fieldpages_manage_metadata and pages_show_listCREATE_CONTENT, MANAGE or MODERATE
messages and other Messenger fieldspages_messaging as wellMESSAGING
leadgenleads_retrieval, pages_read_engagement and ads_management as wellADVERTISE

Que campos subscreve o easyCoexistence?

Três: feed, messages e mention. Quando uma Página se liga, o easyCoexistence envia POST /{page-id}/subscribed_apps com esses campos e o token da Página, e depois encaminha cada entrada dessa Página para o endpoint que definiu, assinada com X-EC-Signature. As regras de comentários e as automações atuam sobre os novos comentários de feed e sobre as mensagens, e as menções são encaminhadas tal como chegam. Nenhum outro campo é subscrito, por isso ecos, postbacks, confirmações de leitura, transferências, standby e alterações de perfil não são encaminhados.

Erros comuns

  • Subscrever a Página a um campo que a aplicação não subscreveu. A Meta só entrega campos subscritos tanto na Página como na aplicação.
  • Interpretar eventos do Messenger como alterações. Chegam em entry.messaging, com um objeto messaging por entrada, e não em entry.changes.
  • Esperar as respostas da própria Página nas mensagens. As mensagens que a Página envia chegam em message_echoes, um campo separado.
  • Contar com feed para os gostos numa Página grande. A Meta só envia notificações de gostos para Páginas com menos de 10 000 gostos.
Fazer isto com a EasyCoexistence

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

Perguntas frequentes

A feed inclui comentários em anúncios?

Sim. A Meta não envia nada pelas próprias publicações de anúncios, mas os comentários nelas chegam em feed.

O que muda com a definição Include Values?

Ligada, uma alteração traz os novos valores em changes. Desligada, a Meta envia apenas os nomes dos campos alterados, em changed_fields.

Como vejo a que campos uma Página está subscrita?

GET /{page-id}/subscribed_apps com o token da Página lista as aplicações instaladas pela Página e, para cada uma, os seus subscribed_fields.

O easyCoexistence encaminha alterações ao perfil da Página?

Não. As Páginas ligadas ao easyCoexistence estão subscritas apenas a feed, messages e mention, por isso name, picture e os outros campos de perfil não são encaminhados.

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