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.

✨ Novedades de mayo 2026 (parte 3) — difusion directa, video y sin-login #

Tercera tanda del mes. Cuatro cambios grandes que reorientan como el comercio se comunica con sus clientes y como los clientes acceden a la PWA:

• 📨 Difusion directa — nueva pantalla principal de la PWA admin (reemplaza al Dashboard como landing). Layout estilo WhatsApp: lista de grupos a la izquierda, chat con cada grupo a la derecha. Cada grupo es un "chat" con todas las difusiones que le mandaste, ordenadas cronologicamente, con metricas de leidos por mensaje. Tocas un grupo, escribis, mandas. Sin formulario, sin pasos extra. Ir a la seccion →
• 🎬 Video in-app con compresion — el composer de Difusion directa tiene un boton "Video" que abre la camara del celu (o webcam en desktop). Grabas hasta 60 segundos, se comprime automaticamente a 720p ~600 kbps, sube en 2-5 segundos y queda como burbuja de video reproducible para tus clientes. Un clip de 30s pesa ~2.5 MB. Ir a la seccion →
• 🔑 Login sin password para el cliente final — tus clientes ya no tienen que recordar contrasena. Ponen su email, reciben un link magico, tocan, entran. Su sesion queda activa por un ano con extension automatica cada vez que abren la app. Si pasa mucho tiempo sin usar, piden otro link — igual que WhatsApp pero por email en vez de SMS (sin costo por mensaje). Ir a la seccion →
• 📲 Globitos de no leidos en la PWA cliente — el inbox del cliente paso de "lista de mensajes" a "lista de chats" estilo WhatsApp. Cada difusion que recibio aparece con avatar, preview del ultimo mensaje, fecha relativa y un globito rojo a la derecha con la cantidad de mensajes sin leer del thread. Sabe de un toque donde tiene novedades. Ir a la seccion →
• 🏠 Pantalla inicial configurable por tenant — en Empresa → Pantalla inicial elegis donde aterrizas vos al abrir tu PWA admin (Difusion directa por default, pero podes elegir Conversaciones, Dashboard, Clientes, Campanas, Recompensas, Canjes) y donde aterriza tu cliente al abrir su PWA (Inicio por default, o Inbox, Recompensas, Movimientos). Cada tenant puede priorizar lo que mas usa. Ir a la seccion →
• 🔔 Mensaje push configurable — en Mensajeria ahora podes definir un titulo y cuerpo por defecto que aparecen en el push del celular del cliente cuando la difusion no tiene asunto/cuerpo propio. Por ejemplo: titulo "Kosiuko - Novedades" en vez del generico "Mensaje del comercio". Ir a la seccion →
• ♻ Reactivar grupos desde el detalle — antes el boton para reactivar un grupo anulado estaba escondido en el modal de edicion del listado. Ahora aparece como boton naranja en el header del detalle del grupo — mucho mas facil de encontrar.
• 📸 Fix de fotos en Samsung — el iPhone subia las fotos pero algunos Samsung mostraban "la foto supera los 3 MB". El bug era que validabamos el tamano antes de comprimir. Ahora validamos despues, y una foto cruda de 12 MB que comprimida queda en 400 KB pasa sin problemas.
• 🔍 Toggle push claro — el toggle "Notificar al celular" en Difusion directa pasa a ser un boton pill explicito que dice "🔔 ON" (naranja) o "🔕 OFF" (gris), con tooltip explicando el estado. Antes era un circulo opaco facil de tocar sin querer.

✨ Novedades de mayo 2026 (parte 2) — difusion mobile-first #

Segunda tanda del mes: la idea es que el vendedor pueda manejar la comunicacion con los clientes desde el celular con la misma comodidad que WhatsApp, pero con todo el contexto de Connexa atras.

• 📸 Multiples fotos por mensaje — en difusion rapida y en las conversaciones podes adjuntar hasta 10 fotos por mensaje (configurable). Galeria con miniaturas, reorder con flechitas y eliminar individual. Las fotos se comprimen automaticamente en el celu antes de subir (de ~5 MB a ~400 KB), asi son rapidas de mandar incluso por 4G. Ir a la seccion →
• 🎤 Mensajes de voz tipo WhatsApp — manten apretado el boton del microfono, soltalo para enviar, deslizalo afuera para cancelar. Limite configurable (default 2 minutos). En el portal-web ademas podes adjuntar un archivo de audio. El audio se graba a 32 kbps mono con cancelacion de eco para que pese poco y se escuche limpio. Ir a la seccion →
• 📋 Audiencia editable en difusion rapida — ya no es solo "Todos" o "el grupo X". Eliges una base (todos / grupos) y luego ves la lista entera de destinatarios con un check al lado de cada uno. Tildas / destildas individualmente y, ademas, podes sumar clientes que NO estan en el grupo (etiqueta verde +extra). El contador arriba muestra cuantos van a recibir el mensaje. Ir a la seccion →
• 🔔 Toggle "Notificar al celular" — arriba de "¿A quien va?" hay un check (default ON) que decide si la difusion ademas de aparecer en el inbox tambien dispara una notificacion push al celular del cliente. Ir a la seccion push →
• 📝 Borrador automatico — si arrancas a armar una difusion, sumas fotos, audio y texto, y por algun motivo cambias de pagina o cerras la app, al volver te aparece un cartelito amarillo "Tenes un borrador guardado" con boton Recuperar / Descartar. Tambien aparece un confirm si intentas salir con datos sin enviar. Ir a la seccion →
• 📱 Connexa Admin como app instalable — el panel del comercio ahora es una PWA propia, distinta de la del cliente final. Se instala con el mismo flujo (compartir → agregar a pantalla de inicio en iPhone, "Instalar app" en Chrome). Aparece como icono "Cnxa Admin" con tema oscuro. Ir a la seccion →
• ☰ Bottom nav mobile — cuando entras al admin desde el celu aparece una barra inferior fija con 4 botones: Difusion / Chats / Clientes / Mas. El boton Mas abre el menu lateral con el resto de las opciones. Chats muestra un puntito rojo con el numero de mensajes nuevos sin leer. Ir a la seccion →
• 🔐 Login diferenciado — los logins de Connexa Admin y Connexa Cliente ahora se diferencian visualmente: el admin lleva un cintillo "Panel del comercio" con tonos pizarra, y el cliente lleva "Mi espacio" con la paleta coral. Misma marca CONNEXA, pero al toque sabes a cual entras. Ir a la seccion →
• ⚙ Configuracion de mensajeria — nueva pantalla en Mas → Administracion → Mensajeria donde el dueno del comercio define los limites: cantidad maxima de fotos por mensaje, MB por foto, duracion maxima de audio, MB por audio. Aplica a difusion rapida y conversaciones. Ir a la seccion →
• 🗑 Anular vs Eliminar grupo — los grupos de clientes ahora distinguen Anular (soft delete, queda en historial) vs Eliminar (borrado fisico real). Eliminar valida que el grupo no tenga miembros y que no aparezca en ninguna difusion historica antes de permitirlo, asi no rompes registros previos. Ir a la seccion →

