Webhooks de Meta

Perímetro de suscripciones

Puedes usar el perímetro /app/subscriptions de la API Graph para configurar y administrar el producto Webhooks de tu aplicación. Consulta la documentación sobre dicho perímetro para comprobar las operaciones que se pueden realizar con él y los permisos que se necesitan. En este documento solo se describen algunas operaciones comunes.

Creación de suscripciones

Para suscribirte a un objeto y sus campos, envía una solicitud POST al perímetro /app/subscriptions e incluye los parámetros siguientes:

  • object: tipo de objeto para el que quieres configurar las suscripciones de campo (por ejemplo, user).
  • callback_url: URL del extremo.
  • verify_token: objeto de tipo string que se incluirá cada vez que te enviemos una solicitud de verificación.
  • fields: campos a los que quieres suscribirte (por ejemplo, photos).

Por ejemplo, si el identificador de tu aplicación es 188559381496048 y quieres recibir una notificación cuando un usuario publique una nueva foto, puedes hacer lo siguiente:

Ejemplo de solicitud

curl -F "object=user" \ -F "callback_url=https://your-clever-domain-name.com/webhooks" \ -F "fields=photos" \ -F "verify_token=your-verify-token" \ -F "access_token=your-app-access-token" \ "https://graph.facebook.com/188559381496048/subscriptions"

Ejemplo de respuesta

Si la operación se completa correctamente:

{
  "success": "true"
}

Obtención de información de la suscripción

Para consultar las suscripciones de objeto o campo configuradas para la aplicación, envía una solicitud GET al perímetro /app/subscriptions. Por ejemplo, si el identificador de la aplicación es 188559381496048, puedes hacer lo siguiente:

Ejemplo de solicitud

GET graph.facebook.com/188559381496048/subscriptions

Ejemplo de respuesta

{ "data": [ { "object": "user", "callback_url": "https://your-clever-domain-name.com/webhooks", "active": true, "fields": [ { "name": "photos", "version": "v2.10" }, { "name": "feed", "version": "v2.10" } ] } ] }