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.
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.
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.
Um campo separado do Messenger para as mensagens que a Página envia, disponível apenas para conversas do Messenger.
Tarefa da Página necessária para assinar leadgen, com leads_retrieval, ads_management, pages_read_engagement e pages_manage_metadata.
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:
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:
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_updateecall_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_integrityemessaging_integrity: atualizações de integridade, com violações, restrições e eventos de ação embusiness_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 epublic_transit. - Estabelecimento:
price_range,payment_options, attire eculinary_team. - Pessoal: birthday,
personal_infoepersonal_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:
| Permissions | Task of the person behind the token | |
|---|---|---|
| Any field | pages_manage_metadata and pages_show_list | CREATE_CONTENT, MANAGE or MODERATE |
| messages and other Messenger fields | pages_messaging as well | MESSAGING |
| leadgen | leads_retrieval, pages_read_engagement and ads_management as well | ADVERTISE |
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.
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