✨ Novedades de mayo 2026 (parte 1) #

Resumen de los cambios grandes que se incorporaron a principios de mes.

• 🎯 Vista 360 del cliente — un dashboard completo con datos de contacto, fidelizacion, ultimos canjes, movimientos de puntos, compras (cuando importes tickets), invitacion y campanas recibidas. Accesible desde la ficha del cliente o desde la conversacion. Ir a la seccion →
• 💬 Conversaciones rediseñadas — lista a 100% de ancho con buscador global (busca por nombre, email, telefono, codigo o contenido del mensaje). Click en una fila te lleva a una vista dedicada con el dashboard 360 al lado del chat. Ir a la seccion →
• 🔍 Chat con buscador y agrupacion por campana — dentro de cada conversacion podes buscar texto en todos los mensajes y togglear entre vista cronologica y agrupada por campana. Asi seguis el hilo de cada tema sin perderte. Ir a la seccion →
• 🪙 Acciones rapidas en el dashboard — botones a un toque para ajustar puntos manualmente (con motivo y validacion de saldo), abrir WhatsApp con texto pre-cargado, llamar por telefono, mandar email o ir a la ficha completa. Ir a la seccion →
• 📱 Wizard de instalacion PWA paso a paso — tus clientes ya no se quedan trabados con "¿como instalo la app?". Hay una guia visual con dibujitos para iPhone y Android, accesible desde el portal, desde un boton del email de invitacion y desde un QR si la persona esta en la compu. Ir a la seccion →
• 🖼 Imagenes estandarizadas en el chat — las imagenes que pegas o subis a campanas y mensajes se muestran con tamaño limitado (max 280px de alto) sin importar el tamaño del archivo original. Click en la imagen para verla en grande. Ir a la seccion →
• ⚙ Mejor visibilidad en el menu del portal del cliente — la ruedita de Configuracion ahora tambien muestra el texto "Config" para que se vea facil. Cada item del menu (Inicio, Recompensas, Movimientos, Inbox, Config) tiene su icono.

📨 Difusion directa #

Pantalla: /admin/difusion-directa — nueva landing por defecto de la PWA admin (en vez del Dashboard).

Difusion directa es la pantalla principal del comercio: una vista tipo WhatsApp pensada para que mandes mensajes a tus clientes sin pasar por formularios.

Lo que ves

• Lista de grupos a la izquierda: con buscador y "Todos los clientes" siempre arriba. Cada fila muestra el nombre del grupo, el preview del ultimo mensaje que le mandaste y la fecha.
• Chat del grupo a la derecha: historial completo de las difusiones que le mandaste a ese grupo. Cada burbuja con foto/audio/video/texto y abajo "✓ enviado a N" o "✓✓ M / N" si ya leyeron.
• Composer abajo: textarea estilo chat + boton de foto + push & hold para audio + boton para video + toggle 🔔 ON/OFF para push + boton circular para enviar.

En mobile

El layout es de una pantalla por vez (igual que WhatsApp en el celu). Tocas el grupo, entra al chat full-screen. Volves con la flecha ‹.

Borradores por grupo

Si empezas a escribir en un grupo, te vas a otro y volves, lo que tenias escrito sigue ahi. Cada grupo tiene su propio borrador (texto + adjuntos), independiente. Duran 24 hs.

Diferencia con Difusion rapida

Difusion rapida (que sigue accesible por URL /admin/difusion-rapida aunque ya no este en el menu) es un formulario clasico para casos donde necesitas elegir clientes especificos dentro del grupo (con audiencia editable). Difusion directa es para el dia a dia: un grupo entero, un mensaje, listo.

🎬 Video in-app con compresion #

Pantalla: boton "Video" en el composer de /admin/difusion-directa.

Tocas "Video" en el composer y se abre un modal full-screen con la camara del celu (camara trasera por default) o tu webcam si estas en desktop.

Como grabar

1. Tocas "● Grabar" → arranca el contador (0:10 / 1:00 por ejemplo).
2. Cuando termines, tocas "■ Detener". El video sube en 2-5 segundos y vuelve al composer con el preview listo.
3. Si te equivocas, "Cancelar" descarta sin subir.

Por que es liviano

El video se graba a 720p con bitrate moderado (video 600 kbps + audio mono 32 kbps). Un clip de 30 segundos pesa ~2.5 MB — sube rapido por 4G y se reproduce sin problemas en el celu del cliente. Limite: 60 segundos y 30 MB. Si supera, te avisa y no sube.

Que ven tus clientes

El video aparece en la burbuja del mensaje con un reproductor estandar (<video controls>). Pueden ver, pausar, avanzar, poner pantalla completa.

🔑 Login sin password con link magico #

Pantalla: /portal/login

Tus clientes ya no tienen que recordar contrasenas. El flujo nuevo es:

1. El cliente entra a su portal (o ya tenia la PWA instalada y la abre).
2. En la pantalla de login ve arriba "Mandame un link magico" con un input de email.
3. Pone su email y toca el boton.
4. Le llega un mail con el branding de tu comercio y un boton "Entrar a [tu marca]".
5. Toca el boton del mail → queda logueado y aterriza en la pantalla configurada del tenant (Inicio por defecto).

El link es seguro

• Es de un solo uso: una vez que se uso, se invalida. Si alguien intenta usarlo dos veces, no funciona.
• Vence a las 24 horas. Despues de eso hay que pedir uno nuevo.
• Si el email no existe en tu padron, igual se ve el mensaje "te lo mandamos" para no revelar quien esta registrado y quien no (proteccion antiscraping).

Una vez logueado, no se desloguea

La sesion del cliente queda activa por 365 dias con extension automatica. Cada vez que el cliente abre la PWA, el contador se resetea. En la practica: mientras siga usando la app aunque sea una vez al ano, no necesita volver a loguearse.

Compatibilidad con password

