Centro de Ayuda - Connexa

Guia de uso de Connexa, la plataforma de fidelizacion de clientes de IntegraIA. Usa el indice de la izquierda para ir directo a la seccion que necesites.

Introduccion #

Connexa es una plataforma SaaS multi-tenant que te permite armar un programa de fidelizacion de clientes con puntos, niveles, recompensas y canjes fisicos. Esta pensada para comercios y empresas de servicios: retail, gastronomia, fitness, farmacias, servicios profesionales.

El objetivo de Connexa es simple: que tus clientes vuelvan mas seguido y gasten mas cada vez que vuelven, y que vos tengas las herramientas para medirlo y accionarlo sin depender de canales caros o saturados.

Que es Connexa #

Connexa te da:

• Un programa de puntos configurable por producto, categoria, monto o cantidad.
• Un sistema de niveles (Silver, Gold, Platinum, Diamond o los que elijas) con umbrales ajustables.
• Un catalogo de recompensas que tus clientes canjean con puntos.
• Un canal propio para comunicarte con tus clientes sin costo por mensaje: inbox in-app, web push y email.
• Una PWA instalable para que tus clientes accedan desde el celular como una app nativa.
• Un sistema de invitaciones con embudo trazable para traer a tus clientes a la plataforma.
• Metricas de comportamiento: RFM, retencion, recurrencia, ticket promedio, churn.
• White-label sutil: tu marca domina la experiencia, IntegraIA aparece con discrecion en el footer.

Arquitectura #

Connexa es multi-tenant: cada empresa contratante (tenant) es un espacio aislado con sus clientes, reglas, niveles, recompensas y campanas. El sistema se compone de:

Requisitos #

Para el tenant (vos, el comercio):

• Navegador moderno (Chrome, Edge, Firefox, Safari).
• Conexion a internet estable.
• Un email valido para el usuario propietario de la cuenta.

Para el cliente final:

• Un celular con navegador moderno (Chrome o Safari recientes) para instalar la PWA.
• Email o telefono para recibir la invitacion del tenant.

Alta de empresa #

El alta de empresa (tenant) se hace desde el Portal de Licencias de IntegraIA. Podes contratar Connexa solo o junto con otros productos del ecosistema (Digital One, Domus).

1. Ingresa al Portal de Licencias de IntegraIA.
2. Elegi el producto Connexa y el plan que quieras empezar (Free, Basic, Pro o Enterprise).
3. Completa los datos de tu empresa: razon social, identificacion fiscal (opcional en Free), pais, zona horaria.
4. Creas el usuario propietario (email y password). Este usuario queda con el rol ConnexaOwner.
5. El sistema aprovisiona tu instancia de Connexa y te envia un email de bienvenida con las credenciales y el link al portal.

Primer login #

Ingresa al portal con el email y password que definiste en el alta. La primera vez vas a ver el wizard de configuracion inicial que te guia por los pasos esenciales:

1. Configurar el branding (logo, colores, nombre que ven tus clientes).
2. Crear al menos una sucursal.
3. Definir los niveles del programa (o aceptar los defaults: Silver, Gold, Platinum, Diamond).
4. Crear la primera regla de puntaje (ej: "Por cada $100 de compra, suma 1 punto").
5. Sumar al menos una recompensa al catalogo.

Podes completar el wizard ahora o cerrarlo y volver despues desde el menu Configuracion.

Branding y white-label #

El portal del cliente final y la PWA muestran la marca de tu empresa, no la de IntegraIA. En la seccion Configuracion > Branding podes ajustar:

• Nombre comercial: como ven los clientes a tu marca.
• Logo: imagen PNG o SVG con fondo transparente, idealmente 400x120 px.
• Color primario y acento: se aplican al shell de la PWA y el portal del cliente.
• Tono de comunicacion: texto que se inserta automaticamente en emails y mensajes.
• "Powered by IntegraIA": por default aparece discretamente en el footer y los emails. Si tu plan lo permite, podes ocultarlo.

Sucursales #

Cada tenant puede tener una o varias sucursales. Las sucursales sirven para:

