Integración con

Webhook

¿Qué son los Webhooks de Yalt?

Los webhooks de Yalt proporcionan notificaciones push en tiempo real cuando ocurren eventos específicos de fidelización en tu programa. En lugar de hacer polling continuamente a la API para verificar cambios, tu aplicación recibe automáticamente solicitudes HTTP POST en endpoints configurados cuando suceden eventos relevantes—nuevos registros de clientes, transacciones completadas, recompensas canjeadas, niveles VIP alcanzados, campañas activadas y más. Esta arquitectura basada en eventos permite construir integraciones altamente reactivas que responden instantáneamente a actividad de fidelización sin latencia de polling, uso innecesario de API o complejidad de código.

¿Por qué usar Webhooks?

Los webhooks son esenciales para construir integraciones modernas que requieren sincronización de datos en tiempo real o automatización inmediata basada en eventos de fidelización. Usa webhooks cuando necesites actualizar sistemas externos instantáneamente cuando cambian datos de fidelización, activar flujos de trabajo automatizados inmediatamente cuando los clientes alcanzan hitos, sincronizar estados de recompensa en múltiples plataformas sin demora, o construir experiencias en tiempo real que responden a actividad de fidelización en segundos en lugar de minutos. Los webhooks reducen significativamente carga de servidores eliminando polling, mejoran escalabilidad con arquitectura basada en eventos y habilitan patrones de integración reactivos que eran imposibles o imprácticos con solo llamadas API.

Cómo funcionan los Webhooks

Configuras endpoints de webhook en tu dashboard de Yalt especificando URLs donde quieres recibir notificaciones y qué tipos de eventos quieres monitorear. Cuando ocurren esos eventos en tu programa de fidelización, Yalt envía inmediatamente solicitudes HTTP POST a tus endpoints configurados conteniendo payloads JSON detallados con información completa del evento. Tu aplicación procesa estos webhooks—actualiza bases de datos, activa flujos de trabajo, envía notificaciones, sincroniza con otros sistemas—luego responde con códigos de estado HTTP 2xx para reconocer recepción exitosa. Si tu endpoint no está disponible o responde con errores, Yalt automáticamente reintenta la entrega con retroceso exponencial asegurando que eventos críticos no se pierdan debido a problemas temporales de red o tiempo de inactividad del servidor.

Tipos de eventos de webhook disponibles

Eventos de cliente: Notificaciones cuando se crean nuevos clientes, se actualizan perfiles existentes, clientes alcanzan nuevos niveles VIP o ocurren cambios de estado de cuenta.

Eventos de transacción: Notificaciones en tiempo real cuando las transacciones se procesan, puntos se acreditan, cashback se calcula o sellos se agregan a tarjetas.

Eventos de recompensa: Alertas cuando los clientes canjean recompensas, puntos expiran, se alcanzan umbrales de saldo o se emiten puntos bonus.

Eventos de campaña: Notificaciones cuando se activan campañas automatizadas, se envían mensajes, los clientes responden a promociones o se completan secuencias de campaña.

Eventos de nivel: Alertas cuando los clientes suben niveles VIP, bajan niveles, se desbloquean beneficios de nivel o se aplican ventajas específicas de nivel.

Eventos de tarjeta de sellos: Notificaciones cuando se agregan sellos, se completan tarjetas, se alcanzan hitos o se emiten recompensas basadas en sellos.

Eventos de referidos: Alertas cuando se crean códigos de referidos, referencias se convierten exitosamente, se atribuyen recompensas o se alcanzan hitos del programa de referidos.

Eventos de programa: Notificaciones sobre cambios en reglas de programa de fidelización, actualizaciones de configuración o eventos administrativos que pueden afectar integraciones.

Funcionalidades completas de webhook

Suscripción de eventos flexible: Suscríbete selectivamente solo a tipos de eventos relevantes para tu integración, reduciendo ruido y minimizando procesamiento innecesario.

Múltiples endpoints: Configura múltiples endpoints de webhook para diferentes propósitos—un endpoint para sincronización de datos, otro para activación de flujos de trabajo, tercero para logging de auditoría.

Filtrado de eventos: Aplica filtros a suscripciones de webhook para recibir solo eventos que coincidan con criterios específicos—ciertos niveles de cliente, rangos de valores de transacción, ubicaciones específicas o metadatos personalizados.

Entrega confiable con reintentos: El sistema de entrega automáticamente reintenta webhooks fallidos con retroceso exponencial asegurando que eventos críticos no se pierdan debido a problemas temporales.