El login con email + password sigue disponible — abajo del boton magico hay una opcion colapsable "Prefiero ingresar con contrasena" con el form clasico. Para clientes que ya tenian password antes, sigue funcionando exactamente igual.

📲 Inbox del cliente con globitos no leidos #

Pantalla: /portal/inbox

El inbox del cliente final paso de "lista de mensajes" a "lista de chats" estilo WhatsApp.

Lo que ve el cliente

• Cada thread (mensaje original del comercio + sus eventuales respuestas) aparece como una fila tipo chat.
• Avatar circular con las iniciales del titulo del mensaje.
• Titulo del mensaje + fecha relativa (HH:mm hoy / "ayer" / "mar" / "dd/MM").
• Preview del ultimo mensaje del thread, con prefijo 🎬 / 📷 / 🎤 si tiene adjunto y "Vos:" si la ultima fue una respuesta del cliente.
• Globito rojo a la derecha con la cantidad de mensajes sin leer de ese thread. Si todo esta leido, no aparece.
• Los chats con mensajes nuevos suben arriba de la lista (orden por fecha del ultimo mensaje del thread, no del primero).
• Mensaje sin leer: fondo crema + borde izquierdo naranja + titulo en negrita.

El cliente toca el chat → entra al thread completo → los globitos se descontan automaticamente al leer.

🏠 Pantalla inicial configurable #

Pantalla: /admin/empresa → seccion "Pantalla inicial".

Cada empresa elige donde aterrizan sus admins y sus clientes finales al abrir la PWA. Util para priorizar la pantalla mas usada por tu equipo o por tu programa.

Para tu equipo (PWA admin)

• Difusion directa (default) — ideal si la comunicacion es lo mas usado.
• Conversaciones — util si tu negocio responde mucho a mensajes de clientes.
• Panel / Dashboard — clasico, util si arrancas el dia mirando metricas.
• Clientes / Campanas formales / Recompensas / Canjes — para flujos especializados.

Para tus clientes (PWA cliente)

• Inicio (default) — ven puntos, nivel y accesos rapidos.
• Inbox — util si tu programa es 100% comunicacion (vas a mandar muchas difusiones).
• Recompensas — si queres pushear el catalogo de canjes.
• Movimientos — si queres que vean primero su historia de puntos.

El cambio aplica al siguiente login. Si el cliente ya tiene la PWA abierta, va a notar el cambio la proxima vez que cierre y abra.

🔔 Mensaje push configurable #

Pantalla: /admin/configuracion-mensajeria → seccion "Notificacion push al cliente".

Cuando una campana o difusion no tiene asunto/cuerpo propio, Connexa usa estos textos como fallback para el push del celu del cliente.

Cuando se usan

• Titulo por defecto: aparece como titulo de la notificacion cuando la campana no tiene Asunto. Si la dejas vacia, se usa el generico "Mensaje del comercio".
• Cuerpo por defecto: aparece como cuerpo cuando la campana no tiene contenido HTML. Si la campana tiene contenido, se usa el preview del contenido (primeros 120 caracteres).

Por que importa

El cliente ve la notificacion en su celu antes de tocarla. Si dice "Mensaje del comercio" pierde gracia. Si dice "Kosiuko - Tenemos novedades para vos" tiene mucho mas impacto y mas chances de que la abra.

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 o empresas 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.

Connexa soporta tanto fidelizacion B2C (consumidores finales) como B2B (distribuidores, mayoristas, otras empresas). Cada cliente puede ser persona fisica o persona juridica, con multiples emails/telefonos/documentos y direcciones geocodificables.

Alta manual #

Para cargar un cliente de a uno:

1. Anda a Clientes y apreta + Nuevo cliente.
2. El form pide: nombre + apellido, tipo y numero de documento (obligatorio — default DNI), email y telefono opcionales.
3. El numero de documento queda automaticamente como codigo del cliente — lo vas a ver en la columna Codigo del listado, en la ficha y en los reportes.
4. Si ese documento o ese email ya estan asignados a otro cliente, Connexa bloquea el alta y te dice cual es el cliente que ya los usa. Asi evitas duplicar a la misma persona por error.
5. Apretas Guardar. El cliente queda en estado No invitado, con email/telefono/documento sembrados como principales en las tablas hijas.
6. Despues entra a la ficha para completar los datos extendidos: persona fisica/juridica, direccion fiscal, multiples contactos, documentos extra, etc.

🎯 Vista 360 del cliente #

La Vista 360 es un dashboard que reune en una sola pantalla todo lo que necesitas saber del cliente para atenderlo bien. Se accede desde el boton coral 🎯 Vista 360 en el header de cualquier ficha de cliente, o desde la conversacion (queda al lado del chat).

El dashboard tiene 8 cards apiladas:

• Hero con avatar de iniciales, nombre, codigo externo, badge de nivel, badge de estado activo/inactivo y saldo de puntos en grande.
• Acciones rapidas: 🪙 Ajustar puntos, 📱 WhatsApp, 📞 Llamar, ✉️ Email, 💬 Conversacion, 📋 Ficha completa. Cada una se habilita segun los datos disponibles del cliente (si no tiene telefono, no aparece WhatsApp ni Llamar).
• Datos de contacto: email, telefono, documento, localidad, fecha de nacimiento, aniversario. Si esta a 7 dias o menos del cumple, te avisa con un 🎉.
• Fidelizacion: KPIs de saldo actual, historico ganado, total de canjes, ultima compra.
• Ultimos canjes (5 mas recientes): nombre de la recompensa, codigo, estado (Pendiente/Validado/Vencido/Anulado), fecha y puntos usados.
• Ultimos movimientos de puntos (10 mas recientes): descripcion, tipo, operador, signo y fecha.
• Compras: KPIs de total comprado, tickets y ticket promedio. Si todavia no importaste tickets, muestra un placeholder amigable con link a /admin/integraciones para configurar.
• Acceso al portal: estado de la invitacion (Activa, Pendiente, Registrada, Vencida, Revocada), fechas y boton para invitar si todavia no se mando nada.
• Ultimas campanas recibidas: 5 mas recientes con nombre, asunto y estado leido/no leido.

🪙 Ajustar puntos manualmente #

Desde el boton Ajustar puntos del dashboard 360 se abre un modal para sumar o restar puntos al cliente con un motivo registrado en su historial.

