Webhooks

Abre la pagina de Configuracion de tu grupo y haz clic en la pestana Webhooks. Aqui es donde gestionas todas las configuraciones de webhook de tu grupo.

Haz clic en "Crear Webhook", ingresa un nombre descriptivo, tu URL de destino y selecciona los eventos a los que quieres suscribirte de los 21 tipos de eventos disponibles.

Los webhooks soportan 21 tipos de eventos en 7 categorias. Suscribete solo a los eventos que tu integracion necesita.

Cada entrega de webhook incluye una firma HMAC-SHA256 para que puedas verificar que el payload proviene de Balla Stats. Los siguientes encabezados se incluyen con cada entrega:

Aqui hay un ejemplo en Node.js para verificar la firma:

const crypto = require('crypto');

function verifySignature(payload, signature, secret) {
  const expected = crypto
    .createHmac('sha256', secret)
    .update(payload)
    .digest('hex');
  return crypto.timingSafeEqual(
    Buffer.from(signature.replace('sha256=', '')),
    Buffer.from(expected)
  );
}

Haz clic en el boton "Probar" para enviar un evento de prueba a tu endpoint. Ve el resultado de la entrega para confirmar que tu endpoint esta recibiendo y procesando correctamente.

Ve el historial completo de entregas para cada webhook. Cada entrada del registro muestra el estado de entrega (DELIVERED, FAILED, RETRYING), codigo de estado HTTP, tiempo de respuesta y cualquier mensaje de error.

Las entregas fallidas se reintentan automaticamente con retroceso exponencial. La configuracion predeterminada es 3 reintentos con retrasos crecientes:

Despues de 10 fallos consecutivos, el webhook se desactiva automaticamente para prevenir desperdicio de recursos. Puedes reactivarlo manualmente despues de solucionar el problema con tu endpoint.

Si tu secreto de webhook se ve comprometido, regeneralo inmediatamente. Actualiza tu endpoint receptor con el nuevo secreto antes de la proxima entrega para asegurar que la verificacion de firma continue funcionando.