# Enterate en el momento de lo que pasa en tu programa.

> Fuente: https://bonuxo.com/integraciones/webhooks
> Recibí un aviso en tu sistema cada vez que pasa algo en Bonuxo, firmado con HMAC para verificar que el envío es genuino. Guía oficial Bonuxo.

Bonuxo le avisa a tu propio sistema, en tiempo real, cada vez que pasa algo en tu programa de fidelización. Cada envío está firmado con HMAC, para que puedas verificar que es genuino.

Tu programa

Pasa algo

Ocurre un evento en tu programa de fidelización.

Bonuxo

Envía un POST

A la URL que configuraste, firmado con HMAC.

Tu sistema

Recibe y decide

Verifica la firma con tu clave secreta y hace lo que quiera con el aviso.

## Qué resuelve

Si tu negocio ya tiene un sistema propio (una web, un CRM, una planilla conectada a algo más), los webhooks te evitan tener que consultar constantemente a Bonuxo para saber si algo cambió. En vez de eso, Bonuxo te avisa apenas pasa: tu sistema recibe la novedad al instante y decide qué hacer con ella.

## Cómo funciona

Configurás una URL de tu sistema desde el panel de Bonuxo. Cuando ocurre un evento del programa, Bonuxo envía un `POST` con la información del evento a esa URL, firmado con **HMAC**: tu sistema puede recalcular la firma con la clave secreta que definiste y confirmar que el envío realmente vino de Bonuxo, sin que nadie lo haya falsificado.

**Es sólo salida.** Bonuxo le avisa a tu sistema — no lee ni modifica nada dentro de él. Vos decidís qué hacer con cada aviso que recibís.

## Cómo se activa, paso a paso

1.  01
    
    ### Entrá al panel
    
    Configuración → Integraciones → Webhooks, en tu panel de Bonuxo.
    
2.  02
    
    ### Dá de alta el webhook
    
    Pegá la URL de tu sistema donde querés recibir los avisos.
    
3.  03
    
    ### Guardá el secreto
    
    Bonuxo te muestra una clave secreta una única vez: guardala para verificar la firma HMAC de cada envío.
    
4.  04
    
    ### Revisá el historial de envíos
    
    Cuando ocurra el primer evento, el historial de envíos de cada webhook te muestra si tu sistema lo recibió, cuántos intentos hubo y el último error, si lo hubo.
    

## Plan

Los webhooks forman parte de las **Integraciones**, disponibles en los planes **Plus** y **Enterprise**.

## Preguntas frecuentes

¿Qué eventos puedo recibir?+

Seis eventos del programa: cliente registrado (customer.registered), puntos sumados (points.earned), premio canjeado (reward.redeemed), cupón canjeado (coupon.redeemed), campaña enviada (campaign.sent) y desafío completado (challenge.completed). Al dar de alta el webhook elegís cuáles querés recibir.

¿Cómo sé que el aviso realmente viene de Bonuxo?+

Cada envío se firma con HMAC usando una clave secreta que solo vos y Bonuxo conocen. Tu sistema calcula la firma del cuerpo recibido y la compara con la que llega en el header: si no coincide, el envío no es genuino.

¿Qué pasa si mi sistema no responde?+

Bonuxo reintenta el envío automáticamente, con una espera cada vez mayor entre intentos, y cada intento queda en el historial de envíos del panel. Como con cualquier integración por webhook, conviene que tu endpoint responda rápido y procese el aviso de forma asíncrona si hace falta.

¿Necesito saber programar para usar esto?+

Sí, del lado de tu sistema necesitás un desarrollador que reciba el POST y verifique la firma. Del lado de Bonuxo, dar de alta la URL es un paso simple desde el panel.

Conectá tus webhooks desde el panel.

14 días gratis, sin tarjeta de crédito.

[Probar 14 días gratis →](https://app.bonuxo.com/signup?cta=integration-cta&from=%2Fintegraciones%2Fwebhooks)