KUTSUYA
Bot de Telegram para dos operadores: registrar ventas en clicks desde donde sea, en menos de 30 segundos.
Conocer al cliente. Quién es la marca y a quién le vende.
// El cliente
Kutsuya es una tienda de sneakers en México que mueve pares por Instagram, entre fundador y socio. La operación entera vive en sus celulares — a veces desktop — y registrar cada venta en el Sheet, campo por campo, comía minutos. Construimos un bot de Telegram donde casi todo es un click: tallas, marcas, condición, status y compradores recurrentes salen como botones. Solo el precio se escribe. El Sheet del cliente se actualiza solo, igual desde el celular del fundador, el desktop del socio o un Telegram abierto en otra ciudad.
Lo que venían a resolver, contado sin tecnicismos.
// Reto
- 01Dos operadores — fundador y socio — registrando desde donde estén, en cualquier dispositivo.
- 02Cada operación tiene 8+ campos: marca, modelo, talla, condición, costo, precio, comprador, status.
- 03Escribir todo a mano en el Sheet — mobile o desktop — comía minutos por cada venta.
- 04Riesgo de pisar cambios cuando ambos editaban la misma fila al mismo tiempo.
Qué cambió entre el primer día y el lanzamiento.
// El antes y el después
CAPTURA MANUAL EN SHEET
- Buscar la fila correcta y escribir 8+ campos a mano
- Solo una persona a la vez sin pisar cambios
- Lento en el celular, igual de lento en el desktop
- Mismo flujo cada vez, sin atajos
CLICKS EN TELEGRAM
- Tallas, marcas, condición y status como botones
- Compradores recurrentes listos para un click
- Solo precio y nombres nuevos se escriben
- Fundador y socio operan en paralelo, sin conflictos
Cada feature pensada para que el cliente cierre la operación.
// Lo que construimos
Clicks en vez de teclado
Tallas, marcas, condición del par, status del pedido y compradores recurrentes salen como botones en el chat. Solo el precio y los compradores nuevos se escriben. Una venta cierra en menos de 30 segundos, contra varios minutos llenando el Sheet a mano.
- Inline keyboards para tallas, marcas, condición y status
- Compradores recurrentes precargados; opción para uno nuevo
- Solo precio (y nombres nuevos) requieren teclado
- Validación campo por campo: no avanzas si falta info
Dos operadores, un solo Sheet
Fundador y socio operan el bot desde sus propios dispositivos al mismo tiempo. Whitelist por chat_id, escritura serializada al Sheet — ambos ven la misma verdad sin pisar cambios.
- Whitelist por chat_id para los dos operadores
- Cada operación queda firmada con su autor
- Cero conflictos de escritura al Sheet
- Mismo flujo en mobile y desktop
Cada par con su propio timeline
Cada zapato tiene su ciclo de vida visible: compra → en camino → en bodega → vendido. Cambias estado con un click en el botón correspondiente y el Sheet refleja el cambio al instante.
- Botones para mover entre status del flujo
- Histórico de cambios por par
- Filtra por status desde el Sheet
- Visibilidad por talla y modelo
El Sheet sigue siendo del cliente
La fuente de datos es Google Sheets, no nuestra base de datos. El bot escribe, los operadores abren la hoja desde cualquier navegador y leen, filtran o exportan sin depender del bot. Si Telegram se cae, los datos siguen ahí.
- Google Sheets como única fuente de verdad
- Acceso desde cualquier navegador
- Exportable a CSV o Excel cuando quieras
- Cero dependencia del bot para leer datos
Nuestros cinco pasos aplicados a este proyecto real.
// Proceso
- 01Sem 1
Descubrimiento
Sesión con fundador y socio: cómo registran hoy, qué campos llenan, qué tallas y marcas manejan, quiénes son los compradores recurrentes. El mapa que después se convierte en botones.
- Mapa del Sheet actual
- Catálogos del cliente: tallas, marcas, compradores
- 02Sem 1
Diseño conversacional + presets
Mapeamos los catálogos del cliente (tallas, marcas, condición, status, compradores recurrentes) y los volvemos inline keyboards de Telegram. Para cada operación, definimos qué campos son click y cuáles requieren teclado.
- Mapa de comandos + presets
- Layouts de inline keyboards por operación
- 03Sem 2
Construcción
Implementación con python-telegram-bot. Cada comando con su ConversationHandler e inline keyboards precargados. Whitelist por chat_id para fundador y socio. Escritura serializada al Sheet vía gspread.
- Bot funcional en staging
- Sheet conectado por Service Account
- 04Sem 3
Lanzamiento
Deploy en Railway con polling. Acompañamos a fundador y socio la primera semana de uso real y ajustamos los presets (compradores recurrentes que faltaban, tallas no contempladas) según fricciones que aparecen en operación.
- Bot en producción para los dos operadores
- Manual conversacional + atajos comunes
- 05Sem 3+
Escala
Con datos reales de tres semanas, sumamos atajos para operaciones repetidas (combinaciones marca+modelo más vendidas) y un reporte semanal por chat con utilidad por par y rotación.
- Comandos /resumen y /stock
- Reporte semanal automático
- 01Sem 1
Descubrimiento
Sesión con fundador y socio: cómo registran hoy, qué campos llenan, qué tallas y marcas manejan, quiénes son los compradores recurrentes. El mapa que después se convierte en botones.
- Mapa del Sheet actual
- Catálogos del cliente: tallas, marcas, compradores
- 02Sem 1
Diseño conversacional + presets
Mapeamos los catálogos del cliente (tallas, marcas, condición, status, compradores recurrentes) y los volvemos inline keyboards de Telegram. Para cada operación, definimos qué campos son click y cuáles requieren teclado.
- Mapa de comandos + presets
- Layouts de inline keyboards por operación
- 03Sem 2
Construcción
Implementación con python-telegram-bot. Cada comando con su ConversationHandler e inline keyboards precargados. Whitelist por chat_id para fundador y socio. Escritura serializada al Sheet vía gspread.
- Bot funcional en staging
- Sheet conectado por Service Account
- 04Sem 3
Lanzamiento
Deploy en Railway con polling. Acompañamos a fundador y socio la primera semana de uso real y ajustamos los presets (compradores recurrentes que faltaban, tallas no contempladas) según fricciones que aparecen en operación.
- Bot en producción para los dos operadores
- Manual conversacional + atajos comunes
- 05Sem 3+
Escala
Con datos reales de tres semanas, sumamos atajos para operaciones repetidas (combinaciones marca+modelo más vendidas) y un reporte semanal por chat con utilidad por par y rotación.
- Comandos /resumen y /stock
- Reporte semanal automático
Los números que dejó el proyecto en producción.
// Qué cambió
Una venta o compra cierra en menos de medio minuto, contra varios minutos llenando filas a mano.
Talla, marca, condición, status y compradores recurrentes son botones. Solo precio y nombres nuevos se escriben.
Ambos registran al mismo tiempo desde sus dispositivos. La escritura se serializa y el Sheet siempre queda consistente.
El bot retiene la operación hasta que todos los campos críticos estén llenos. Cero filas a medias en el Sheet.
Capturas del sitio en producción.
// Cómo se ve
Las tecnologías que sostienen la operación.
// Tecnologías
- Python 3.11
- python-telegram-bot
- InlineKeyboardMarkup
- Google Sheets API
- gspread
- Service Account
- Railway
- Whitelist por chat_id
- Logging estructurado
¿Algo así para tu negocio?
Si este case te hizo click, hablamos. Te respondemos en menos de 24 horas hábiles, sin compromiso.