> 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/advocate-program/advocate-program-settings/create-and-manage-advocate-webhook-subscriptions.md).

# Crear y gestionar suscripciones de webhook de Advocate

Los webhooks son código que se ejecuta cuando ocurre un evento. Advocate te permite usar webhooks para registrar una URL a la que enviaremos una solicitud POST cada vez que ocurra un evento en tu programa; por ejemplo, cuando se crea un código de cupón personalizado para un nuevo participante, se crea un objeto de evento. Hay dos métodos para crear y administrar webhooks: [a través de la API de Advocate](https://integrations.impact.com/integration-guides/for-brands/advocate/advocate-api/api-webhooks-for-advocate-programs) o en la plataforma de Advocate. Este artículo de ayuda explicará cómo administrar webhooks a través de la plataforma de Advocate.

#### Crear una suscripción de webhook

1. En la barra de navegación superior, selecciona ![](/files/260bf6f1048424a5a74566f411803be9ef7c2685) **\[Perfil de usuario] → Configuración**.
2. En la columna izquierda, debajo de *Configuración de Advocate*, selecciona **Webhooks**.
3. En la *Suscripciones de webhook* página, selecciona **Crear suscripción**.
4. Debajo de *Publicar en la URL*, introduce la dirección única que la aplicación usa para enviar actualizaciones en tiempo real sobre eventos específicos.
5. Opcionalmente, debajo de *Nombre del webhook*, introduce el nombre de la nueva suscripción de webhook.
6. Seleccione **Guardar**.

#### Solucionar problemas en los registros de webhook

Cuando registras una URL a la que Advocate publica cada vez que ocurre un evento en tu programa, puedes revisar los registros y solucionar cualquier evento de webhook que falle.

**Accede a los registros de tu webhook**

1. En la barra de navegación superior, selecciona ![](/files/260bf6f1048424a5a74566f411803be9ef7c2685) **\[Perfil de usuario] → Configuración**.
2. En la columna izquierda, debajo de *Configuración de Advocate*, selecciona **Webhooks**.
3. En la *Suscripciones de webhook* página, selecciona **Ver registros**.
4. Usa los filtros de abajo *Registro de eventos de webhooks* para filtrar los webhooks.
   * Consulta la *referencia de filtros* de abajo para obtener más información.

<details>

<summary>referencia de filtros</summary>

| Filtro  | Descripción                                                                                                                                                                                                             |
| ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Tipo    | Filtrar por el [tipo de evento](https://integrations.impact.com/integration-guides/for-brands/advocate/advocate-api/api-webhooks-for-advocate-programs). Este filtro tiene como valor predeterminado *Todos los tipos*. |
| Período | Filtrar por el período en el que el webhook se actualizó por última vez. Este filtro tiene como valor predeterminado *Todo el tiempo*.                                                                                  |

</details>

**Ver detalles del webhook**

1. Selecciona un webhook específico para abrir la vista de *Detalles del webhook* .
2. Esta vista proporciona información que puede utilizarse para solucionar problemas de una suscripción de webhook.
   * Consulta la *Referencia del evento* de abajo para obtener más información.

<details>

<summary>Referencia del evento</summary>

| Filtro                     | Descripción                                                                                                                                                                                                                                                                                                                                                                        |
| -------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Tipo                       | El [tipo de evento](https://integrations.impact.com/integration-guides/for-brands/advocate/advocate-api/api-webhooks-for-advocate-programs).                                                                                                                                                                                                                                       |
| ID del webhook             | El identificador único del webhook.                                                                                                                                                                                                                                                                                                                                                |
| Fecha de creación          | La fecha en que se creó el webhook.                                                                                                                                                                                                                                                                                                                                                |
| Datos del evento           | El [carga útil](https://integrations.impact.com/integration-guides/for-brands/advocate/advocate-api/api-webhooks-for-advocate-programs).                                                                                                                                                                                                                                           |
| Suscripción(es)            | Suscripciones de webhook a las que se envió el webhook y su estado.                                                                                                                                                                                                                                                                                                                |
| Detalles de la suscripción | Detalles sobre la respuesta recibida desde el endpoint de la suscripción del webhook. Los detalles pueden incluir el intento de entrega del webhook, mostrando la marca de tiempo del intento, el código de estado HTTP recibido del destino y si el intento agotó el tiempo de espera debido a que la solicitud tardó demasiado en recibir una respuesta del servidor de destino. |

</details>

**Sistema de reintentos de webhook para entregas de eventos fallidas**

* Los hooks REST se entregan inmediatamente después de que se activa un evento. Si el endpoint no responde correctamente a un intento de entrega (es decir, responde con un código de estado distinto de 200), la entrega se considerará fallida.
* Las entregas fallidas se volverán a intentar cada hora después del intento fallido anterior hasta que se realice una entrega correcta o hasta que se hayan hecho 72 intentos (aproximadamente 3 días a una tasa de 1 reintento por hora).
* Los endpoints de webhook que devuelven errores de forma constante se deshabilitarán automáticamente después del siguiente número de errores:

  | Código de estado | Errores recibidos |
  | ---------------- | ----------------- |
  | Errores 4xx      | 1000              |
  | Errores 5xx      | 2000              |
  | Errores 3xx      | 2000              |


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.impact.com/brand/es/what-would-you-like-to-learn-about/advocate-program/advocate-program-settings/create-and-manage-advocate-webhook-subscriptions.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