• Atribuir ventas y puntos a un local especifico.
• Validar canjes en el local donde el cliente se acerca.
• Filtrar reportes por sucursal.
• Scope de reglas de puntaje (ej: "solo suma doble en la sucursal Centro").

En Configuracion > Sucursales podes dar de alta cada local con nombre, direccion, telefono y horario.

Categorias y articulos #

Connexa trabaja con un catalogo de articulos agrupados en categorias. No es obligatorio cargar todo tu catalogo: alcanza con definir categorias amplias y los articulos que querras usar en reglas especificas ("Multiplicador x2 en categoria Vinos").

Si tenes un ERP integrado (por ejemplo CODEXWeb), el catalogo puede sincronizarse automaticamente por API.

Niveles y umbrales #

Los niveles son rangos de fidelizacion que se alcanzan acumulando puntos o gasto en una ventana temporal. Los defaults son:

Podes renombrarlos, cambiar colores, ajustar umbrales y definir que beneficios asigna cada nivel (multiplicador de puntos, acceso a recompensas exclusivas, vigencia por periodo).

Gestion de clientes #

Los clientes son las personas que participan de tu programa de fidelizacion. En Connexa, un cliente existe aunque todavia no haya sido invitado al portal: vos podes cargar tu base completa y despues decidir a quienes invitar y en que momento.

Alta manual #

Para cargar un cliente de a uno:

1. Anda a Clientes > Nuevo cliente.
2. Completa nombre, apellido, email (recomendado) y telefono.
3. Opcionalmente, fecha de nacimiento (para promos de cumpleanos), DNI/CUIT, direccion.
4. Guardas. El cliente queda en estado No invitado.

Importar desde Excel #

Si ya tenes una base de clientes en otro sistema, podes importarla en lote:

1. Descarga la plantilla Excel desde Clientes > Importar.
2. Completa la plantilla respetando las columnas: nombre, apellido, email, telefono, fecha de nacimiento, identificacion fiscal.
3. Subi el archivo. El sistema valida y te muestra filas con error para que corrijas.
4. Confirmas la importacion. Los clientes se crean en estado No invitado.

Campos disponibles #

Integracion con tu ERP #

Connexa absorbe datos desde 5 canales distintos. Los tres tipos de informacion (clientes, articulos, transacciones) entran por la misma arquitectura: staging tables que validamos antes de impactar produccion.

Canales disponibles #

Importar desde el portal (CSV / Excel / JSON) #

1. Entra a Importaciones > Nueva.
2. Elegi la entidad (Clientes / Articulos / Transacciones).
3. Vas a ver las columnas esperadas para esa entidad.
4. Suba el archivo (max 20 MB). El sistema lo carga a staging y te dice cuantas filas leyo.
5. Si querés ver que pasaria sin aplicar, activa Modo preview. Si no, deja el toggle off y apreta Procesar y aplicar.
6. Vas a ver el resultado: insertadas, actualizadas, rechazadas (con motivo), duplicadas.

API REST push #

Para que tu ERP envie datos a Connexa en tiempo real:

1. Entra a Integraciones en el menu lateral del portal admin.
2. Apreta Generar API key. Vas a recibir una clave de 48 caracteres.
3. Activa el toggle Habilitar ingreso por API REST y guarda.
4. Pasa la API key a tu equipo de desarrollo. El endpoint es:
   POST https://connexa-portal.azurewebsites.net/api/ingest/{entidad}
5. El header obligatorio es X-Connexa-IngestKey. El body puede ser JSON, CSV o Excel segun el Content-Type.
6. La respuesta es JSON con runId, filasInsertadas, filasActualizadas, filasRechazadas. El procesamiento es sincronico: cuando recibis 200, los datos ya estan vivos.

Ejemplo cURL:

curl -X POST https://connexa-portal.azurewebsites.net/api/ingest/clientes \
  -H "X-Connexa-IngestKey: TU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"nombre":"Juan","email":"juan@empresa.com","telefono":"11-1234-5678"}]'

SQL directo (clientes IT avanzados) #

Si tu equipo de sistemas tiene ETL existentes y prefiere insertar directo a las tablas, te entregamos un usuario SQL dedicado con permisos limitados.

