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.
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.
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.
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 subscrever leadgen, com leads_retrieval, ads_management, pages_read_engagement e pages_manage_metadata.
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:
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:
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_updateecall_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_integrityemessaging_integrity: atualizações de integridade, com violações, restrições e ações embusiness_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 epublic_transit. - Estabelecimento:
price_range,payment_options, attire eculinary_team. - Pessoal: birthday,
personal_infoepersonal_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:
| 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 |
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.
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