# Lealtad Demo n8n Este proyecto es una solución automatizada para la gestión de programas de fidelización (lealtad) utilizando WhatsApp como canal de interacción, n8n como motor de flujos y Supabase como backend escalable. ## Funcionalidades Principales * **Registro Automatizado**: Identifica clientes nuevos y solicita su nombre para personalizar la billetera digital. * **Gamificación**: Actualización automática de niveles (`Member`, `Gold`, `Black`) según el saldo acumulado. * **Consulta de Saldo**: Respuesta instantánea con el saldo actual y nivel de tier al escribir por WhatsApp. * **Digital Wallet Integration**: Entrega enlaces personalizados para pases de Apple Wallet y Google Wallet. ## Arquitectura del Sistema 1. **WhatsApp (Meta API)**: Recibe y envía mensajes. 2. **n8n**: Orquesta la lógica de negocio, procesa los datos y conecta los servicios. 3. **Supabase**: Almacena clientes, empresas, transacciones y ejecuta la lógica de gamificación vía Triggers de SQL. ## Requisitos * Instancia de **n8n** (v1.0+ recomendada). * Proyecto en **Supabase**. * Cuenta de desarrollador en **Meta** con WhatsApp Business API configurado. * Portal de Wallet configurado para generar los pases. ## Guía de Configuración ### 1. Supabase Ejecuta el script situado en `supabase/schema.sql` en tu editor SQL de Supabase. Esto creará la estructura de tablas y las funciones necesarias. ### 2. Importación en n8n 1. Importa el archivo `n8n/plan-de-incentivo.template.json` en un nuevo workflow de n8n. 2. Configura las siguientes credenciales: * **WhatsApp Trigger**: Credenciales OAuth2 o API Token de Meta. * **Supabase Auth**: Configura un nodo de Header Auth con tu `apikey` y `Authorization: Bearer [TOKEN]`. ### 3. Reemplazo de Parámetros Busca y reemplaza los siguientes placeholders en el workflow: * `TU_PROYECTO`: El subdominio de tu instancia de Supabase. * `TU_PHONE_NUMBER_ID`: El ID del número de teléfono en Meta Developer Portal. * `COMPANY_ID_DEMO`: El UUID de la empresa creada en la tabla `companies`. * `TU_PORTAL`: El dominio de tu portal de generación de Wallet.