Isaac Aracena
50 lines
2.4 KiB
Markdown
50 lines
2.4 KiB
Markdown
# 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.
|
|
|
|
## 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.*
|