Verificación de firmas: Cada solicitud de webhook incluye firmas criptográficas que te permiten verificar que solicitudes provienen genuinamente de Yalt, previniendo ataques de spoofing o manipulación.

Logs detallados de entrega: Visualiza historial completo de entregas de webhook, códigos de respuesta, tiempos de intento y detalles de payloads para debugging y monitoreo.

Modo de prueba: Envía webhooks de prueba a tus endpoints con datos de ejemplo para verificar configuración y probar código de manejo antes de ir a producción.

Configuración por entorno: Mantén configuraciones de webhook separadas para entornos de desarrollo, staging y producción asegurando que datos de prueba no activen flujos de trabajo de producción.

Ordenamiento de eventos: Los webhooks incluyen timestamps e IDs de secuencia permitiendo manejar apropiadamente eventos que pueden llegar fuera de orden durante congestión de red.

Transformación de payload: Configura cómo datos de evento formatean en payloads de webhook, permitiendo personalizar estructuras JSON para coincidir con requisitos de tu sistema.

Limitación de tasa y lotes: Configura cómo eventos de alto volumen se entregan—individuales para baja latencia o por lotes para alto rendimiento.

Patrones de integración basados en webhooks

Sincronización de datos en tiempo real: Mantén sistemas externos actualizados instantáneamente cuando cambian datos de fidelización—sincroniza perfiles de clientes con CRM, actualiza dashboards en tiempo real, propaga estados de recompensa en múltiples plataformas.

Automatización de flujos de trabajo: Activa flujos de trabajo empresariales complejos basados en eventos de fidelización—envía notificaciones de fulfillment cuando se canjean recompensas, actualiza privilegios de cuenta cuando los clientes alcanzan nuevos niveles, activa cumplimiento cuando se ganan cupones.

Personalización en tiempo real: Actualiza experiencias de usuario inmediatamente basadas en actividad de fidelización—muestra notificaciones en app cuando se ganan recompensas, actualiza contenido web basado en nivel VIP, personaliza comunicaciones basadas en comportamiento de transacción.

Logging de auditoría: Registra todas las actividades del programa de fidelización en sistemas de auditoría externos para compliance, análisis histórico o investigación de seguridad.

Agregación y analytics de eventos: Transmite eventos de fidelización a plataformas de analytics, almacenes de datos o servicios de BI para reporting sofisticado y modelado predictivo.

Integraciones multi-sistema: Orquesta flujos de datos complejos donde eventos de fidelización activan acciones en múltiples sistemas empresariales—CRM, marketing automation, finanzas, inventario, atención al cliente.

Notificaciones de clientes: Envía notificaciones inmediatas en tiempo real a clientes vía push móvil, SMS o email cuando ocurren eventos de fidelización relevantes—recompensas ganadas, niveles alcanzados, puntos próximos a expirar.

Mejores prácticas de webhook

• Responde rápidamente a webhooks con 2xx status—procesa payloads asíncronamente si requieren trabajo pesado
• Implementa idempotencia—maneja el mismo evento entregado múltiples veces sin efectos secundarios duplicados
• Verifica firmas de webhook para asegurar que solicitudes provienen genuinamente de Yalt
• Implementa manejo robusto de errores que gestiona apropiadamente errores de red, timeouts y datos inesperados de payload
• Usa encolamiento apropiado para manejar explosiones de alto volumen de webhooks sin perder eventos
• Registra información completa de webhook para debugging y auditoría pero sanitiza datos sensibles
• Monitoriza tasas de éxito de entrega de webhook y alerta sobre patrones de fallo
• Prueba manejo de webhook exhaustivamente incluyendo casos extremos y condiciones de error
• Usa firewalls de aplicación web o limitación de tasa para proteger endpoints de webhook de abuso
• Mantén endpoints de webhook separados por entorno para evitar que webhooks de prueba activen acciones de producción

Configuración y primeros pasos

Configurar webhooks toma solo 5-10 minutos. Desde tu dashboard de desarrolladores Yalt, crea una nueva configuración de webhook especificando tu URL de endpoint y seleccionando tipos de eventos para monitorear. Usa el generador de eventos de prueba para enviar webhooks de ejemplo a tu endpoint y verificar que tu código de manejo funciona correctamente. Implementa verificación de firmas para asegurar que solicitudes provienen genuinamente de Yalt. Despliega a producción y monitorea logs de entrega para asegurar entrega exitosa. El sistema maneja automáticamente reintentos si tu endpoint está temporalmente no disponible. La documentación completa incluye ejemplos de código para frameworks populares, descripción de esquemas de payload y guía de resolución de problemas.