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
- 01
Entrá al panel
Configuración → Integraciones → Webhooks, en tu panel de Bonuxo.
- 02
Dá de alta el webhook
Pegá la URL de tu sistema donde querés recibir los avisos.
- 03
Guardá el secreto
Bonuxo te muestra una clave secreta una única vez: guardala para verificar la firma HMAC de cada envío.
- 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.
Siguientes pasos
Después de activar los webhooks
También te puede servir
API POS públicaPlus
Si además querés sumar puntos y canjear desde tu caja, no sólo recibir avisos.
Autenticación, sandbox y buenas prácticas para integrar la caja con Bonuxo.
¿Ya tenés cuenta? Hacelo ahora en Configuración → Integraciones → Webhooks.
Abrir en tu panel: Configuración → Integraciones → Webhooks