1. Apreta 🪙 Ajustar puntos en cualquier vista del cliente (ficha, vista 360 o conversacion).
2. Elegi un valor rapido (+10, +50, +100, -10, -50) o tipea uno custom (numero negativo para descontar).
3. Escribi el motivo — obligatorio, queda registrado en el historial del cliente para auditoria.
4. Apreta Aplicar ajuste. El sistema valida que el saldo no quede negativo y registra el movimiento con el operador que lo hizo.
5. El dashboard se refresca solo — vas a ver el nuevo saldo y el movimiento aparece arriba en la lista.

Eliminar un cliente #

Desde la ficha de un cliente (/admin/clientes/{id}), al final hay una Zona peligrosa con un boton para eliminar.

Al apretar Eliminar cliente, Connexa primero chequea que no tenga movimientos:

• Transacciones (compras registradas).
• Movimientos de puntos (ganados / canjeados / ajustes).
• Canjes de recompensas.

Si tiene cualquiera de esos, bloquea la eliminacion y te muestra cuantos hay. La sugerencia es desactivar al cliente en lugar de eliminarlo — asi conserva el historial sin operar.

Si el cliente esta limpio (sin movimientos), pide tipear el nombre completo para confirmar y borra en cascada manual: contactos (emails, telefonos, documentos, direcciones), cuenta del portal, dispositivos push, invitaciones, mensajes inbox, membresias en grupos, acumuladores. El cliente queda eliminado fisicamente.

Persona Fisica vs Juridica #

En la ficha del cliente, dentro del card Tipo de persona y datos extendidos, podes elegir el tipo:

• Fisica (consumidor final, persona individual): mostra campos para sexo (M/F/X), fecha de nacimiento, fecha de aniversario.
• Juridica (empresa, comercio, distribuidor): mostra campos para razon social y nombre fantasia.

Comunes a ambos tipos: pais, sitio web, codigo externo (ID en tu ERP).

Emails, telefonos y documentos multiples #

Cada cliente puede tener mas de un email, mas de un telefono y mas de un documento. Cada uno con su tipo:

• Emails: Personal, Comercial, eFactura, Marketing.
• Telefonos: Particular, Celular, Comercial, Fax, WhatsApp.
• Documentos: DNI, CUIT, CUIL, CDI, Pasaporte, Interno.

En cada lista podes marcar uno como principal (lo usa Connexa por defecto cuando necesita un canal unico, ej. para enviar campañas por email). Si marcas un nuevo principal, el anterior se desmarca automaticamente.

Tambien hay un flag activo: emails o telefonos inactivos siguen visibles en la ficha pero no se usan para enviar nada. Util cuando un email rebota: en lugar de borrarlo, lo desactivas y queda como historico.

Direcciones geocodificables #

Cada cliente puede tener varias direcciones:

• Facturacion (fiscal): unica por cliente. Es la que sale en facturas/comprobantes.
• Comercial: oficina o local de contacto comercial.
• Entrega: a donde mandar productos. Puede ser distinta a la fiscal.
• Particular: domicilio personal del contacto principal.

Al cargar una direccion en la ficha, vas a tener una cascada: primero elegis pais, despues provincia (filtra solo las del pais), despues partido/departamento (filtra solo los de la provincia), y por ultimo localidad (filtra solo las del partido). El codigo postal se autocompleta cuando elegis localidad.

El catalogo geografico tiene 54 paises, todas las provincias y localidades de Argentina (24 + CABA), Uruguay, Chile, Mexico, Estados Unidos, España y muchos mas. Si tu localidad no aparece, es que no esta en el catalogo — escribinos y la agregamos.

Importar desde Excel #

Si ya tenes una base de clientes en otro sistema, la podes importar en lote desde Importaciones > Nueva:

1. Elegi entidad Clientes.
2. Apreta 📥 Descargar plantilla (banner coral). Te baja un archivo plantilla-clientes-connexa.xlsx.
3. Abrilo y vas a ver dos hojas: Clientes (donde cargas tus datos) y Referencias (lista de paises, provincias, tipos validos).
4. Borra las filas de ejemplo y carga tu base. Respeta los nombres de las columnas (case-insensitive).
5. Subi el archivo. Por defecto se ejecuta en modo simulacion (dry-run): te muestra cuantas filas se insertarian, cuantas se actualizarian, cuantas se rechazan y por que.
6. Si los numeros se ven bien, apretas Aplicar a produccion. Si no, descartas y ajustas el archivo.

Plantilla descargable y sintaxis multi-valor #

La plantilla tiene 27 columnas (la mayoria opcionales). Las claves principales:

• codigoexterno: tu ID interno (recomendado). Es la clave de unicidad. Sin esto, Connexa intenta matchear por email o documento.
• tipopersona: F (fisica) o J (juridica). Si lo dejas vacio y hay CUIT/CUIL, lo infiere por longitud + primer digito.
• nombre + apellido (para fisicas) o razonsocial + nombrefantasia (para juridicas).
• pais: nombre del pais (ej: Argentina, Uruguay). Si lo dejas vacio, asume Argentina.

Para cargar varios emails / telefonos / documentos en una misma fila, usa la sintaxis valor:Tipo separados por ;:

emails:     juan@personal.com:Personal;ventas@empresa.com:Comercial
telefonos:  11-5555-1234:Celular;011-4444-5555:Particular
documentos: 27123456:DNI;20-27123456-7:CUIL

Si no especificas el tipo, Connexa asume Personal para email, Celular para telefono, y para documento infiere por longitud (DNI / CUIT / CUIL).

Para la direccion principal en la misma fila usas las columnas direccion_calle, direccion_numero, direccion_localidad, direccion_provincia, etc. Solo se crea la direccion estructurada si hay calle real — si solo tenes localidad y provincia, esos datos quedan en los campos legacy del cliente y los completas despues con calle desde la ficha.

Campos disponibles #

Compatibilidad con CSV antiguos: los campos legacy email, telefono, documento, tipodocumento, localidad, provincia siguen funcionando. Connexa los acepta y crea automaticamente las filas correspondientes en el modelo nuevo (con tipo Personal / Celular / inferido).

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.

Al final de cada corrida vas a ver, en la seccion Observaciones:

• ⚠ Clientes nuevos que comparten email/documento con otros existentes (posibles duplicados humanos).
• 📍 Direcciones con localidad no encontrada en el catalogo (con ejemplos top 20). Calle/CP se guardan, pero la direccion no es geocodificable hasta que la edites.
• ⚠ Direcciones con localidad ambigua (existe en varias provincias) cuando no especificaste direccion_provincia.
• 🌎 Paises no reconocidos.

Estas son observaciones informativas, no errores. La fila se procesa igual; vos decidis si limpias el archivo y reimportas, o editas los casos puntuales desde la ficha.

