Crear y gestionar suscripciones de webhooks 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 haremos una solicitud POST cada vez que ocurra un evento en tu programa; por ejemplo, cuando se crea un código de cupón vanity 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 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, seleccione [Perfil de usuario] → Configuración.

2. En la columna izquierda debajo de Configuración de Advocate, selecciona Webhooks.

3. En la Suscripciones de webhooks de la página, selecciona Crear suscripción.

4. Debajo Publicar en URL, ingresa 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, ingresa el nombre de la nueva suscripción de webhook.

6. Selecciona Guardar.

Resolver problemas en los registros de webhooks

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

Acceder a tus registros de webhooks

1. En la barra de navegación superior, seleccione [Perfil de usuario] → Configuración.

2. En la columna izquierda debajo de Configuración de Advocate, selecciona Webhooks.

3. En la Suscripciones de webhooks de la página, selecciona Ver registros.

4. Usa los filtros a continuación Registro de eventos de webhooks para filtrar los webhooks.

   • Consulta la referencia del filtro a continuación para obtener más información.

referencia del filtro

Filtro	Descripción
Tipo	Filtrar por el webhook tipo de evento. 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.

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 usarse para solucionar problemas de una suscripción de webhook.

   • Consulta la Referencia del evento a continuación para obtener más información.

Referencia del evento

Filtro	Descripción
Tipo	El webhook tipo de evento.
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.
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 de espera porque la solicitud tardó demasiado en recibir una respuesta del servidor de destino.

Sistema de reintento de webhooks para entregas de eventos fallidas

• Los rest hooks 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 reintentarán cada hora después del intento fallido anterior hasta que se realice una entrega exitosa o hasta que se hayan realizado 72 intentos (aproximadamente 3 días a una tasa de 1 reintento por hora).

• Los endpoints de webhook que devuelvan errores de manera 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