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

WhatsApp (Meta API): Recibe y envía mensajes.
n8n: Orquesta la lógica de negocio, procesa los datos y conecta los servicios.
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

Importa el archivo n8n/plan-de-incentivo.template.json en un nuevo workflow de n8n.
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.

Seguridad y Privacidad

Caution

Nunca subas credenciales reales, tokens de acceso o datos personales (pinData) al repositorio. Utiliza variables de entorno o el gestor de credenciales de n8n.

Desarrollado como parte de la infraestructura de fidelización digital de Digital Compass Agency.