> 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 administrar suscripciones de webhooks de Advocate

Los webhooks son código que se ejecuta cuando ocurre un evento. Advocate 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. En este artículo de ayuda se explica cómo administrar webhooks desde la plataforma de Advocate.

#### Crear una suscripción a un webhook

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 columna izquierda, debajo de *Configuración de Advocate*, selecciona **Webhooks**.
3. En la página *Suscripciones a webhooks* , selecciona **Crear suscripción**.
4. Debajo de *Enviar a la URL*, introduce la dirección única que usa la aplicación 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 al webhook.
6. Selecciona **Guardar**.

#### Solucionar problemas con los registros de webhooks

Cuando registras una URL a la que Advocate envía solicitudes cada vez que ocurre un evento en tu programa, puedes revisar los registros y solucionar los problemas de los eventos de webhook que fallen.

**Acceder a los registros de webhooks**

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 columna izquierda, debajo de *Configuración de Advocate*, selecciona **Webhooks**.
3. En la página *Suscripciones a webhooks* , selecciona **Ver registros**.
4. Usa los filtros de la sección *Registro de eventos de webhooks* para filtrar los webhooks.
   * Consulta la *Referencia de filtros* a continuación para obtener más información.

<details>

<summary>Referencia del filtro</summary>

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

</details>

**Ver los detalles del webhook**

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

<details>

<summary>Referencia de eventos</summary>

| Filtro                     | Descripción                                                                                                                                                                                                                                                                                                                                                      |
| -------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Tipo                       | El webhook [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           | La carga útil del [webhook](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 del endpoint de suscripción del webhook. Estos detalles pueden incluir el intento de entrega del webhook, con la marca de tiempo del intento, el código de estado HTTP recibido del destino y si el intento agotó el tiempo de espera porque la solicitud tardó demasiado en recibir una respuesta del servidor de destino. |

</details>

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

* Los webhooks 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.
* Se volverá a intentar entregar los eventos fallidos cada hora después del intento fallido anterior, hasta que la entrega se realice correctamente o se hayan realizado 72 intentos (aproximadamente 3 días, a razón de 1 reintento por hora).
* Los endpoints de webhook que devuelvan errores de forma sistemática se desactivará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 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/advocate-program/advocate-program-settings/create-and-manage-advocate-webhook-subscriptions.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.
