Webhooks de Meta

Webhooks para cuentas publicitarias

Los Webhooks para cuentas publicitarias te permiten recibir notificaciones en tiempo real de ciertos cambios en los anuncios.

Para configurar Webhooks para cuentas publicitarias, es necesario seguir los siguientes pasos:

  1. Establece tu punto de conexión y configura los Webhooks.
  2. Suscribe tu aplicación en tu cuenta publicitaria.

Configurar un punto de conexión y Webhooks

Sigue nuestra Guía introductoria sobre Webhooks para crear tu punto de conexión y configurar Webhooks. Cuando configures tus webhooks, asegúrate de elegir Ad Account.

Actualmente, puedes recibir notificaciones en tiempo real sobre cambios de estado de objetos publicitarios para WITH_ISSUES y IN_PROCESS. Suscríbete a uno o más de los siguientes campos:

Campo Descripción

with_issues_ad_objects

Te envía una notificación cuando se le otorga el estado WITH_ISSUES a una campaña, un conjunto de anuncios o un anuncio de la cuenta publicitaria.

in_process_ad_objects

Te envía una notificación cuando una campaña, un conjunto de anuncios o un anuncio deja de tener el estado IN_PROCESS. Consulta procesamiento de publicaciones para obtener más información.

Suscribir la app

Necesitas suscribir tu aplicación a las notificaciones de webhooks para tu cuenta publicitaria. Tu aplicación debería tener permiso de edición en la cuenta publicitaria para completar este paso. La aplicación también debería tener el permiso ads_management.

Para suscribir la app, haz que envíe una solicitud POST con el valor subscribed_apps para la cuenta publicitaria:

curl -i -X POST \
  -d "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/<VERSION>/act_<AD_ACCOUNT_ID>/subscribed_apps?app_id=<APP_ID>"

Si se realiza correctamente, verás esta respuesta:

{"success": "true"}

Para ver qué apps se suscribieron en tu cuenta publicitaria, envía una solicitud GET:

curl -i -X GET \
  -d "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/<VERSION>/act_<AD_ACCOUNT_ID>/subscribed_apps"

Si se realiza correctamente, verás esta respuesta:

{
  "data": [
  { 
    "name": "<APP_NAME>", 
    "id": "<APP_ID>" 
  } ]
}

Para eliminar la suscripción de una app, envía una solicitud DELETE:

Si se realiza correctamente, verás esta respuesta:

{"success": "true"}

Suscribirse con el explorador de la API Graph

También puedes suscribir la aplicación con el explorador de la API Graph.

Reemplaza la consulta me?fields=id,name con act_AD_ACCOUNT_ID/subscribed_apps. La app que uses se suscribirá para enviar la solicitud POST en el explorador de la API Graph. También puedes suscribir otra app si estableces subscribed_apps como parámetro de entrada con el identificador de la app.

La app debe tener permiso de edición en la cuenta publicitaria para suscribirse.

[
  {
    "object": "ad_account",
    "entry": [
      {
        "id": "0",
        "time": 1568132516,
        "changes": [
          {
            "field": "with_issues_ad_objects",
            "value": {
              "id": "111111111111",
              "level": "AD",
              "error_code": "567",
              "error_summary": "error summary",
              "error_message": "error message"
            }
          }
        ]
      }
    ]
  }
]