Cancelar / descartar runs #

Desde el detalle de una importacion (Importaciones > click en el run) tenes dos botones rojos abajo del card de datos del run:

• 🛑 Cancelar run — solo aparece si el run esta En progreso. Marca el run como Cancelado. El motor se entera en la proxima iteracion (a lo sumo en 30 segundos), termina el batch actual prolijamente y sale. Las filas ya procesadas quedan en produccion; las que faltaban se quedan en staging para que decidas que hacer.
• 🗑 Descartar run — aparece para runs Completado, Con errores o Cancelado (incluido cualquier dry-run/simulacion). Te pide confirmacion en un modal y borra el ImportRun + todas sus filas en staging. No toca produccion si el run era live ya aplicado: los clientes/datos ya creados quedan, solo se borra el historial del run para que la lista quede limpia.

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.

Activacion del lado del cliente: en su inbox aparece un boton 🔔 Activar. Cuando el cliente lo toca, el navegador le pide permiso. Si acepta, queda suscrito. En iPhone es obligatorio que primero haya agregado la app a la pantalla de inicio (ver wizard).

Activacion del lado del admin: en difusion rapida hay un toggle 🔔 Notificar al celular del cliente arriba de la seccion "¿A quien va?". Si esta tildado (default), la difusion ademas de aparecer en el inbox dispara la notificacion push. Si lo destildas, el mensaje queda en el inbox sin sonar.

Para mensajes directos desde una conversacion (no campanas), la notificacion push siempre se intenta enviar — es la unica forma razonable de que el cliente se entere a tiempo de tu respuesta.

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) #

Mientras tanto, todos los lugares del portal donde tenes el telefono del cliente (ficha, vista 360, conversacion) tienen un boton 📱 WhatsApp que abre la app oficial con el texto pre-cargado para que el operador solo tenga que apretar enviar. Es un atajo manual util para casos urgentes.

Difusion rapida #

La pantalla Comunicacion > Difusion rapida esta pensada para que un vendedor mande un mensaje a sus clientes desde el celular en menos de un minuto. Es la forma mas comun de comunicacion del dia a dia — un mensaje informal, "miren la prenda nueva", "vendi 3 ya", etc.

1. Tocar 📨 Difusion en la barra inferior (mobile) o en el menu lateral.
2. Sumar fotos (opcional, ver siguiente seccion).
3. Decidir si manda con audio (push & hold del microfono).
4. Escribir el texto.
5. Elegir si se notifica al celular o no (toggle 🔔).
6. Decidir la base: Todos o Grupos especificos.
7. Revisar la lista de destinatarios y editarla (ver Audiencia editable).
8. Tocar 📨 Enviar a N clientes.

Multiples fotos por mensaje #

Cuantas fotos por mensaje y de que tamaño dependen de tu configuracion de mensajeria. Defaults: 10 fotos por mensaje, hasta 3 MB cada una.

• Tocar Tomar fotos abre directo la camara del celu (boton trasero por default).
• Cada foto se agrega como miniatura. Hover muestra flechitas ‹ y › para reordenar y boton × para eliminar.
• Cuando ya hay al menos una, aparece tambien el cuadrito + Agregar para sumar mas hasta el limite.
• En el portal-web ademas podes pegar imagenes con Ctrl+V.
• Compresion automatica: las fotos se redimensionan a max 1920px del lado largo y se reencodean a JPEG calidad 82% en tu propio celu antes de subirlas. Una foto que sale del iPhone pesando 5 MB termina pesando ~400 KB sin perdida visible. Resultado: subida ~10x mas rapida en 4G.
• Las fotos quedan visibles para el cliente como una galeria en la burbuja del mensaje (1 foto a tamaño grande, 2 fotos lado a lado, 3+ en grilla con limite de 6 + contador "+N").

Mensajes de voz (audio) #

Cuando esta habilitado el audio (ver configuracion de mensajeria), aparece un boton 🎤 Manten para grabar.

1. Mantener apretado el boton (no soltar).
2. La primera vez el celu pide permiso al microfono. Aceptar.
3. Mientras grabas ves un punto rojo y la cuenta del tiempo (ej: 0:14 / 2:00).
4. Soltar el dedo encima del boton para enviar el audio.
5. Para cancelar: arrastrar el dedo afuera del boton ANTES de soltar. No queda nada guardado.
6. Una vez subido, aparece un reproductor con play/pause. Si no te gusta, × para borrar y volver a grabar.

Calidad: el audio se graba en mono a 32 kbps en codec opus, con cancelacion de eco, supresion de ruido y control automatico de ganancia. Voz humana suena igual que a 96 kbps, pero pesa 1/3. Resultado: 5 segundos de audio = ~20 KB.

Solo en portal web (no mobile) aparece tambien un boton clip que permite adjuntar un archivo de audio existente (mp3, m4a, webm, ogg, wav).

Audiencia editable #

La seccion 📋 Revisar lista aparece apenas elegis "Todos" o un grupo. Te muestra la lista entera de destinatarios con un check al lado de cada uno.

• Tildar / destildar individuales: aunque el cliente pertenezca al grupo, podes excluirlo de esta difusion en particular sin sacarlo del grupo.
• Buscador integrado: tipea nombre, email o telefono. Filtra la base seleccionada en tiempo real (mostramos cuantos resultados arriba).
• Sumar clientes fuera de la base: si buscas a alguien que NO esta en el grupo, aparece abajo una seccion "Otros N clientes fuera de la base que matchean". Tildas el check y se suma a la lista con etiqueta verde +extra.
• Atajos arriba: Tildar todos y Destildar para empezar de cero o resetear.
• Paginacion 50 por pagina: si tu base tiene 1500 clientes, navegas con ‹ / ›.
• El contador grande arriba muestra siempre cuantos van a recibir el mensaje en este momento.

Borrador automatico (no perder el trabajo) #

Si arrancas a armar una difusion (sumas fotos, grabas audio, escribis texto) y por algun motivo cambias de pagina, recargas la app o el celu se reinicia, los datos no se pierden:

• Mientras estas armandola, todo se va guardando en el celu como borrador (cada 0.5 segundos).
• Si intentas salir con datos sin enviar, te aparece un confirm: "Tenes fotos, audio o texto cargados sin enviar. Si salis ahora se guarda como borrador y los recuperas al volver. ¿Salir igual?".
• Cuando volves a la pantalla, si hay un borrador aparece un cartel amarillo arriba: "Tenes un borrador guardado" con dos botones: Recuperar (carga las fotos / audio / texto / grupos) o Descartar (lo borra).
• El borrador expira a las 24 horas si no lo usas.
• Cuando el envio es exitoso, el borrador se limpia automaticamente.

