Ejemplo: una Telegram Mini App que reparte los gastos del grupo dentro del chat

Esta es la Mini App que uso cuando el grupo ya existe y el dolor es una hoja. Un viaje a la montaña. Cuatro en un piso de alquiler. Un equipo pequeño que reparte una cena de cliente. Alguien siempre paga, alguien siempre «lo envía luego», y ese luego vive en un Google Sheet que nadie abre.

Herramientas como Settler y Fracti ya probaron la forma: registrar el gasto en el grupo (texto, voz u hoja), mostrar saldos en una Mini App, saldar con un tap. No reconstruiría su parser de voz con IA el día uno. Reconstruiría el libro y el botón de saldar. Eso es el producto.

1. El recorrido del usuario en este ejemplo

El espacio de trabajo es el grupo. Nadie crea una cuenta «Alpes 2026». Añaden el bot, abren la Mini App desde el menú - y el libro ya es este chat.

• Alguien añade el bot al grupo. El bot pide ver miembros para que la lista del reparto sean las personas del chat - no un formulario de emails.
• Olena pagó 2400 UAH por la cabaña. Abre la Mini App, importe, título, quién entra. MainButton = guardar. Háptica si se guarda bien. El bot publica un recibo de una línea en el grupo para que los demás aún no abran la app.
• Cualquiera abre la Mini App después y ve «Andriy debe 600 a Olena». No una matriz. Un grafo simplificado. Un botón «saldar» por arista.
• Saldar: marcar pagado (confianza), enviar una factura Telegram / Stars, o TON si el grupo ya mueve dinero así. El bot anuncia «saldado» en el grupo. La arista desaparece.

2. Por qué la Mini App, no solo un bot

Un bot de texto puede registrar «/paid 2400 cabaña». No puede mostrar un reparto justo con excepciones, editar la cena de anoche ni dejar que Andriy le pague a Olena de un tap sin un hilo de comandos. El chat sigue siendo el inbox. La hoja sigue siendo la UI.

• Opcional: una mención en el grupo - «@splitbot pagué 50 de la cena» - crea un borrador. Confirmar en la Mini App. Así Fracti se siente magia. Así también salen filas basura si se salta la confirmación.
• `chat_instance` es la clave primaria. Dos grupos con la misma gente son dos libros. No los fusione porque coinciden los user id.

3. Qué construiría primero (y qué no)

Una primera versión es una calculadora con chat. No es Splitwise con bancos e informes fiscales.

• Construir primero: añadir gasto, reparto igual, excluir a una persona, simplificar deudas, marcar saldado, recibo del bot en el grupo, HMAC en cada escritura.
• Después: un raíl de cobro que el grupo ya usa. En Ucrania suele ser una factura Mono o «lo envié, toca para confirmar». Stars si los importes son pequeños y digitales. TON solo si ya hay wallets en el grupo.
• No primero: OCR de tickets arrugados, NLP de voz, plantillas de alquiler, cinco divisas con FX en vivo, un perfil público. Eso es el mes dos si el primer libro se usa dos veces.

4. Los dos bugs que matan una app de reparto

Las matemáticas mal y la gente que falta. El resto es pulido.

• Simplifique deudas con un paso min-cash-flow, luego un número por par. Si muestra una matriz NxN cruda, la gente la captura a otra hoja.
• Quien sale del grupo se queda en los gastos viejos y cae de los nuevos. Instantánea de miembros en cada fila. No recalcule la historia contra la lista de esta noche.

Una Mini App de reparto es un libro, el grupo es la habitación

Construiría esto para un club de viajes, un coliving, una agencia pequeña o cualquier grupo de Telegram al estilo WhatsApp que ya discute por dinero. Hoja Next.js, libro en Postgres con clave `chat_instance`, un bot que solo publica recibos y avisos de cobro, un raíl de pago. Si ese es su grupo - escriba por el formulario. Acotamos una primera versión que registre una cena de verdad este mes, no una IA que alucine quién se comió la pizza.