Webhooks de Meta

Webhooks para cuentas publicitarias

Los webhooks para cuentas publicitarias te permiten recibir notificaciones en tiempo real de determinados cambios que se producen en los anuncios.

A fin de configurar los webhooks para cuentas publicitarias, se necesitan los siguientes pasos:

  1. Configura el extremo y los webhooks.
  2. Suscribe la aplicación en la cuenta publicitaria.

Configurar el extremo y los webhooks

Sigue nuestra guía de introducción de webhooks para crear el extremo y configurar los webhooks. Cuando configures los webhooks, asegúrate de elegir Ad Account.

Actualmente, puedes recibir notificaciones en tiempo real de cambios de estado de objetos de anuncios para WITH_ISSUES e IN_PROCESS. Suscríbete a uno o varios de los siguientes campos:

Campo Descripción

with_issues_ad_objects

Te notifica cuando una campaña, conjunto de anuncios o anuncio de la cuenta publicitaria recibe el estado WITH_ISSUES.

in_process_ad_objects

Te notifica cuando una campaña, conjunto de anuncios o anuncio abandona el estado IN_PROCESS. Consulta Posprocesamiento para obtener más información.

Suscribir la aplicación

Debes suscribir la aplicación a las notificaciones de webhooks de la cuenta publicitaria. La aplicación debe tener permiso de edición en la cuenta publicitaria para completar este paso. La aplicación también debe tener el permiso ads_management.

Para suscribir la aplicación, haz que envíe una solicitud POSTsubscribed_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 el proceso se completa correctamente, verás esta respuesta:

{"success": "true"}

Si quieres ver qué aplicaciones están suscritas para la 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 el proceso se completa correctamente, verás esta respuesta:

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

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

Si el proceso se completa correctamente, verás esta respuesta:

{"success": "true"}

Suscribir 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 por act_AD_ACCOUNT_ID/subscribed_apps. Suscribirá la aplicación que usas para enviar la solicitud POST en el explorador de la API Graph. También puedes especificar subscribed_apps como parámetro de entrada con el identificador de la aplicación para suscribir una aplicación distinta.

La aplicación debe tener permiso de edición en la cuenta publicitaria para poder 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"
            }
          }
        ]
      }
    ]
  }
]