Suscribir una Página de Facebook a webhooks: el edge subscribed_apps
Una Página de Facebook se suscribe a los webhooks de una app con POST /{page-id}/subscribed_apps, enviando subscribed_fields como feed,messages y un token de acceso de Página de alguien con la tarea CREATE_CONTENT, MANAGE o MODERATE, con pages_manage_metadata y pages_show_list concedidos. Meta envía los eventos de un campo solo si la app también se suscribe a él; GET lista la suscripción y DELETE la elimina.
easyCoexistence suscribe cada Página que conectas a feed, messages y mention mediante subscribed_apps, la desuscribe al eliminarla, y reenvía los eventos de la Página a tu endpoint HTTPS firmados con un secreto propio de esa Página, desde un único conector MCP o desde la Partner API.
Solo los campos suscritos tanto a nivel de Página como de app producen webhooks; una Página puede listar más que la app.
Tareas de Página, una de ellas necesaria para que la persona detrás del token lea o cree una suscripción.
Se devuelve junto a success cuando una app elimina su suscripción de webhook de una Página con DELETE.
Lo que requiere /{app-id}/subscriptions para leer, crear o eliminar la suscripción a nivel de app.
De las entregas fallidas de Messenger antes de que Meta desuscriba la app de la Página hasta que vuelva a suscribirse.
¿Qué hace el edge subscribed_apps?
Instala la app en la Página y define qué campos de webhook de la Página recibe. Meta envía notificaciones solo mientras la Página tenga la app instalada y no haya desactivado la plataforma de apps en su configuración, y solo para los campos suscritos en ambos niveles: los de la Página, mediante este edge, y los de la app, configurados en el App Dashboard o mediante /{app-id}/subscriptions. Una Página puede suscribirse a más campos que la app.
¿Cómo se suscribe una Página?
Con un POST al edge, con subscribed_fields que liste los campos separados por comas, y el token de acceso de la Página. Una llamada exitosa devuelve success true, y una llamada que incluya messages también necesita pages_messaging en el token:
POST https://graph.facebook.com/{page-id}/subscribed_apps
?subscribed_fields=feed,messages,mention
&access_token=<PAGE_ACCESS_TOKEN>
{ "success": true }¿Qué token, tareas y permisos necesita?
Un token de acceso de Página, que vincula la llamada a una sola Página, de alguien que pueda actuar sobre esa Página. Las referencias y guías de Meta establecen estos requisitos:
- Cualquier campo: una persona con la tarea
CREATE_CONTENT, MANAGE o MODERATE, ypages_manage_metadatajunto conpages_show_list. - messages y los demás campos de Messenger: además
pages_messaging, en un token de alguien que pueda realizar la tarea MESSAGING. - leadgen: la tarea ADVERTISE, con
leads_retrieval,pages_read_engagementyads_management. - Leer la suscripción con GET requiere las mismas tareas y permisos que crearla.
¿Qué nivel de acceso necesitan los campos?
Advanced Access, para Páginas y personas fuera de los roles propios de la app. Con Standard Access, las notificaciones de Messenger llegan solo de personas con un rol en la app, como sus administradores, desarrolladores y probadores; Advanced Access, otorgado permiso por permiso mediante App Review y que requiere Business Verification, las abre a los clientes de la app. La guía de Messenger de Meta también incluye publicar la app entre los requisitos previos.
¿Qué es la suscripción a nivel de app?
La otra mitad: los campos que la propia app escucha, con su URL de callback. Se configura en el App Dashboard o con POST /{app-id}/subscriptions y un token de acceso de app, pasando object=page, callback_url, fields, include_values y verify_token, lo que dispara la petición de verificación de Meta. GET sobre el mismo edge muestra el callback_url, los fields de cada objeto y si la suscripción está activa; un nuevo POST modifica los campos sin sobrescribir los demás, y DELETE elimina todos los campos o solo los indicados.
¿Cómo se revisa a qué está suscrita una Página?
Con un GET sobre el mismo edge y el token de la Página. El array data lista cada app que la Página tiene instalada, con su name, ID y subscribed_fields, y vuelve vacío cuando la Página no tiene apps instaladas:
GET https://graph.facebook.com/{page-id}/subscribed_apps
?access_token=<PAGE_ACCESS_TOKEN>
{
"data": [
{
"category": "Business",
"link": "https://example.com/app",
"name": "<APP_NAME>",
"id": "<APP_ID>",
"subscribed_fields": ["feed", "messages", "mention"]
}
]
}¿Cómo se elimina una suscripción?
Con DELETE /{page-id}/subscribed_apps, que desvincula la app de la Página; una app puede eliminar su propia suscripción con un token de acceso de app, y la respuesta incluye success y messaging_success. Meta también la elimina por su cuenta: tras una hora de entregas fallidas de Messenger, la app se desuscribe de la Página y debe volver a suscribirse cuando su endpoint funcione.
¿Qué hace easyCoexistence al conectar?
Suscribe cada Página que elige la persona, justo después de guardar el token de esa Página: POST /{page-id}/subscribed_apps con subscribed_fields en feed,messages,mention. Si Meta lo rechaza, la Página sigue conectada y list_social_accounts muestra el motivo en last_error. Al quitar la Página, se envía DELETE /{page-id}/subscribed_apps antes de descartar el token, y ninguna herramienta llega a las rutas subscribed_apps ni de token, de modo que la suscripción la gestiona únicamente easyCoexistence.
Errores comunes
- Llamar al edge con un token de acceso de usuario. Requiere el token de acceso de la Página que se va a suscribir.
- Suscribir la Página pero no la app. Un campo llega al callback solo si la suscripción propia de la app también lo incluye.
- Omitir pages_messaging al suscribirse a messages. Meta lo exige, en un token de alguien que pueda realizar la tarea MESSAGING.
- Olvidar volver a suscribirse tras una caída. Una hora de entregas fallidas de Messenger desuscribe la app, y los eventos se detienen hasta que se envíe de nuevo el POST.
De US$ 9 a US$ 0.75 por conexión al mes, que baja al añadir conexiones, y los primeros 3 días gratis.
Preguntas frecuentes
¿Hay que suscribir cada Página por separado?
Sí. subscribed_apps funciona por Página, con el token propio de cada una, mientras que la suscripción a nivel de app para el objeto page se aplica a las Páginas que instalaron la app.
¿Por qué subscribed_apps devuelve el error 200?
Meta clasifica el 200 como error de permisos en este edge. Verifica que el token tenga pages_manage_metadata y pages_show_list, y que provenga de alguien con CREATE_CONTENT, MANAGE o MODERATE.
¿Se puede suscribir una Página desde Graph API Explorer?
Sí. La guía de Meta elige la app, obtiene un token de usuario con pages_manage_metadata, lo intercambia por el token de la Página y envía el POST a {page-id}/subscribed_apps.
¿Puedo añadir campos de webhook a una Página conectada a easyCoexistence?
No mediante sus herramientas: ninguna llega a las rutas subscribed_apps, y la Página sigue suscrita a feed, messages y mention, los campos que reenvía easyCoexistence.
Sigue leyendo
Conecta tu primer canal en dos minutos.
Sin esperar revisiones de las plataformas. Conecta WhatsApp, Instagram, TikTok u otro canal, pídele a tu IA que publique, responda o te haga un informe, y míralo trabajar.
- 3 días gratis
- Cancela cuando quieras
- Solo APIs oficiales
- Monitorizado 24/7
Verificado el