> For the complete documentation index, see [llms.txt](https://help.impact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.impact.com/brand/es/what-would-you-like-to-learn-about/account-administration/account-settings/notifications/enable-event-notification-postbacks-for-brands.md).

# Habilita las devoluciones de notificación de eventos para las marcas

Las notificaciones de eventos mediante callbacks (webhooks) avisan a tus sistemas internos en tiempo real cuando se producen eventos específicos. Aunque los datos enviados varían según el evento, el proceso de configuración es el mismo para todos.

{% stepper %}
{% step %}

## Acceder a las notificaciones de eventos mediante callbacks

1. En la barra de navegación superior, selecciona ![](https://3147719151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2F210dEQa93qyQgoJDkieL%2FUser%20profile.svg?alt=media\&token=f84c5b17-fae4-4a30-990a-9de5e57a150b) **\[Perfil de usuario] → Configuración**.
2. En la sección *Técnica* , selecciona [**Notificaciones de eventos**](https://app.impact.com/secure/advertiser/accountSettings/techintegration/view-edit-adv-pingback-settings-flow.ihtml?).
   {% endstep %}

{% step %}

## Completa los campos de configuración global

1. Coloca el cursor sobre el evento para el que quieras configurar una notificación mediante callback y selecciona ![](https://3147719151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fkka3dqJOx8ZhiX82RDLt%2FEdit_light.svg?alt=media\&token=f454405c-ebd8-49af-90db-22efc27476bf) **\[Editar]**.
2. Usa la tabla siguiente para configurar los ajustes de entrega:

<table><thead><tr><th width="225.36328125">Campo</th><th>Descripción</th></tr></thead><tbody><tr><td>URL</td><td>El endpoint de tu servidor que recibirá los datos.</td></tr><tr><td>Método HTTP</td><td><p><code>GET</code>: los datos se añaden a la URL como parámetros de consulta.</p><p><code>POST</code>: los datos se envían en el cuerpo de la solicitud, que incluye varios parámetros opcionales que puedes configurar.<br><br>Consulta <a href="#notification-events-and-payloads">Eventos de notificación y cargas útiles</a> para obtener más información sobre cada evento y el contenido de su carga útil.</p></td></tr><tr><td>Encabezado HTTP</td><td>(Opcional) Añade encabezados personalizados para la autenticación (por ejemplo, <code>Authorization: Bearer token</code>).</td></tr><tr><td>Retraso mínimo</td><td>Establece el <em>Retraso mínimo</em> en segundos para proteger tu servidor de los picos de tráfico.</td></tr><tr><td>Solicitudes máximas</td><td>Establece el límite de <em>Solicitudes máximas</em> por segundo para proteger tu servidor de los picos de tráfico.</td></tr><tr><td>Respuesta de éxito</td><td>La cadena de texto específica o el código de estado HTTP que devuelve tu servidor cuando se procesa correctamente una notificación mediante callback.</td></tr><tr><td>Respuesta de error</td><td>La cadena de texto o el código de estado que indica un error (por ejemplo, <code>ERROR</code> o <code>500</code>).</td></tr></tbody></table>
{% endstep %}
{% endstepper %}

## Eventos de notificación y cargas útiles

Cada notificación de evento envía un conjunto único de puntos de datos configurables (por ejemplo, `{ActionId}`). Consulta los eventos siguientes para saber qué puntos de datos puedes extraer de las cargas útiles.

<details>

<summary>Eventos del ciclo de vida de las acciones</summary>

Los eventos del ciclo de vida de las acciones envían una solicitud HTTP a una URL especificada (y a los parámetros incluidos) cuando se registra, modifica o revierte una acción.

```json
// Un ejemplo de POST en formato JSON
{
  "CampaignId": 9876, // ID del programa
  "ActionTrackerId": 12345, // ID del tipo de evento
  "MediaPartnerId": 555, // ID del socio
  "CampaignName": "Spring Global Promotion", // Nombre del programa
  "ActionTrackerName": "Standard Sale Tracker", // Nombre del tipo de evento
  "MediaPartnerName": "Top Tier Affiliates", // Nombre del socio
  "ActionId": "ACT-778899", // ID de la acción
  "Status": "MODIFIED", // Estado de la acción
  "StatusDetail": "Devolución de artículo: pago ajustado", // Más detalles sobre el estado de la acción
  "AdId": 44332, // ID del anuncio
  "Payout": 10.50, // Pago de la acción al socio, en la moneda del socio
  "DeltaPayout": -5.00, // Importe de pago corregido de la acción anterior
  "IntendedPayout": 15.50, // Importe de pago previsto para una acción que supera el límite
  "Amount": 100.00, // Importe de la acción, en la moneda de la cuenta
  "DeltaAmount": -50.00, // Importe corregido de la acción anterior
  "IntendedAmount": 150.00, // Importe de venta previsto para una acción que supera el límite
  "Currency": "USD", // Moneda de la acción
  "OriginalCurrency": "USD", // Moneda original (es decir, del carrito) de la acción
  "OriginalAmount": 100.00, // Importe original (es decir, del carrito) de la acción
  // Colección "items": datos de los artículos individuales de esta acción
  "items": [{join(items, i, 
  "\{\"sku\":\"{i.sku}\",
  \"item_price\":{i.amt},
  \"category\":\"{i.cat}\",
  \"quantity\":{i.qty},
  \"cartamt\":{i.cartamt},
  \"rbt\":\"{i.rbt}\",
  \"name\":\"{i.name}\"\}")}],
  "EventDate": "2026-04-08T09:00:00Z", // Fecha de conversión
  "CreationDate": "2026-04-08T09:05:00Z", // Fecha de creación en el sistema
  "LockingDate": "2026-05-08T00:00:00Z", // Fecha en que se bloqueará la acción
  "ClearedDate": "2026-05-15T00:00:00Z", // Fecha prevista de liquidación
  "ReferringDomain": "blog.partner.com", // Dominio de referencia
  "LandingPageUrl": "https://brand.com/sale", // URL de la página de destino
  "RefCustomerArea": "California", // Zona del cliente (derivada de la IP)
  "RefCustomerCity": "San Francisco", // Ciudad del cliente (derivada de la IP)
  "RefCustomerRegion": "CA", // Región del cliente (derivada de la IP)
  "RefCustomerCountry": "US", // Código de país del cliente (derivado de la IP)
  "RefClickId": "CLK9988776655", // Identificador único del clic
  "SharedId": "social_post_01", // ID compartido del socio
  "PromoCode": "SAVE20", // Código promocional general
  "CustomerStatus": "EXISTING", // Estado del cliente
  "Oid": "ORD-554433", // ID del pedido
  "Note": "Partial return processed", // Nota proporcionada con la acción
  "CustomerPostCode": "94105", // Código postal del cliente
  "CustomerCity": "San Francisco", // Ciudad del cliente
  "CustomerCountry": "US", // Código de país del cliente
  "CustomerRegion": "CA", // Región del cliente
  "CustomerId": "CUST-12345", // ID del cliente
  "CustomerEmail": "a665a45920422f9d417...", // Correo electrónico del cliente con hash
  "IpAddress": "192.168.1.1", // Dirección IP
  "CallerId": null, // Número de teléfono de quien llama
  // Campos complementarios personalizados
  "Text1": "Custom Val 1", // Texto 1
  "Date1": "2026-04-08", // Fecha 1
  "Money1": 10.00, // Importe 1
  "Numeric1": 1, // Valor numérico 1
  // Metadatos del dispositivo y la aplicación
  "appPackage": "com.brand.app", // Paquete de la aplicación móvil
  "appName": "BrandStore", // Nombre de la aplicación móvil
  "appVersion": "4.2.1", // Versión de la aplicación móvil
  "deviceOs": "iOS", // Sistema operativo del dispositivo
  "deviceOsVersion": "17.4", // Versión del sistema operativo del dispositivo
  "deviceManuf": "Apple", // Fabricante del dispositivo
  "deviceModel": "iPhone 15", // Modelo del dispositivo
  "macAddress": "00:1B:44:11:3A:B7", // Dirección MAC (mayúsculas)
  "macAddressLower": "00:1b:44:11:3a:b7", // Dirección MAC (minúsculas)
  "macAddressAlpha": "001B44113AB7", // Dirección MAC (sin dos puntos)
  "macAddressSha1": "47a32...", // SHA-1 de la dirección MAC
  "iosIfa": "EA7583CD-A667-48BC-B806-42ECB2B48606", // ID de publicidad de iOS
  "iosAdTracking": "1", // Configuración del seguimiento de anuncios en iOS
  "androidId": null, // ID de Android
  "deviceId": "D-556677", // ID del dispositivo
  "deviceIp": "192.168.1.1" // Dirección IP del dispositivo
}
```

</details>

<details>

<summary>Eventos de consulta de acciones</summary>

Los eventos de consulta de acciones enviarán una solicitud HTTP a una URL especificada (y a los parámetros incluidos) cuando se creen o resuelvan consultas de acciones.

```json
// Un ejemplo de POST en formato JSON
{
  "Id": 554433, // Identificador único de la consulta de acción en el sistema
  "MediaPartnerId": 555, // ID del socio
  "MediaPartnerName": "Top Tier Affiliates", // Nombre del socio
  "CampaignId": 9876, // ID del programa
  "CampaignName": "Spring Global Promotion", // Nombre del programa
  "OrderId": "ORD-12345", // ID del pedido de la acción notificada
  "TransactionDate": "2026-04-01T14:30:00Z", // Fecha de la transacción del evento que desencadenó la consulta de acción
  "TransactionAmount": 250.00, // Importe de la transacción del evento que desencadenó la consulta de acción
  "InquiryType": "MISSING_ACTION", // Tipo de consulta de acción
  "ExpectedPayout": 25.00, // Importe de la comisión que espera recibir el socio
  "ResolutionDeadlineDate": "2026-05-01T00:00:00Z", // Fecha límite para aceptar o rechazar la consulta
  "TrackingLink": "https://proweb.com/click?cid=1&pid=555", // Enlace de seguimiento proporcionado por el socio
  "ActionId": "ACT-999000", // ID de la acción (si está asociada a una acción existente)
  "AutoApprovalDate": "2026-05-05T00:00:00Z", // Fecha en que el sistema ejecutará las reglas de aprobación automática
  "ResolutionStatus": "PENDING", // Estado final de resolución de la consulta de acción
  "RejectReason": null, // Motivo por el que se rechazó la consulta de acción
  "FinalPayout": 0.00, // Importe final de la comisión asociada a la consulta de acción
  "ResolutionDate": null, // Fecha en que se resolvió la consulta
  "CreationDate": "2026-04-08T10:05:00Z", // Fecha en que se creó la consulta en el sistema
  "InquiryNotes": "Customer claims they clicked the link but no credit was shown.", // Notas de la consulta enviadas por el socio
  "ResolutionNotes": null, // Notas enviadas al resolver la consulta
  "Comments": "[{\"user\": \"support_agent\", \"text\": \"Verifying click logs now.\"}, {\"user\": \"partner\", \"text\": \"Customer provided receipt.\"}]" // Comentarios añadidos a la consulta (en formato JSON)
}
```

</details>

<details>

<summary>Eventos de liquidación de acciones</summary>

Los eventos de liquidación de acciones enviarán una solicitud HTTP a una URL especificada (y a los parámetros incluidos) cuando se liquiden las acciones.

```json
// Un ejemplo de POST en formato JSON
{
  "ActionTrackerId": 12345, // ID del tipo de evento
  "ActionTrackerName": "Standard Sale Tracker", // Nombre del tipo de evento
  "CampaignId": 9876, // ID del programa
  "CampaignName": "Spring Global Promotion", // Nombre del programa
  "MediaPartnerId": 555, // ID del socio
  "MediaPartnerName": "Top Tier Affiliates", // Nombre del socio
  "OrderIds": "ORD-9921,ORD-9922", // ID de los pedidos de las acciones notificadas (separados por comas)
  "ActionIds": "ACT-101,ACT-102", // ID de las acciones (separados por comas)
  "ClearedDate": "2026-04-15T12:00:00Z", // Fecha (ISO 8601) en que está previsto que se liquide la acción
  "LedgerDate": "2026-04-08T09:54:43Z" // Fecha (ISO 8601) en que se liquidó la acción
}
```

</details>

<details>

<summary>Eventos de solicitud de valores de seguimiento</summary>

Los eventos de solicitud de valores de seguimiento enviarán una solicitud HTTP a una URL especificada (y a los parámetros incluidos) cuando se creen solicitudes de seguimiento.

```json
// Un ejemplo de POST en formato JSON
{
  "CampaignId": 9876, // ID del programa
  "ActionTrackerId": 12345, // ID del tipo de evento
  "MediaPartnerId": 555, // ID del socio
  "ActionId": "ACT-778899", // ID de la acción
  "Amount": 150.00, // Importe de la acción en la moneda de la cuenta
  "Currency": "USD", // Moneda de la acción
  "Oid": "ORD-554433", // ID del pedido
  // Colección "items": desglose de los productos individuales de la acción
  "items": [{join(items, i, "\{\"sku\":\"{i.sku}\",\"item_price\":{i.amt},\"category\":\"{i.cat}\",\"quantity\":{i.qty},\"cartamt\":{i.cartamt},\"rbt\":\"{i.rbt}\",\"name\":\"{i.name}\"\}")}],
  "EventDate": "2026-04-08T09:00:00Z", // Fecha de conversión
  "IpAddress": "192.168.1.1", // Dirección IP del dispositivo
  "RefClickId": "CLK9988776655" // Identificador único del clic
}
```

</details>

<details>

<summary>Eventos de trabajos completados</summary>

Los eventos de trabajos completados enviarán una solicitud HTTP a una URL especificada (y con cualquier parámetro adicional) cuando se complete un trabajo de [Exportación de informes](https://integrations.impact.com/brand-api-reference/reference/report-export/report-export) o [Haz clic en Exportar](https://integrations.impact.com/brand-api-reference/reference/clicks/clickexport).

```json
// Un ejemplo de POST en formato JSON
{
  "JobId": 10293847, // ID único del trabajo
  "JobType": "REPORT_EXPORT", // Tipo de trabajo
  "AccountId": 7744, // ID de cuenta
  "StartDate": "2026-04-08T10:00:05Z", // Hora de inicio del trabajo
  "EndDate": "2026-04-08T10:11:02Z", // Hora en que se completó el trabajo
  "RecordsProcessed": 5240, // Número de registros procesados o generados
  "ApiJobDetailUri": "https://api.impact.com/jobs/10293847", // URI de la API para obtener más detalles sobre el trabajo
  "ApiResultUri": "https://api.impact.com/jobs/10293847/result", // URI de la API para obtener el resultado del trabajo
  "ResultDownloadUrlExp5": "https://download.impact.com/file?token=a1b2...&exp=5min", // URL para descargar el resultado (expira en 5 minutos)
  "ResultDownloadUrlExp15": "https://download.impact.com/file?token=a1b2...&exp=15min", // URL para descargar el resultado (expira en 15 minutos)
  "ResultDownloadUrlExp30": "https://download.impact.com/file?token=a1b2...&exp=30min", // URL para descargar el resultado (expira en 30 minutos)
  "ResultDownloadUrlExp60": "https://download.impact.com/file?token=a1b2...&exp=60min" // URL para descargar el resultado (expira en 60 minutos)
}
```

</details>

<details>

<summary>Eventos de aplicaciones de publishers</summary>

{% hint style="success" %}
**Nota:** Esta funcionalidad está en fase beta. Ponte en contacto con tu CSM o con nuestro [equipo de soporte](https://app.impact.com/support/portal.ihtml?createTicket=true&) si quieres probar esta función.
{% endhint %}

Los eventos de aplicaciones de publishers enviarán una solicitud HTTP a una URL especificada cuando un partner envíe una solicitud y cada vez que esta se apruebe, rechace o retire.

Los eventos de aplicaciones de publishers también se conocen como el callback de eventos de contrato, webhook de procesamiento de solicitudes o webhook de solicitudes.

Si se envía un payload `PENDING` con puntos de datos vacíos, el sistema está diseñado para activar actualizaciones a medida que la información esté disponible. Las entregas posteriores satisfactorias completarán esos campos que antes estaban vacíos, lo que garantiza que tus registros se mantengan sincronizados con la información procesada más reciente.

{% hint style="warning" %}
**Importante:** Si tienes [flujos de trabajo de solicitudes](https://help.impact.com/brand/es/what-would-you-like-to-learn-about/platform-features/review-partner-applications/automate-partner-application-processing.md) configurados, se ejecutan antes de que se active el webhook. El webhook se activa con el resultado *Estado*: `APPROVED` o `REJECTED` si un flujo de trabajo procesó la solicitud, `PENDING` si no se aplicó ningún flujo de trabajo, o `RETRACTED` si el partner retiró la solicitud.
{% endhint %}

Para ver cómo funciona este webhook junto con Recruitment Agent, consulta [Recruitment Agent](https://help.impact.com/brand/es/what-would-you-like-to-learn-about/platform-features/review-partner-applications/recruitment-agent.md#see-where-the-agent-fits-with-your-existing-automation).

El contenido del payload varía según el *estado*. El ejemplo siguiente muestra un evento `PENDING` e incluye comentarios que indican qué campos aparecen con otros estados.

```json
// Un ejemplo de POST en formato JSON
{
  "Status": "PENDING", // Estado de la solicitud: PENDING, APPROVED, REJECTED, RETRACTED
  "ProgramId": "9876", // ID del programa
  "TemplateTermsId": "4455", // ID de los términos de la plantilla
  "ContractId": "112233", // ID del contrato
  "ApplicationDate": "2026-04-09T08:30:00Z", // Fecha de solicitud
  "PublisherSignerName": "Sarah Chen", // Usuario del publisher que procesó la solicitud
  "PublisherId": "555", // ID del socio
  "Name": "Elite Content Creators", // Nombre del socio
  "BusinessModel": "SOCIAL_INFLUENCER", // Modelo de negocio principal del socio
  "Address": "123 Marketing Way", // Dirección
  "City": "Los Angeles", // Ciudad
  "State": "CA", // Estado
  "Country": "US", // País

  // Solo APPROVED, REJECTED, RETRACTED
  "DecisionDate": null, // Fecha de la decisión

  // Solo APPROVED
  "ContractStartDate": null, // Fecha de inicio del contrato

  // Solo REJECTED
  "DeclineReason": null, // Motivo del rechazo

  // Solo APPROVED, REJECTED
  "AdvertiserSignerName": null, // Usuario del anunciante que procesó la solicitud

  // Solo PENDING: campos del perfil del socio
  "Description": "A premium network of lifestyle and travel influencers.", // Descripción del perfil del socio
  "Language": "en-US", // Idioma
  "PublisherSize": "M", // XS, S, M, L, XL
  "PastRelationship": "false", // Booleano que indica si hubo un contrato anterior
  "MarketplaceApproved": "true", // Booleano que indica el estado en el marketplace
  "ReceivedPayout": "true", // Booleano que indica si ha recibido un pago

  // Solo PENDING: propiedades multimedia asociadas al socio
  "properties": [{join(properties, i, "{\"platform\":\"{i.platform}\",\"verified\":\"{i.verified}\",\"url\":\"{i.url}\",\"category\":\"{i.category}\",\"reach\":\"{i.reach}\",\"engagementRate\":\"{i.engagementRate}\",\"audienceCountryPct\":\"{i.audienceCountryPct}\",\"audienceGenderPct\":\"{i.audienceGenderPct}\",\"audienceAgeRangePct\":\"{i.audienceAgeRangePct}\"}")}],

  // Solo PENDING: datos demográficos del creador
  "CreatorIncome": "", // Ingresos del hogar
  "CreatorGender": "", // Género
  "CreatorEthnicity": "", // Grupo étnico
  "CreatorEducation": "", // Nivel educativo
  "CreatorRelationshipStatus": "", // Estado civil
  "CreatorParentalStatus": "", // Situación parental
  "CreatorPronouns": "", // Pronombres
  "CreatorDOB": "", // Fecha de nacimiento

  // Solo PENDING: ID de grupos
  "GroupIds": "1001,1002,1003" // ID de grupos separados por comas
}
```

</details>

## Mecanismo de reintento de postbacks

Si falla un postback al intentar enviarlo a la URL de destino, la entrega se reintenta automáticamente según un calendario establecido, hasta 15 veces. Los reintentos permiten gestionar problemas temporales de red o la falta de disponibilidad del servidor.

### Casos en los que no se realizarán reintentos

No se volverá a intentar enviar un postback en los siguientes casos:

* La URL de destino está mal formada o no es válida.
* La URL de destino o su host no se resuelve, por ejemplo, debido a un error de búsqueda de DNS.

### Calendario de reintentos

Los intentos de reenvío siguen el calendario que se indica a continuación. Se omiten los reintentos 1, 2 y 3 si el código de respuesta HTTP está dentro del rango de `400` a `500`.

<details>

<summary>Referencia del calendario de reintentos</summary>

<table><thead><tr><th width="180.5390625">Intento de reintento</th><th>Demora antes del reintento</th></tr></thead><tbody><tr><td>Reintento 1</td><td>+15 segundos</td></tr><tr><td>Reintento 2</td><td>+15 segundos</td></tr><tr><td>Reintento 3</td><td>+15 segundos</td></tr><tr><td>Reintento 4</td><td>+3 minutos</td></tr><tr><td>Reintento 5</td><td>+3 minutos</td></tr><tr><td>Reintento 6</td><td>+15 minutos</td></tr><tr><td>Reintento 7</td><td>+15 minutos</td></tr><tr><td>Reintento 8</td><td>+15 minutos</td></tr><tr><td>Reintento 9</td><td>+2 horas</td></tr><tr><td>Reintento 10</td><td>+2 horas</td></tr><tr><td>Reintento 11</td><td>+2 horas</td></tr><tr><td>Reintento 12</td><td>+6 horas</td></tr><tr><td>Reintento 13</td><td>+6 horas</td></tr><tr><td>Reintento 14</td><td>+6 horas</td></tr><tr><td>Reintento 15</td><td>+6 horas</td></tr></tbody></table>

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.impact.com/brand/es/what-would-you-like-to-learn-about/account-administration/account-settings/notifications/enable-event-notification-postbacks-for-brands.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