Bandeja de conversaciones #

En Comunicacion > Conversaciones tenes la bandeja unificada de todos los hilos vivos con tus clientes. Cada fila muestra:

• Avatar de iniciales y nombre del cliente.
• Preview del ultimo mensaje (con prefijo "Vos:" si lo enviaste vos).
• Email y telefono del cliente.
• Badge rojo con cantidad de mensajes no leidos del cliente, si los hay.
• Fecha relativa del ultimo mensaje (hoy con hora, ayer, dia de la semana, fecha si es mas viejo).

Las conversaciones con respuestas no leidas aparecen primero (con borde rojo a la izquierda), despues por actividad mas reciente. Click en cualquier fila te lleva a la vista dedicada.

Buscador global #

Arriba de la lista hay un buscador (con debounce de 280ms) que filtra cualquiera de estos campos del cliente o de los mensajes:

• Nombre y apellido del cliente.
• Email del cliente.
• Telefono del cliente.
• Codigo externo del cliente.
• Asunto de cualquier mensaje del thread.
• Contenido HTML de cualquier mensaje no eliminado (lo que el cliente o vos escribieron).

Vista dedicada con dashboard 360 #

Al entrar a una conversacion (/admin/conversaciones/{clienteId}) la pantalla se divide en dos columnas:

• Izquierda (1/3, sticky): el dashboard 360 completo del cliente. Mientras chateas, tenes a la vista sus puntos, nivel, ultimos canjes, movimientos, datos de contacto y los botones de accion rapida (ajustar puntos, WhatsApp, llamar, email).
• Derecha (2/3): el chat con el cliente, con buscador local, toggle de modo de vista y caja de respuesta abajo.

En mobile el layout colapsa a una sola columna (dashboard arriba, chat abajo).

Chat: buscador local y vista por campana #

Dentro de cada conversacion hay dos herramientas para que no te pierdas en hilos largos:

• 🔍 Buscador local: con debounce de 180ms, filtra mensajes que contengan el texto en su contenido, asunto o nombre de la campana de origen. Si estas en modo "Por campana", los grupos con coincidencias se abren solos.
• 📅 Cronologico (default): todos los mensajes en orden de fecha, como un chat normal.
• 🗂 Por campana: agrupa los mensajes en acordeones plegables segun la campana que los origino. Los mensajes ad-hoc (que no vienen de campana) se agrupan en "💬 Mensajes directos". Cada grupo se ordena por ultima actividad y muestra el conteo de mensajes y la fecha del ultimo.

Cada burbuja de mensaje muestra arriba un pequeño badge naranja "📣 via {nombre-campana}" cuando el mensaje vino de una campana. Asi sabes el origen sin tener que cambiar de modo.

Imagenes estandarizadas #

Cuando vos o el cliente pegan/suben imagenes en una campana o un mensaje, Connexa las muestra con un tamaño maximo unificado (max 280px de alto, ancho proporcional, esquinas redondeadas, fondo blanco). Esto evita que una foto vertical de un celu rompa el layout del chat.

• Aplica al chat del admin, al inbox del cliente final, al preview de las campanas y a cualquier lugar donde se muestre HTML del mensaje.
• Click en la imagen la abre en una pestaña nueva en su tamaño original, por si necesitas verla en detalle.
• El cursor cambia a "zoom" al pasar por encima para sugerir que se puede ampliar.
• Funciona igual con videos cortos (mismo limite de altura).

Adjuntar fotos y audio en el chat #

El chat bidireccional admin↔cliente tiene la misma capacidad multimedia que la difusion rapida, pero en los dos lados:

• El admin abajo del textarea de respuesta tiene Adjuntar fotos + Manten para grabar.
• El cliente final, en el inbox de su PWA, tiene los mismos botones para responder con foto o con audio.
• Limites configurables por el dueño del comercio en Mensajeria.
• El boton Responder queda deshabilitado mientras se esta subiendo una foto o un audio — con un texto chico "Esperá a que termine de subir el adjunto..." debajo. Asi nadie envia un mensaje sin que el adjunto haya quedado guardado.
• Las fotos se renderizan como galeria (1 / 2 / grilla 3+ con +N) y los audios como un reproductor con duracion.
• Mensajes con solo adjuntos y sin texto son validos: aparecen como burbuja con la foto o el audio sin asunto.

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 #

Hoy hay 5 tipos de segmentacion disponibles en Campanas > Nueva:

• Todos los clientes activos: el universo entero del tenant.
• Registrados en el portal: solo clientes que aceptaron la invitacion y tienen cuenta CNXAUsuariosPortal activa. Es la audiencia real hoy — los demas no pueden ver el inbox ni recibir push.
• Por nivel: filtra por Silver / Gold / Platinum / Diamond.
• Seleccion manual: lista de clientes elegidos a mano. La pantalla muestra un selector con buscador (por nombre, email, documento, codigo externo) y multi-checkbox.
• Grupos: combinacion de grupos estaticos y dinamicos. Los grupos se gestionan en /admin/grupos.

Personalizacion con tokens #

El asunto y el contenido de la campana aceptan tokens entre llaves que se reemplazan automaticamente con los datos de cada cliente al enviar:

• {nombre}, {apellido}, {nombrecompleto}
• {email}
• {puntos} — saldo actual
• {nivel} — nombre del nivel
• {empresa} — nombre fantasia del comercio

Ejemplo: Hola {nombre}, te quedan {puntos} puntos — usalos antes de fin de mes! → cada cliente recibe un mensaje con sus propios datos.

Envio y medicion #

Cuando confirmas una campana se crea un Mensaje Inbox por cada cliente del segmento (con tokens reemplazados) y se dispara una notificacion push a todos los que tengan dispositivo registrado. Los que no aceptaron push igual reciben el mensaje en su inbox cuando entren al portal.

Despues del envio podes ver metricas: audiencia, entregados, leidos, tasa de apertura, ultimo error si lo hubo.

Duplicar una campana #

Una campana enviada queda inmutable como registro de lo que se envio. Para reusar el contenido tocas el boton Duplicar — disponible en la lista /admin/campanas y en el detalle. Crea una copia en estado Borrador con todo precargado (asunto, contenido, segmentacion, IDs manuales) que podes editar y enviar.

Como accede el cliente final #

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