1. Contactanos a soporte@integraia.tech indicando tu Empresa ID (lo ves en Integraciones).
2. Te entregamos credenciales por canal seguro: usuario cnxa_stg_{tu_empresa_id} + password.
3. Tu IT inserta en CNXAStgClientes, CNXAStgArticulos o CNXAStgTransacciones con tu nEmpresaId y un nRunId nuevo de CNXAImportRuns.
4. Marcando lAutoPromote=1 en el run, nuestro motor lo procesa cada 5 minutos automaticamente.

Tu usuario SQL solo puede leer/escribir las tablas staging y los lookups. No tiene acceso a las tablas de produccion ni a datos de otras empresas.

Auditoria y reprocesamiento #

Toda corrida queda en Importaciones con metricas y detalle fila por fila. Las rechazadas tienen motivo legible (Email invalido, Cliente no encontrado, etc).

Las staging procesadas se borran automaticamente despues de 30 dias. Los registros de auditoria se conservan 1 ano.

Como funcionan las invitaciones #

En Connexa, el cliente final no se auto-registra. La unica forma de que acceda al portal o la PWA es a traves de una invitacion que vos le envies. Esto mantiene tu base controlada y evita registros falsos.

Cada invitacion genera un token unico con un link personalizado del tipo connexa.integraia.tech/i/{token}. Al abrirlo, el cliente ve la landing con tu branding y completa una contrasena para activar su cuenta.

Enviar invitaciones #

Podes enviar invitaciones de forma individual o en lote:

• Individual: desde la ficha del cliente, boton Invitar.
• En lote: desde Clientes > Invitar en lote, seleccionas filtros (todos los no invitados, los de cierta sucursal, los del ultimo mes, etc.) y disparas el envio.

La invitacion se envia por el canal que elijas: email, SMS (si tu plan lo permite) o ambos.

Embudo de adopcion #

Cada invitacion queda trazada con los siguientes hitos:

1. Enviada: el sistema disparo el email o SMS.
2. Entregada: el proveedor confirmo la entrega (no aplica a todos los canales).
3. Abierta: el cliente hizo click en el link.
4. Registrada: el cliente completo la contrasena y entro al portal.
5. Activa: el cliente tuvo al menos una sesion en los ultimos 30 dias.
6. PWA instalada: el cliente instalo la PWA en su celular.

En el dashboard vas a ver un embudo con los numeros y porcentajes de conversion entre cada hito.

Plantillas y canales #

Motor de fidelizacion #

El motor de puntos de Connexa se basa en cuatro dimensiones ortogonales que se combinan libremente. Cada regla de puntaje responde a las cuatro preguntas:

Reglas de puntaje #

Desde Configuracion > Reglas de puntaje podes crear, editar y priorizar reglas. Cada regla tiene:

• Nombre y descripcion.
• Disparador (evento que la activa).
• Formula (como se calculan los puntos).
• Scope (productos, categorias, segmentos, sucursales).
• Ventana temporal (o sin ventana).
• Prioridad (cuando varias reglas aplican al mismo evento).
• Fechas de vigencia (desde / hasta).
• Estado (activa / pausada).

Formulas #

Ventanas temporales #

Las ventanas permiten definir acumuladores por periodo. Por ejemplo: "Si en un mes calendario acumulas mas de 1.000 puntos, los siguientes puntos del mes se multiplican por 1.5". El sistema reinicia el acumulador al cerrar la ventana.

Ejemplos practicos #

Comercio general: "Por cada $100 de compra, 1 punto. Si el cliente es Gold, multiplicamos por 1.5."

Cafeteria: "Cada cafe suma 10 puntos. Cada 6 cafes en un mes, el septimo es gratis (recompensa automatica)."

Fitness: "Cada clase asistida suma 20 puntos. Si asiste 12 veces en un mes, bonificamos con 100 puntos extra."

Farmacia: "En categoria Dermocosmetica, multiplicador x2 permanente. En categoria Medicamentos, 1 punto cada $200."

Catalogo de recompensas #

Las recompensas son lo que tus clientes pueden canjear con los puntos que acumulan. Pueden ser productos, descuentos, experiencias o beneficios. En Recompensas > Catalogo podes:

• Dar de alta una recompensa con nombre, descripcion, imagen y costo en puntos.
• Limitar la disponibilidad: cantidad total, fecha desde/hasta, por nivel minimo.
• Marcar una recompensa como destacada para que aparezca primero en la PWA.
• Pausar o retirar recompensas.

Flujo de canje #

1. El cliente elige una recompensa desde su PWA o portal web.
2. Confirma el canje. Los puntos se descuentan de su cuenta.
3. El sistema genera un codigo alfanumerico de 8 caracteres mas un codigo QR.
4. El cliente va al local con el codigo o el QR.
5. El operador del local valida el canje (ver siguiente seccion).
6. La recompensa queda marcada como canjeada.

Validacion en local #

Desde el portal, un usuario con rol ConnexaOperadorCanje ingresa a Canjes > Validar y escanea el QR o pega el codigo que trae el cliente. El sistema confirma si el codigo es valido, de que recompensa se trata y marca el canje como completado.

Rol Operador de Canje #

Este rol permite validar canjes pero no configurar el programa ni ver datos sensibles de clientes. Es el perfil apropiado para el personal de caja o mostrador.

Canales de comunicacion #

Connexa te da varios canales para llegar a tus clientes sin costo por mensaje. La disponibilidad depende del plan.

Inbox in-app #

El inbox es el canal principal: no cuesta por mensaje, llega directo a la PWA del cliente, y queda archivado para que lo consulte cuando quiera. Es el canal ideal para novedades, promos y comunicaciones no urgentes.

Notificaciones push #

Las notificaciones web push aparecen en el celular del cliente incluso si no tiene la PWA abierta (siempre que la haya instalado y autorizado notificaciones). Son ideales para avisos puntuales: nueva recompensa, recordatorio de canje, promo con vencimiento.

Email transaccional #

Los emails transaccionales se disparan automaticamente en hitos importantes: invitacion, bienvenida, confirmacion de canje, resumen mensual de puntos. Todos llevan el branding del tenant.

WhatsApp (opcional) #

Que es una campana #

Una campana es un envio dirigido a un segmento de clientes con un objetivo especifico: traer clientes inactivos, premiar a los de alto ticket, celebrar cumpleanos del mes, etc. Desde Campanas > Nueva podes crear una en minutos.

Segmentos y filtros #

Los segmentos se arman con filtros combinables:

• Nivel: Silver, Gold, Platinum, Diamond.
• Recencia: clientes que compraron hace mas de X dias / menos de X dias.
• Frecuencia: clientes con al menos X compras en los ultimos Y dias.
• Monetario: clientes con ticket promedio mayor a X.
• Sucursal: clientes que compran en una sucursal especifica.
• Fecha de nacimiento: cumpleanos del mes, la semana, el dia.
• Estado de invitacion: invitados, no invitados, activos, dormidos.

Envio y medicion #

Al confirmar una campana eliges los canales (inbox + push + email, por ejemplo) y el horario de envio. Despues del envio podes ver metricas: entregados, abiertos, clickeados, conversiones (canjes o compras posteriores).

Como accede el cliente final #

El cliente final accede exclusivamente por invitacion. El flujo desde su perspectiva es:

1. Recibe un email o SMS del tenant con un link personalizado.
2. Abre el link en su celular o compu. Ve la landing branded con el logo del tenant.
3. Define una contrasena. (Proximamente: magic link sin password).
4. Entra al portal del cliente y ve sus datos: puntos, nivel, recompensas.
5. Se le sugiere instalar la PWA en su celular para la mejor experiencia.

Portal web del cliente #

El portal web es responsivo y funciona en cualquier navegador. Muestra:

• Puntos disponibles y nivel actual.
• Progreso hacia el siguiente nivel.
• Catalogo de recompensas (con filtro por nivel y por disponibilidad).
• Historial de actividad (compras registradas, puntos ganados, canjes realizados).
• Inbox de mensajes.
• Preferencias de comunicacion.

PWA instalable #

La PWA es la misma experiencia del portal, pero con ventajas extra cuando se instala:

• Icono en la pantalla de inicio del celular.
• Notificaciones push (si el cliente las autoriza).
• Funciona con mala conexion gracias al cache.
• Arranque rapido, sin pasar por el navegador.

En iOS se instala desde el boton Compartir > Agregar a pantalla de inicio. En Android, el navegador sugiere la instalacion automaticamente.

Canjear una recompensa #

1. El cliente abre la PWA o portal y va a Recompensas.
2. Elige la recompensa que quiere canjear.
3. Confirma. Los puntos se descuentan y aparece el codigo + QR.
4. Guarda el codigo o lo presenta directamente en el local.
5. El operador valida el codigo en el portal y marca el canje como usado.

Reporte RFM #

RFM (Recencia, Frecuencia, Monetario) es la metrica estandar de fidelizacion. Connexa segmenta automaticamente a tus clientes en grupos: Campeones, Leales, Potenciales, En Riesgo, Dormidos, Perdidos. Cada grupo tiene un tratamiento sugerido para campanas.

Retencion y churn #

El reporte de retencion muestra que porcentaje de los clientes activos en el mes N siguen activos en el mes N+1, N+2, etc. El churn es el complemento: cuantos dejaron de comprar.

Embudo de adopcion #

Este reporte muestra la conversion entre cada hito de invitacion: cuantas invitaciones enviaste, cuantas se abrieron, cuantos se registraron, cuantos siguen activos, cuantos instalaron la PWA. Es tu brujula para optimizar el onboarding.

Roles disponibles #

Usuarios del back-office #

Desde Configuracion > Usuarios, el ConnexaOwner puede dar de alta usuarios nuevos, asignarles rol, resetear password o desactivar. Todos los usuarios del back-office usan autenticacion centralizada de IntegraIA (SSO con Digital One, Domus y Portal de Licencias).

Planes y limites #

Connexa tiene cuatro planes con limites crecientes. Los limites exactos pueden ajustarse en el tiempo; los siguientes son los valores de referencia.

Upgrade de plan #

Podes cambiar de plan en cualquier momento desde el Portal de Licencias. El cambio es inmediato: los limites nuevos se aplican al instante y la facturacion se prorratea al ciclo en curso.

Suspension y baja #

Si suspendes tu suscripcion, el acceso al back-office queda bloqueado, pero los datos se conservan por 90 dias para que puedas reactivar sin perder nada. Despues de ese plazo, los datos se eliminan definitivamente (previo aviso por email).

Reportar un problema #

Desde el boton de Reportar problema en el portal (esquina superior derecha) podes abrir un ticket. Se registra en el sistema, queda trazable y el equipo de soporte lo responde por email.

Preguntas frecuentes #

Mis clientes pueden registrarse solos?

No. Connexa es estrictamente invitation-only. El cliente accede unicamente a traves de un link de invitacion que vos le envies. Esto evita registros falsos y mantiene tu base controlada.

Que pasa si un cliente cambia de celular?

Entra al portal web desde el nuevo celular con su email y password, y desde ahi instala la PWA nuevamente. Sus puntos y nivel estan atados a su cuenta, no al dispositivo.

Puedo exportar mi base de clientes?

Si. Desde Clientes > Exportar podes bajar un Excel con toda tu base, incluyendo puntos, nivel y estado de invitacion.

Como integro Connexa con mi ERP o sistema de facturacion?

En planes Pro y Enterprise podes enviar transacciones por API. La documentacion tecnica se entrega al contratar el plan. Conectores nativos con CODEXWeb y otros sistemas populares estan en roadmap.

Que pasa si me paso del limite de clientes?

El sistema no borra clientes, pero impide dar de alta nuevos hasta que upgradees el plan. Te avisa por email cuando estas cerca del limite (80% y 95%).

El cliente final puede usar Connexa sin instalar la PWA?

Si. El portal web funciona en cualquier navegador. La PWA es solo una mejora de experiencia.

Contacto de soporte #

Email: notify@integraia.tech

WhatsApp: a traves de la pagina de producto Connexa.

Documentacion tecnica para desarrolladores: disponible bajo demanda a los planes Pro y Enterprise.