# Crear y gestionar suscripciones de webhook para Advocate

Los webhooks son código que se ejecuta cuando ocurre un evento. Advocate le permite usar webhooks para registrar una URL a la que HAREMOS POST cada vez que ocurra un evento en su 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/impact-brand/docs/api-webhooks) o en la plataforma Advocate. Este artículo de ayuda explicará cómo administrar webhooks a través de la plataforma Advocate.

#### Crear una suscripción de webhook

1. En la barra de navegación superior, seleccione ![](https://3147719151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-1183576591b45997efe4dc81a25024640591d02a%2F245137dc972a7a7f6165b59538fcdbac8fd5bd8fee4ba9f20c1a2982c5b58b57.svg?alt=media) **\[Perfil de usuario] → Configuración**.&#x20;
2. En la columna izquierda a continuación *Configuración de Advocate*, selecciona **Webhooks**.
3. En el *Suscripciones de Webhook* página, seleccione **Crear suscripción**.
4. A continuación *Publicar en URL*, ingrese la dirección única que la aplicación utiliza para enviar actualizaciones en tiempo real sobre eventos específicos.
5. Opcionalmente, debajo de *Nombre del Webhook*, ingrese el nombre de la nueva suscripción de webhook.
6. Selecciona **Guardar**.

#### Solucionar problemas de los registros de webhook

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

**Acceda a sus registros de webhook**

1. En la barra de navegación superior, seleccione ![](https://3147719151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-1183576591b45997efe4dc81a25024640591d02a%2F245137dc972a7a7f6165b59538fcdbac8fd5bd8fee4ba9f20c1a2982c5b58b57.svg?alt=media) **\[Perfil de usuario] → Configuración**.&#x20;
2. En la columna izquierda a continuación *Configuración de Advocate*, selecciona **Webhooks**.
3. En el *Suscripciones de Webhook* página, seleccione **Ver registros**.
4. Use los filtros a continuación *Registro de eventos de Webhooks* para filtrar los webhooks.
   * Consulte la *Referencia de filtros* a continuación para más información.

<details>

<summary>Referencia de filtros</summary>

| Filtro  | Descripción                                                                                                                                                                   |
| ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Tipo    | Filtrar por el webhook [tipo de evento](https://integrations.impact.com/impact-brand/docs/api-webhooks#section-webhook-events). Este filtro por defecto es *Todos los tipos*. |
| Período | Filtrar por el período en el que el webhook se actualizó por última vez. Este filtro por defecto es *Todo el tiempo*.                                                         |

</details>

**Ver detalles del webhook**

1. Seleccione un webhook específico para abrir la *Detalles del Webhook* vista.
2. Esta vista proporciona información que puede usarse para solucionar problemas de una suscripción de webhook.
   * Consulte la *Referencia del evento* a continuación para más información.

<details>

<summary>Referencia del evento</summary>

| Filtro                     | Descripción                                                                                                                                                                                                                                                                                                                                                             |
| -------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Tipo                       | El webhook [tipo de evento](https://integrations.impact.com/impact-brand/docs/api-webhooks#section-webhook-events).                                                                                                                                                                                                                                                     |
| ID del Webhook             | El identificador único del webhook.                                                                                                                                                                                                                                                                                                                                     |
| Fecha de creación          | La fecha en la que se creó el webhook.                                                                                                                                                                                                                                                                                                                                  |
| Datos del evento           | El webhook [carga útil](https://integrations.impact.com/impact-brand/docs/api-webhooks#section-payloads).                                                                                                                                                                                                                                                               |
| 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 de 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 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 webhooks REST se entregan inmediatamente después de que se desencadena 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 reintentarán cada hora después del intento fallido anterior hasta que se realice una entrega exitosa o hasta que se hayan efectuado 72 intentos (aproximadamente 3 días a la tasa de 1 reintento por hora).
* Los endpoints de webhook que devuelvan errores de forma consistente 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              |