1. Recibe un email del tenant con un link personalizado y un codigo QR. El asunto y header del email muestran el nombre fantasia del comercio.
2. Si esta leyendo desde la compu, escanea el QR con la camara del celu y abre el link directamente alli (la mejor experiencia es desde mobile).
3. Toca Activar mi cuenta. Llega a la pantalla de set-password en connexa.integraia.tech.
4. Define una contrasena minima de 6 caracteres y entra automaticamente al portal del cliente.
5. Aparece un banner naranja "Instala Connexa en tu celular". En Android lo instala con un toque (prompt nativo); en iPhone con Compartir > Agregar a pantalla de inicio.
6. Una vez instalada, abre la PWA desde el icono y queda listo para usar.

Portal web del cliente #

El portal web es responsivo y funciona en cualquier navegador. Tiene 5 secciones principales accesibles desde el menu:

• Inicio: dashboard con saldo de puntos, nivel actual, barra de progreso al siguiente nivel, recompensas disponibles, mensajes nuevos. Las cards Puntos actuales y Recompensas son clickables y llevan a las secciones correspondientes.
• Recompensas: catalogo de premios disponibles para canjear (filtrado por vigencia, nivel minimo y stock).
• Movimientos: historial completo de puntos — ganados, canjeados, ajustes, expirados — con paginacion. Saldo destacado arriba.
• Inbox: mensajes personalizados recibidos del comercio. Permite responder al admin.
• Mi perfil (en el menu del usuario): editar email, telefono, cambiar contrasena, dar de baja la cuenta.

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 — no compite con el navegador.
• Notificaciones push (si el cliente las autoriza desde Inbox > "🔔 Activar"). Llegan aunque la PWA este cerrada y el celu en standby.
• Funciona con mala conexion gracias al cache del service worker.
• Arranque rapido, sin barra de URL ni pestanas del navegador.
• Menu hamburguesa que se repliega automaticamente al elegir una opcion (mejor UX en pantallas chicas).

El banner naranja de instalacion aparece automaticamente la primera vez que el cliente entra al portal desde el celu — y se vuelve a mostrar cada 3 dias si no instalo. Cuando el cliente toca Instalar (Android) o sigue las instrucciones (iOS), el banner desaparece para siempre.

📱 Guia de instalacion paso a paso (wizard) #

Para que ningun cliente quede con cara de "¿y como hago?", Connexa tiene una pagina dedicada de guia visual: connexa.integraia.tech/portal/instalar. La pagina no requiere login, asi que se puede compartir abiertamente.

El wizard:

• Detecta automaticamente si el cliente esta en iPhone, iPad, Android o computadora (a partir del User-Agent).
• Tiene tabs para que el cliente pueda elegir manualmente otra plataforma.
• En iOS muestra 4 pasos visuales con SVGs ilustrativos: usar Safari, tocar Compartir, elegir "Agregar a pantalla de inicio", confirmar.
• En Android muestra 3 pasos: usar Chrome, tocar el menu de los 3 puntos, elegir "Instalar app".
• En computadora muestra un QR grande con la URL del wizard, para que el cliente lo escanee con el celu y abra la guia ya en mobile (que es donde tiene que instalar).

Donde el cliente encuentra la guia:

• En el banner naranja del portal, ahora con un link "Ver guia paso a paso →".
• En Configuracion del portal, en una card destacada con borde coral.
• En el pie de los emails de Connexa: el de invitacion siempre lleva el bloque, el de reset de contraseña lo lleva solo si todavia no entro al portal.

Canjear una recompensa #

1. El cliente abre la PWA o portal y va a Recompensas.
2. Elige la recompensa que quiere canjear — cada card muestra costo en puntos, nivel minimo (si aplica) y stock disponible.
3. El boton Canjear esta habilitado solo si tiene puntos suficientes y cumple el nivel. Si no, el boton dice Faltan puntos o Nivel insuficiente.
4. Toca Canjear. Aparece un modal de confirmacion: "Vas a usar X puntos. Te quedan Y."
5. Confirma. El sistema descuenta los puntos, descuenta stock si corresponde y genera un canje en estado Pendiente.
6. El cliente ve un modal grande con un codigo alfanumerico de 8 caracteres (sin caracteres ambiguos como 0/O o 1/I) para mostrar en el local.
7. Abajo, en Mis canjes, queda registrado con estado y fecha de vencimiento.
8. El operador del local valida el codigo desde /canjes/validar y marca el canje como Validado.

Mi perfil — editar datos y baja #

Desde el menu del usuario (esquina superior derecha) el cliente accede a Mi perfil con tres secciones:

• Mis datos: nombre, apellido y documento son de solo lectura (si necesita cambiarlos, contacta al comercio). Email y telefono se editan inline — el sistema valida que el email no este usado por otro cliente.
• Cambiar contrasena: requiere ingresar la actual + nueva (min 6) + confirmacion. Si la contrasena actual no coincide, muestra error.
• Dar de baja la cuenta: el cliente puede cerrar su cuenta del programa. Pide la contrasena actual para confirmar. Al darse de baja: pierde el acceso al portal, dejan de llegarle notificaciones y mensajes, pero el historial de puntos y compras se mantiene en el comercio.

Connexa Admin: PWA mobile-first #

El back-office de Connexa esta pensado para funcionar igual en una compu como en un celular. En el celu se instala como una PWA propia (distinta de la del cliente final) para que el vendedor lo abra como cualquier app del SO.

Instalar Connexa Admin #

iPhone (Safari):

1. Entrar a https://connexa.integraia.tech/admin/dashboard con Safari.
2. Iniciar sesion como admin.
3. Tocar Compartir (cuadrado con flecha hacia arriba).
4. Bajar y elegir Anadir a pantalla de inicio.
5. Aparece el icono Cnxa Admin en el home.
6. Cerrar Safari y abrir desde ese icono.

Android (Chrome):

1. Entrar a la misma URL en Chrome y loguearse.
2. Chrome ofrece "Instalar app" (cartelito o menu ⋮).
3. Confirmar.

Bottom nav mobile #

Cuando entras al admin desde un celu (pantalla ≤ 768px), aparece una barra inferior fija con 4 botones:

• 📨 Difusion — abre Difusion rapida directo. Es el caso de uso mas frecuente del vendedor.
• 💬 Chats — abre la bandeja de conversaciones. Tiene un puntito rojo con el numero de mensajes nuevos no leidos.
• 👥 Clientes — abre la lista de clientes.
• ☰ Mas — abre el menu lateral con todo lo demas (recompensas, niveles, reglas, sucursales, administracion, etc).

