EntrarComeçar teste grátis
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 assinatura: 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 um app recebe um campo depois de assiná-lo tanto no nível do app quanto pela Página, por meio de subscribed_apps.

O easyCoexistence assina cada Página que você conecta a feed, messages e mention e encaminha esses eventos para o seu endpoint HTTPS assim que chegam, assinados com X-EC-Signature.

64

Campos de assinatura documentados na referência de webhooks de Página da Meta, de feed e mention aos campos do Messenger e de perfil.

pages_manage_metadata

Permissão que um administrador da Página com privilégios MODERATE deve conceder antes que os webhooks da Página cheguem a um app.

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 assinar leadgen, com leads_retrieval, ads_management, pages_read_engagement e pages_manage_metadata.

Both levels

Somente campos assinados tanto na Página quanto no nível do app geram webhooks.

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

A Meta os documenta em uma única página de referência para o objeto Page, e eles se dividem em três famílias: atividade na Página e ao redor dela, conversas do Messenger e edições nos próprios dados da Página. Mudanças de feed, de menções e de perfil chegam em entry.changes, cada uma com o nome do seu campo, ou como changed_fields quando o app desativou Include Values. Eventos do Messenger chegam em entry.messaging, ou em entry.standby para um app que não é dono da conversa.

Quais campos informam atividade na Página?

Doze campos cobrem conteúdo e atividade, e não conversas. Um novo comentário, por exemplo, chega em feed como uma mudança com item definido como comment e verb definido como add, junto com reações, compartilhamentos e as próprias publicações da Página. O que cada um entrega, segundo a 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

Quais campos transportam eventos do Messenger?

O Messenger tem a lista mais longa, e o guia de webhooks do Messenger da Meta explica o que cada campo envia. Estes treze cobrem as conversas de uma Página. standby, que transporta mensagens para um app que não é dono 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

Quais são os outros campos do Messenger?

Outros dez atendem produtos específicos, de chamadas a comércio e denúncias de integridade:

  • send_cart: uma mensagem com informações de carrinho ou pedido. message_context: detecções que os modelos da Meta fazem em uma mensagem, com um nome de evento e uma pontuação.
  • calls, call_settings_update e call_permission_reply: chamadas de voz do Messenger, mudanças nas configurações de chamada da Página e a resposta de uma pessoa a uma solicitação de permissão para ligar.
  • messaging_customer_information: o que uma pessoa preencheu em uma tela de informações do cliente. messaging_in_thread_lead_form_submit: um formulário de lead enviado dentro da conversa.
  • message_template_status_update: o status de revisão de um template de mensagem utilitária foi alterado.
  • business_integrity e messaging_integrity: atualizações de integridade, com violações, restrições e eventos de ação em business_integrity.

Quais campos informam mudanças no perfil da Página?

Vinte e nove campos informam edições nos próprios dados da Página, um campo por dado, e cada um chega como uma mudança que o nomeia:

  • Identidade: name, picture, category, que aceita até três categorias, e description, a Story Description.
  • Dados do negócio: company_overview, mission, founded, products, general_info, general_manager, members, awards e affiliation.
  • Contato 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.

Qual permissão cada campo exige?

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 é assinada por meio de subscribed_apps, e os guias da Meta definem o token e as permissões por tipo de campo. Para receber eventos sobre pessoas fora dos papéis do próprio app, as permissões também precisam de 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

Quais campos o easyCoexistence assina?

Três: feed, messages e mention. Quando uma Página se conecta, 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 você definiu, assinada com X-EC-Signature. Regras de comentário e automações agem sobre novos comentários vindos de feed e sobre mensagens, e as menções são encaminhadas como chegam. Nenhum outro campo é assinado, então message_echoes, postbacks, confirmações de leitura, handovers, standby e mudanças de perfil não são encaminhados.

Erros comuns

  • Assinar a Página em um campo que o app não assinou. A Meta só entrega campos assinados tanto na Página quanto no nível do app.
  • Interpretar eventos do Messenger como mudanças. Eles 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 curtidas em uma Página grande. A Meta envia notificações de curtidas apenas para Páginas com menos de 10,000 curtidas.
Fazendo isso com o EasyCoexistence

Regras de comentário e automações agem sobre novos comentários e mensagens. De US$ 9 até US$ 0.75 por número conectado por 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 campo 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 a configuração Include Values altera?

Com ela ativada, uma mudança traz os novos valores em changes. Com ela desativada, a Meta envia apenas os nomes dos campos alterados, em changed_fields.

Como vejo quais campos uma Página está assinando?

GET /{page-id}/subscribed_apps com o token da Página lista os apps instalados pela Página e, para cada um, seus subscribed_fields.

O easyCoexistence encaminha mudanças de perfil da Página?

Não. As Páginas conectadas ao easyCoexistence são assinadas apenas em feed, messages e mention, então name, picture e os demais campos de perfil não são encaminhados.

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