01 En prueba
Agente en Ninjo
Atiende el WhatsApp de la feria en voseo, con las dos sedes, el catálogo por país y el sorteo de Axion Energy.
Semana Motor Connect
Propuesta técnica · Semana Motor 24 y 25 de octubre
Del QR al lead,
sin perder un dato.
La parte técnica de Semana Motor Connect: el agente de WhatsApp en Ninjo, el flujo completo de cada conversación, una API propia con su base de datos y una consola web para consultar y exportar los leads. El agente ya registra cada escaneo y cada email en la base, y la consola ya está en línea.
- 2sedes, 4 países
- 3.000conversaciones previstas
- 0apps o formularios
- USD 2.000toda la parte técnica
01
Qué incluye
Cuatro piezas que funcionan juntas, con un solo responsable técnico. El circuito completo ya funciona de punta a punta.
02 Conectado
Flujo del agente
Del QR a la respuesta con texto y audio, el registro del escaneo en la base, la conversación y el pedido de email.
03 En producción
API y base de datos
Servicio propio que recibe cada escaneo y cada email desde Ninjo, sin duplicar y con historial completo.
04 En producción
Consola de leads
Web privada para buscar, filtrar, ver el recorrido de cada visitante y exportar la base a CSV.
02
Arquitectura
Cada pieza hace una sola cosa. Si una se demora, el visitante igual recibe su respuesta.
-
Tótem con QR
Un código por vehículo. Abre WhatsApp con el mensaje escrito.
-
WhatsApp
Con el dato del propio visitante. Nada que instalar.
-
Ninjo
Disparador por vehículo, agente de IA y webhooks hacia la API.
-
API Semana Motor
Recibe escaneos y emails con clave. Normaliza y valida.
-
Base de datos
Un lead por teléfono, una columna por vehículo y el historial.
-
Consola y CSV
Búsqueda, filtros, estadísticas y exportación por marca.
AgenteNinjoWhatsApp Business, disparadores por palabra clave, IA
APIPython · FastAPIContenedor Docker, HTTPS con Caddy
BaseSQLiteModo WAL, volumen propio, exportación CSV
ConsolaSvelteKitServidor propio, la clave de la API nunca llega al navegador
03
El flujo, paso a paso
Lo que ve el visitante a la izquierda. Lo que pasa en el sistema a la derecha. Tocá cada paso.
Quiero saber más sobre el Mercedes-Benz 300 SL (SM01)
Paso 1 de 6
Escanea el QR del vehículo
Cada QR abre WhatsApp con un mensaje ya escrito que incluye el código del vehículo. Al enviarlo, el teléfono queda capturado: no hay formulario ni app.
Link del QR
https://wa.me/<número>?text=Quiero saber más sobre el Mercedes-Benz 300 SL (SM01)
Ficha del lead en la base
- Teléfono
- —
- Vehículos
- —
- Escaneos
- —
- —
04
El agente en Ninjo
Respuesta automática con texto y audio para el primer contacto de cada QR. Agente de IA para todo lo demás, con reglas pensadas para una feria al aire libre.
Bienvenida una sola vez
Siempre en un mensaje aparte, con el video de la feria y la firma "Powered by: deache.io". Si la respuesta automática ya la envió, el agente sigue desde ahí y no la repite.
Código borrado
Si el visitante borra el código del QR antes de enviar, el agente reconoce el vehículo por el texto y agrega una línea "Ref. SM01", así el escaneo igual se registra.
Otro QR
Habla del vehículo nuevo sin volver a presentarse. Si falta el email, recuerda el sorteo en una línea.
El mismo QR otra vez
Nunca dice "ya lo viste": da otros datos del vehículo y vuelve a compartir el link.
Sin QR
Si escribe "hola", da la bienvenida y pregunta qué marca le interesa o en qué sede está.
Sorteo de Axion Energy
Invitación en la primera respuesta y como máximo un recordatorio. Valida el formato del email y lo repite para confirmarlo.
Registro en la base
Guarda el código del vehículo y el email en propiedades del contacto (semanamotor_vehiculo, semanamotor_email). Cada cambio dispara un webhook a la API.
Lo que no hace
No pide DNI ni dirección, no da precios ni inventa datos técnicos, horarios o recorridos: deriva al stand de información.
Voseo rioplatenseTono cálido y breve, de alguien del staff que sabe de autos.
1 a 3 frasesPor mensaje, en hasta 3 burbujas, como escribe una persona.
2 a 6 segundosDe demora natural antes de cada respuesta.
Sin canales hasta probarEl agente BETA se conecta al número recién al cerrar las pruebas.
05
API y base de datos
En producción en semanamotor.api.lacar.dev. Todas las rutas piden la
clave en el encabezado X-API-Key.
| Método | Ruta | Qué hace |
|---|---|---|
| POST | /api/leads | Registra un escaneo y/o un email para un teléfono. Idempotente. |
| GET | /api/leads | Lista con búsqueda, filtros por vehículo, email y fechas, orden y paginado. |
| GET | /api/leads/{phone} | Un lead con sus vehículos y el historial de eventos. |
| GET | /api/leads/export.csv | Exportación, con los mismos filtros. Una columna por vehículo. |
| GET | /api/stats | Totales, leads por vehículo, por día y escaneos por hora. |
| GET | /api/vehicles | Catálogo de vehículos y sus códigos. |
Modelo de datos
leads
phoneclave, solo dígitos emailel primero válido created_at · updated_atUTC sm01 · sm02 · …0/1, una por vehículoevents
phonea quién typescan o email valuecódigo o email created_atcuándo- El teléfono es el identificador: se normaliza a dígitos, así "+54 9 (11) 1234-5678" y "5491112345678" son la misma persona.
- Repetir un escaneo no duplica el lead. Cada escaneo igual queda en el historial, para medir recorridos.
- El primer email válido queda guardado. Un email mal escrito no hace perder el escaneo.
- Los campos vacíos que manda Ninjo se toman como "no enviado".
- Un código de vehículo desconocido se rechaza sin guardar nada.
- Agregar un vehículo es editar una lista: la base suma su columna sola, sin perder datos.
06
Consola de leads
En este mismo sitio, con usuario y contraseña. Los datos se leen en vivo de la API.
- Indicadores: leads, emails para el sorteo, escaneos y escaneos por lead.
- Leads por vehículo y escaneos por hora, para ver qué atrae y cuándo.
- Búsqueda por teléfono o email, con resultados al tipear.
- Filtros por país y sede, vehículo, con o sin email y rango de fechas.
- Ficha de cada visitante con su recorrido completo y acceso directo a WhatsApp.
- Exportación a CSV de la base completa o filtrada, lista para cada marca.
07
Qué está hecho y qué falta
Lo pendiente depende en buena parte del contenido final y de la habilitación de WhatsApp Business.
Hecho
- Agente BETA en Ninjo con las instrucciones completas de la feria: sedes, catálogo, sorteo y reglas.
- Primer disparador por vehículo (SM01) con su respuesta de bienvenida armada.
- Integración de Ninjo con la API: el agente guarda el vehículo y el email como propiedades del contacto, y cada cambio dispara un webhook con clave que los registra en la base.
- API publicada con HTTPS en semanamotor.api.lacar.dev, con clave de acceso.
- Base de datos con leads, historial de eventos y columnas por vehículo.
- 30 pruebas automáticas sobre la API: duplicados, emails, teléfonos, filtros y exportación.
- Consola de leads con usuario y contraseña, filtros, ficha por visitante y CSV.
Pendiente
- Un disparador por vehículo con su texto y su audio, con el catálogo final de ADEFA.
- Catálogo final de vehículos cargado en la API, con los mismos códigos que los disparadores.
- Pasar los webhooks del modo prueba (teléfono fijo) al número real de cada contacto.
- Videos de bienvenida y por vehículo: definir si van como link o como envío posterior.
- Número de WhatsApp Business conectado y método de pago de Meta activo.
- QR por vehículo con su mensaje armado, listos para imprenta.
- Prueba de carga, prueba de todas las combinaciones y copias de seguridad automáticas de la base.
08
Responsabilidad técnica e inversión
Tomamos toda la responsabilidad técnica del proyecto, de punta a punta: un solo equipo a cargo y una sola persona a quien llamar si algo falla.
Qué queda a nuestro cargo
- Agente en Ninjo: instrucciones, disparadores por vehículo, respuestas con texto y audio, propiedades y webhooks.
- API y base de datos: registro de cada escaneo y cada email, sin duplicados y con historial.
- Consola de leads con acceso privado, estadísticas y exportación de la base por marca.
- Servidor, dominios, certificados de seguridad y copias de la base.
- Pruebas de todas las combinaciones y prueba de carga antes de salir en vivo.
- Monitoreo y soporte técnico durante el lanzamiento suave y los dos días de feria.
- Entrega de la base final y reporte técnico al cierre.
Inversión total USD 2.000
Toda la parte técnica: lo que ya está hecho, lo que falta y la operación durante la feria.
09
Calendario hasta la feria
Alineado con el plan de la propuesta comercial: primero el contenido, después las pruebas, recién entonces en vivo.
- Hasta el 5 oct Contenido cerrado
Catálogo final, textos y audios por vehículo, videos.
- 6 al 16 oct Construcción
Disparadores por vehículo, conexión de Ninjo con la API, QRs y pruebas de cada combinación.
- 17 al 19 oct Prueba de carga
Simulación de cientos de conversaciones en paralelo y congelamiento de cambios.
- 20 al 23 oct Lanzamiento suave
En vivo con los eventos de promoción en la Ciudad. Ajustes finos.
- 24 y 25 oct Feria en vivo
Monitoreo durante toda la jornada y consola abierta para el equipo.
- Hasta el 28 oct Cierre
Base exportada por marca y reporte final.
10
Seguridad y operación
Datos de miles de visitantes. Se tratan con cuidado desde el primer día.
Clave en cada llamada
Ninjo se identifica con una clave secreta. Sin clave configurada, la API rechaza todo.
Datos personales cuidados
En los registros del servidor el teléfono aparece enmascarado: solo los últimos 4 dígitos.
Consola privada
Usuario y contraseña, sesión firmada que vence a las 12 horas y freno a los intentos repetidos.
Fuera de buscadores
Ni la consola ni la propuesta se indexan. Todo viaja cifrado por HTTPS.
Carga sin sobresaltos
3.000 conversaciones en dos días es una carga baja para esta base: escribe miles de registros por minuto.
Base en un solo lugar
Un archivo de base en el servidor, con volumen propio y exportable en cualquier momento.
Semana Motor Connect
Cada escaneo,
un lead con nombre.
Toda la responsabilidad técnica, por USD 2.000.