El menu lateral en mobile aparece como un drawer encima del contenido. Tocando fuera del drawer (overlay oscuro) o eligiendo cualquier item se cierra automaticamente.

En desktop la barra inferior no aparece — el menu lateral fijo de la izquierda hace el mismo trabajo con mas espacio.

Login diferenciado: admin vs cliente #

Las pantallas de login del admin y del cliente final comparten la marca CONNEXA pero se diferencian visualmente para que de un vistazo sepas a cual estas entrando:

• Login admin (/login): cintillo superior 🏬 Panel del comercio, icono maletin 💼, acento pizarra (#2D3142) en borde, subtitulo y boton. Fondo gris-azulado.
• Login cliente (/portal/login): cintillo 🎁 Mi espacio, estrella ⭐, acento coral (#FF8C5A) — paleta Sunrise original. Fondo coral calido.

Configuracion de empresa #

Desde Administracion > Empresa (acceso solo para roles ConnexaOwner y SuperAdmin) podes editar los datos generales y fiscales del tenant. Los cambios se sincronizan con el Portal de Licencias de IntegraIA.

• Datos generales:
  • Nombre fantasia / Marca: lo que ven los clientes en el portal, en los emails de invitacion (header y subject) y en las notificaciones push. Si lo dejas vacio se usa el Nombre.
  • Nombre: razon social o nombre legal de la empresa.
  • Contacto, email, telefono, sitio web, direccion.
  • Company ID y Estado: de solo lectura.
• Datos fiscales: pais, tipo de identificacion fiscal, identificacion fiscal, razon social, domicilio fiscal. En Argentina, hay un boton Buscar en ARCA que trae automaticamente razon social y domicilio del padron oficial cuando ingresas un CUIT valido.
• Datos operativos: zona horaria (configurada al alta, modificable solo por soporte).
• Notificaciones push:
  • Titulo por defecto: aparece en el push del cliente cuando la campana no tiene asunto propio (ej: "Kosiuko · Novedades").
  • Cuerpo por defecto: idem, cuando la campana no tiene contenido. Si la campana tiene contenido, se usa el preview de ese contenido.

Configuracion de mensajeria #

En Mas > Administracion > Mensajeria (acceso solo para ConnexaOwner y SuperAdmin) se definen los limites para los adjuntos en difusion rapida y conversaciones. Aplican a todos los usuarios del comercio.

Hay un boton Restaurar valores por defecto abajo que vuelve todo a los originales si te fuiste de mambo cambiando los limites.

Grupos de clientes: Anular vs Eliminar #

En Comunicacion > Grupos de clientes tenes los grupos (estaticos manuales y dinamicos por filtro). Al editar un grupo existente, en el modal hay tres acciones distintas:

• Anular (gris): es el "Eliminar" de antes — soft delete. El grupo queda con IsActive=false, deja de aparecer al armar nuevas difusiones, pero se conserva en el historial. La card en la lista se muestra grisada con texto tachado y etiqueta ⊘ ANULADO. Reversible: el mismo modal te ofrece Reactivar.
• Eliminar... (rojo): borrado fisico real. Antes de aceptar, valida:
  • Si es estatico, no debe tener ningun cliente adentro (sacar miembros primero).
  • El grupo no debe aparecer referenciado en ninguna difusion historica (CNXACampanas).
  Si alguna validacion falla, te lo dice con el motivo y la cantidad. Sino, lo borra de verdad.
• Cancelar: cierra el modal sin cambios.

Zona peligrosa #

Al final de la pantalla Administracion > Empresa hay una seccion Zona peligrosa con tres acciones destructivas. Esta visible solo para ConnexaOwner y SuperAdmin. Las tres acciones piden escribir el nombre exacto de la empresa para confirmar; el boton de confirmacion se ilumina en tiempo real cuando lo que tipeas coincide.

Limpiar datos transaccionales #

Es una solicitud a IntegraIA para borrar transacciones, canjes, puntos, mensajes y campanas, conservando empresa, catalogo, niveles, reglas y recompensas. Util cuando termina un ciclo de prueba largo y queres arrancar las metricas en cero pero conservar la configuracion del programa.

1. Escribi el motivo de la solicitud en el textarea (obligatorio).
2. Hace clic en Solicitar limpieza.
3. Confirma escribiendo el nombre exacto de la empresa.
4. IntegraIA recibe un email automatico y procesa la solicitud manualmente.

Mientras la solicitud este Pendiente o En proceso, los demas botones de la zona peligrosa quedan bloqueados. Podes cancelar la solicitud desde la misma pantalla mientras IntegraIA no la haya completado.

Limpiar base de clientes (accion directa) #

A diferencia de las otras dos, esta accion no es una solicitud: se ejecuta inmediatamente. Borra toda la base de clientes y todo lo que cuelga de ellos en una transaccion atomica:

• Clientes y sus usuarios del portal.
• Transacciones (con sus items).
• Canjes, puntos acumulados, acumuladores por ventana.
• Invitaciones y dispositivos registrados (suscripciones push).
• Mensajes inbox y conversaciones bidireccionales.
• Campanas (porque ya no tienen audiencia).
• Grupos de clientes (estaticos y dinamicos) con sus miembros.
• Historial de imports / staging (CSV, Excel, JSON, API push).

Se conservan articulos, niveles, reglas de puntaje, recompensas, sucursales, branding y la configuracion de la empresa.

Mientras se ejecuta, vas a ver una barra de progreso paso a paso con los doce puntos del proceso (staging, items, transacciones, movimientos, acumuladores, canjes, mensajes, campanas, grupos, dispositivos/invitaciones/portal, clientes, confirmar transaccion). Al terminar aparece un resumen verde con el conteo de cada categoria eliminada. IntegraIA recibe automaticamente un email con los detalles de la limpieza para fines de auditoria.

Solicitar eliminacion de la empresa #

Es una solicitud a IntegraIA para dar de baja la empresa por completo: todos los datos operativos, usuarios del back-office, licencia y acceso al portal. Una vez procesada, no se puede recuperar.

1. Escribi el motivo de la solicitud en el textarea (obligatorio).
2. Hace clic en Solicitar eliminacion.
3. Confirma escribiendo el nombre exacto de la empresa.
4. IntegraIA recibe un email automatico, valida el contexto y procesa la baja manualmente.

Al igual que la limpieza de transaccionales, podes cancelar la solicitud mientras este Pendiente o En proceso.

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.