Cuando un cliente habitual vuelve, tu programa de fidelización es el primero en saberlo: el escaneo en el mostrador registra la visita y el pase en su Apple Wallet o Google Wallet se actualiza. Los webhooks hacen que tus propios sistemas lo sepan también, en el mismo segundo. Tu CRM, tu contabilidad, la pantalla de la trastienda: cada uno se entera de la visita, de la recompensa y del pago con tarjeta regalo sin que nadie copie una cifra a mano.
Un escaneo en el mostrador suma un sello o puntos, y la tarjeta se actualiza en el teléfono del cliente.
¿Qué es un webhook de un programa de fidelización?
Un webhook es un mensaje corto que Fideliya envía a una dirección de tu propio servidor en cuanto pasa algo en tu programa. Tu desarrollador añade la dirección en tu panel de Fideliya y elige los eventos que debe recibir. A partir de ahí, cada vez que ocurre uno de esos eventos, Fideliya lo envía allí en JSON: qué pasó, cuándo, en qué negocio y los detalles que lo acompañan.
Para tus clientes no cambia nada. Se unen escaneando el código QR del mostrador y dando un nombre y un email, y el pase llega a Apple Wallet o Google Wallet, sin app que descargar ni cuenta o contraseña que crear. Los webhooks circulan entre Fideliya y tus sistemas.
Todos los eventos que envía Fideliya
Estos son los diez eventos, con los nombres exactos a los que se suscribe tu desarrollador.
| Evento | Cuándo se envía | Qué te cuenta |
|---|---|---|
customer.created | Un cliente se unió a uno de tus pases | Quién: su nombre, su email, su teléfono si lo dio, qué pase y a qué wallet fue |
scan.recorded | Se escaneó un pase en el mostrador: una visita, puntos, una recompensa canjeada o reclamada | Qué cliente, qué hizo el mostrador, el nuevo total, las recompensas listas, el mostrador donde ocurrió y el importe tecleado con un escaneo de puntos |
scan.voided | Se anuló un escaneo en el mostrador a los pocos segundos, porque fue un error | Qué se anuló (una visita, una recompensa entregada, una recompensa de puntos reclamada o un pago con tarjeta regalo) y el total o el saldo después de anularlo |
milestone.reached | Un cliente alcanzó una recompensa | Quién, el nombre de la recompensa y cuántas recompensas ha alcanzado en total en ese pase |
referral.completed | Un amigo referido hizo su primera visita, así que ambos ganaron su bonificación | Quién trajo a quién y la bonificación que ganó cada uno |
gift_card.sent | Se aceptó para entrega el email de una tarjeta regalo, al emitirla o al reenviarla | El destinatario, el importe, el saldo, la moneda y si fue un reenvío |
gift_card.spent | Se cobró un pago de una tarjeta regalo, en el mostrador o a través de la API | El importe cobrado, el saldo restante, el mostrador, la referencia de tu caja cuando la dio y si lo cobró el escáner o tu sistema |
pass.created | Se creó un nuevo diseño de pase | El pase, su estilo, sellos (visitas) o puntos, y la meta para una recompensa |
subscription.created | Empezó tu suscripción a Fideliya | El plan, su estado, el periodo en curso y si es una prueba |
subscription.cancelled | Se canceló tu suscripción a Fideliya | Cuándo se canceló |
Los dos eventos de suscripción son de la cuenta: los recibe cada dirección de tu cuenta, sea cual sea el negocio al que pertenece.
Dos más que verá tu desarrollador
webhook.test es lo que envía el botón de evento de prueba de tu panel: nunca viene de una acción real, así que tu desarrollador puede comprobar la conexión sin un cliente en el mostrador. webhook.ping es una comprobación que Fideliya envía a una dirección que tuvo que poner en pausa; a tu servidor le basta con responder con un éxito.
Cuatro cosas que construir con los webhooks y tus propios sistemas
Ninguna necesita nada más que los webhooks de Fideliya y los sistemas que ya usas.
- Un agradecimiento desde tu propio CRM cuando un habitual alcanza una recompensa. Guarda cada
customer.createden tu CRM con su identificador de cliente. Cuando llegamilestone.reachedcon el mismo identificador y el nombre de la recompensa, tu CRM envía el agradecimiento que escribiste, desde tu propia dirección. El mensaje y el momento son tuyos. - Ventas con tarjeta regalo que se cuadran solas. Cada
gift_card.spentlleva el importe, el saldo restante, el mostrador y, cuando tu caja cobró el pago a través de la API, su propio número de ticket. Crúzalo con los tickets del día y la línea de tarjetas regalo de tu contabilidad cuadra sin contar a mano. Un pago anulado en caja llega después comoscan.voided, así que la anulación queda en el mismo registro. - Una pantalla de escaneos por local.
scan.recordedindica el mostrador de cada escaneo. Cuéntalos por local a lo largo del día y tendrás un tablero en directo de cómo va cada tienda, conscan.voideddescontando los errores. - Una lista de agradecimientos para tu equipo.
referral.completedindica qué cliente trajo a un amigo. Una lista en tu propio sistema le dice a tu equipo a quién dar las gracias en persona en su próxima visita.
Cómo se comportan los envíos
Cada envío va firmado con el secreto de tu dirección, en el formato Standard Webhooks, para que tu sistema compruebe que viene de Fideliya antes de fiarse. Cada evento lleva un identificador que no cambia entre intentos: guárdalo y nunca contarás dos veces la misma visita.
Si tu servidor está caído o responde con un error, Fideliya lo intenta de nuevo, espaciando los intentos durante cerca de un día. Una dirección que falla durante días queda en pausa. Fideliya la comprueba entonces con webhook.ping y, tras dos respuestas correctas seguidas, la reactiva y le envía lo que se perdió.
Qué plan, y por dónde empieza tu desarrollador
Los webhooks vienen con el plan Enterprise, desde 99,99 € al mes o 79,99 € al mes en pago anual, junto con la API de Fideliya, clientes y establecimientos ilimitados y 10 puestos de equipo. La referencia completa, con cada campo de cada evento, un ejemplo de cada uno y su JSON Schema, está en la documentación de los webhooks.
Si tu caja también tiene que escribir en tu programa, registrar visitas y cobrar pagos con tarjeta regalo, eso es la API: lo que cambia para un negocio está en lo que una API pública cambia en un programa de fidelización pequeño, y la versión corta en conectar Fideliya a tu caja. Cada plan y cada precio están en la página de precios.