Ruta(s): transversal. Afecta a /, /rag y /rag/<sector>, /productos/<slug>, /services, /contact, /solicitar-demo, /privacy y /terms; en la Fase 5 suma /casos/<slug>, /blog y /en/*; en el panel, Admin › Leads y Admin › Métricas · Archivos principales: apps/web/src/components/seo/StructuredData.tsx, apps/web/src/lib/seo-config.ts, apps/web/src/app/{layout.tsx,sitemap.ts}, apps/web/public/{robots.txt,llms.txt}, apps/web/middleware.ts, apps/web/next.config.js, apps/web/src/lib/services-catalog.ts, apps/web/src/lib/{site,rag-plans}.ts (rama rag-reposicionamiento), apps/web/src/lib/company.ts (nuevo), apps/backend/src/models/{Contact,Quote}.ts, apps/backend/src/services/{email,whatsapp}.service.ts · Prioridad: P0 · Esfuerzo total: XL (≈ 45 días-dev, de los cuales ≈ 24 van en la Fase 1; ≈ 25 días de trabajo del dueño; más un contador y un abogado externos)

Importante: esta página es un plan de negocio. Los puntos tributarios y legales sirven para preparar la conversación con el contador y con un abogado, pero no reemplazan su concepto. Todo lo marcado como "validar" se cierra en el registro de decisiones, con fecha y responsable.

Captura de producción (rama main), antes del reposicionamiento RAG. Las cifras del hero son el ejemplo más visible del problema de prueba social que resuelve esta página. Páginas relacionadas: Flujo del cliente, Sistema de demos, Panel de administración, Legal, Servicios y precios, Landings SEO y de campaña, Contacto, Nosotros, Roadmap.

Las demás páginas de la wiki describen pantallas. Esta describe cómo se vende: a quién, con qué mensaje y con qué prueba; cómo se mide cada lead desde el anuncio hasta el pago; cómo se le hace seguimiento; cómo se cobra y se factura de forma legal, y bajo qué contratos. Tiene que lograr cinco cosas:

1. Un mensaje claro por segmento. El producto principal son los sistemas RAG. Las otras soluciones a medida son la segunda línea. Nadie debe salir del sitio sin entender qué vende KopTup.
2. Medir cada lead de punta a punta: fuente → lead → llamada → propuesta → cliente → cobro. La medición respeta el consentimiento (Ley 1581 de 2012).
3. Un proceso comercial repetible: etapas del pipeline con definiciones, agenda real, WhatsApp Business, secuencias de email y una rutina semanal que el dueño pueda delegar a un comercial (sales).
4. Poder cobrar y facturar sin riesgos: facturación electrónica DIAN, pasarela de pagos, contratos tipo, SLA y política de datos.
5. Prueba social honesta: cero cifras sin fuente y casos reales con autorización escrita.

La evidencia es de la rama main. Cuando la rama rag-reposicionamiento ya corrige algo, se indica.

Hoy el mismo producto tiene un precio en /services, otro en el panel admin y otro en la especificación RAG. La sección 13 fija la regla de una sola fuente de precios.

1. El sitio dice dos cosas a la vez. main vende "software a medida" en general y la rama RAG vende sistemas RAG. Hasta fusionar la rama, la pauta pagaría clics para un mensaje que el sitio no sostiene.
2. La prueba social no se puede defender. "100+ proyectos", "50+ clientes", "5★", reseñas en el JSON-LD sin reseñas reales, porcentajes de mejora sin fuente y un año de fundación contradictorio. Es un riesgo de publicidad engañosa (Ley 1480 de 2011, vigilada por la SIC) y le quita credibilidad al resto del sitio.
3. No hay medición. Sin analítica ni UTM no se sabe qué canal trae clientes. Además, la medición que viene en la rama debe cargarse solo con consentimiento.
4. Cada lead se pierde entre canales. El formulario de contacto, WhatsApp y el email no confluyen en un registro con etapa, responsable y próxima acción. El modelo Lead del Sistema de demos lo resuelve, pero su pantalla llega en el hito 1b; hace falta una solución puente.
5. "Agendar llamada" es un mailto:. Es el CTA de mayor intención del sitio y no tiene agenda detrás.
6. No hay seguimiento automático del lead principal. El sistema de demos define secuencias para los accesos a demos, pero no para "Prueba con tu documento", que es el imán principal del camino RAG.
7. El email no está listo para enviar comunicaciones comerciales: no hay proveedor transaccional, autenticación del dominio (SPF, DKIM y DMARC) ni baja con un clic.
8. No se puede cobrar en línea. No hay pasarela, la suscripción no tiene cobro recurrente y Stripe, previsto para USD, puede no estar disponible para una empresa constituida en Colombia (ver sección 14).
9. La facturación electrónica de la propia KopTup no está resuelta en el producto. El portal muestra documentos de cobro, no facturas electrónicas.
10. Los contratos no protegen el modelo de "productos base". En Colombia, en una obra por encargo se presume que los derechos patrimoniales pasan al cliente salvo pacto en contrario (validar). Si el contrato no reserva de forma explícita los productos base, KopTup podría perder el derecho a reutilizarlos.
11. No hay SLA definido para los planes RAG con mensualidad, aunque el plan Profesional promete "soporte prioritario".
12. Faltan las decisiones del dueño que bloquean a otras páginas: política de mantenimiento, pasarela, cobro en USD, entidad legal, rastreadores de IA y presupuesto de pauta.
13. SEO técnico incompleto: dominio canónico, sitemap con demos que pasarán a noindex, sin imagen OG por producto, sin contenido nuevo y sin inglés indexable.
14. Tono y marca inconsistentes: voseo en /services y en las landings, "usted" en las páginas legales, "Koptup" y "KopTup" mezclados.

Una sola marca, KopTup, con dos líneas de negocio en este orden (la actualización del dueño prevalece sobre cualquier versión anterior):

Declaraciones de posicionamiento (texto interno; de aquí salen los titulares, los anuncios y el discurso de venta):

RAG. Para empresas de Colombia y Latinoamérica que tienen su conocimiento repartido en manuales, contratos, políticas y normas, KopTup instala sistemas RAG: una IA que responde con los documentos de la empresa y muestra de qué documento y página sale cada respuesta. A diferencia de un asistente de uso general, está configurada para responder solo con tus documentos y decir "no lo encuentro" cuando la respuesta no está. Se valida en un Piloto de 2 semanas con un informe de precisión medido, y la opera un equipo en Colombia.

A medida. Para empresas que necesitan un sistema propio (ERP, CRM, POS, LMS…) y no quieren pagar un desarrollo desde cero ni adaptarse a un software rígido, KopTup parte de un producto base con demo navegable y lo adapta a su proceso. Ves el producto antes de comprarlo, pagas la adaptación y recibes el código de lo que se construye para ti, más una licencia de uso del producto base.

Pilares del mensaje. Cada pilar tiene una prueba que el visitante puede verificar.

Tono y estilo

• "Tú" en todo el sitio, en los emails y en WhatsApp. Se elimina el voseo ("elegí", "querés", "suscribite") y el "usted" de las páginas legales.
• Español colombiano neutro. Anglicismos solo cuando no hay palabra mejor; "setup" se conserva porque el mercado lo usa, con la explicación "pago único de implementación".
• La marca se escribe KopTup, siempre. El dominio sigue en minúsculas.
• Precios: "COP 9.900.000" y "USD 2.990", como ya formatea lib/rag-plans.ts, con "+ IVA si aplica" junto a todo precio en COP.
• Sin superlativos sin prueba: nada de "el mejor", "líder" ni "reconocido".

Alternativas con las que nos comparan

Lo que no decimos y qué decimos en su lugar

La lista vive en apps/web/src/config/claims-blacklist.json. La usan una prueba E2E de las landings (Landings SEO) y un script nuevo, apps/web/scripts/check-claims.mjs, que revisa src/, messages/ y public/ en el CI y falla si encuentra una frase prohibida. Los datos simulados dentro de las demos quedan fuera del script, porque su limpieza va en la página de cada producto.

Cliente ideal

Personas compradoras

Mensajes por segmento. Las landings de la rama RAG ya tienen sus titulares; esta tabla es la referencia para anuncios, LinkedIn, emails y la revisión de coherencia.

En los primeros 90 días la pauta paga solo los tres segmentos P1 (todos del camino RAG). Los segmentos P2 y P3 llegan por SEO, LinkedIn y referidos hasta que el sistema de solicitud de demos esté en producción.

Cada paso tiene un siguiente paso claro y lo que se paga en una oferta de entrada se descuenta de la siguiente.

flowchart LR
  G1["Gratis: demo pública y Prueba con tu documento"] --> G2["Gratis: llamada Conocer tu caso, 30 min"]
  G2 --> G3["Gratis con aprobación: demo guiada o acceso de 14 días"]
  G2 --> G4["Gratis para grado A o B: diagnóstico de 2 horas"]
  G3 --> P1["Pago: Piloto RAG de 2 semanas"]
  G4 --> P2["Pago: taller de alcance, solo proyectos grandes"]
  P1 -->|"Crédito del 100 % en 30 días"| PL["Plan Esencial, Profesional o Empresarial"]
  G4 --> PR["Propuesta de proyecto a medida"]
  P2 -->|"Se descuenta del setup"| PR
  PL --> EX["Expansión: más fuentes, WhatsApp, plan superior, otros productos"]
  PR --> EX

Ver diagrama como imagen

Los pilotos de otros productos que proponen sus páginas (por ejemplo, el de Voice AI) siguen esta misma regla: precio fijo definido por el dueño y abonable al setup.

Son metas iniciales para el mes 3 (ritmo mensual), a validar con 8 semanas de datos reales, como fija Flujo del cliente. No son resultados actuales.

flowchart TD
  S["Sesiones en landings, /rag y demos: 2.000 al mes"] --> D["Inician la demo pública: 20 % = 400"]
  S --> F["Envían Solicitar demo, contacto o escriben por WhatsApp: 1,5 % = 30"]
  D --> P["Prueba con tu documento, lead demo-rag: 12 % = 48"]
  P --> L["Leads únicos, sin duplicados: unos 70 al mes"]
  F --> L
  L --> C["Calificados, grado A o B o conversación efectiva: 30 % = 21"]
  C --> R["Llamada o demo guiada realizada: 60 % = 12"]
  R --> PR["Propuesta enviada, de Piloto o de proyecto: 50 % = 6"]
  PR --> G["Ganados: 33 % = 2 al mes"]
  G --> PL{"¿Fue un Piloto RAG?"}
  PL -->|"Sí"| UP["Pasa a un plan en 30 días: 50 %"]
  PL -->|"No"| PJ["Proyecto a medida en el portal"]

Ver diagrama como imagen

Acumulado a 90 días. El mes 1 se va casi entero en preparar las bases (sección 18): unos 140 leads, 12 propuestas, al menos 3 Pilotos RAG y al menos 1 proyecto a medida en propuesta.

Cuánto se puede pagar por un cliente. Valor del primer año (sin IVA):

Con un presupuesto de pauta de prueba de COP 2.500.000 al mes y 2 clientes al mes, el costo de pauta por cliente queda por debajo del techo. La revisión de la semana 8 decide si se sube, se mantiene o se corta.

El CRM es Admin › Leads, sobre el modelo Lead del Sistema de demos. No se contrata un CRM externo, para no duplicar datos personales ni pagar licencias. Las etapas son las de la sección 6.3 de esa página; aquí se fijan sus definiciones operativas.

Las 4 preguntas de calificación (se registran en la nota de la llamada):

1. Necesidad: ¿qué quiere resolver, con qué documentos o con qué proceso?
2. Situación actual: ¿dónde están hoy los documentos o qué sistema usa (Drive, SharePoint, carpetas, ERP)?
3. Decisor: ¿quién aprueba la compra y quién más participa?
4. Plazo y presupuesto: ¿para cuándo lo necesita y el rango del Piloto o del plan cabe en su presupuesto?

Higiene del pipeline

• Todo lead abierto tiene responsable y próxima acción con fecha. La vista "Sin próxima acción" de Admin › Leads debe estar vacía cada viernes.
• Nadie pasa a perdido sin motivo, ni a propuesta sin la propuesta registrada.
• Los duplicados se fusionan por email (regla del modelo Lead).
• Las solicitudes de prueba del equipo se marcan isTest y no cuentan en las métricas.

Rutina comercial

Pronóstico. Valor estimado × probabilidad de la etapa, sumado por mes. En la Fase 1 se calcula a mano desde el kanban. Se propone un campo nuevo, Lead.estimatedValueCOP (P2), que se agrega a la sección 5.1 de Sistema de demos para que Admin › Métricas lo calcule solo.

Solución puente mientras Admin › Leads no esté en producción (es la tarea 29 de Sistema de demos, hito 1b):

• Una hoja de cálculo en la cuenta de la empresa, con acceso solo para el equipo comercial y las mismas columnas y etapas de la tabla anterior. Es una base de datos personales más: entra en el inventario de la política (Legal).
• Al salir Admin › Leads, un script apps/backend/src/scripts/import-leads-csv.ts la importa (idempotente por email, con --dry-run) y la hoja se borra.

La herramienta (Cal.com), los componentes BookingInline y BookingButton y el webhook están definidos en Contacto. Aquí va la configuración operativa:

El botón WhatsAppButton, el número en lib/company.ts y los mensajes de bienvenida y ausencia están en Contacto. Aquí va la operación:

• Fase 1: aplicación WhatsApp Business en un número de la empresa, nunca uno personal.
  • Perfil: descripción ("Sistemas RAG: IA que responde con los documentos de tu empresa"), horario, sitio web y buzón comercial de rol.
  • Catálogo: Piloto RAG, plan Esencial, plan Profesional y "Demo sin registro", cada uno con su enlace.
  • Etiquetas iguales a las etapas del pipeline: Nuevo, Calificado, En demo, Propuesta, Cliente y Perdido. Así el comercial ve el estado sin abrir el panel.
• Respuestas rápidas (copy propuesto):

• Reglas:
  • Si hay interés, el Lead se registra el mismo día en Admin › Leads (o en la hoja puente).
  • No se piden ni se reciben documentos con datos personales o de salud por WhatsApp: se envía el enlace de "Prueba con tu documento" o se acuerda un canal seguro para el Piloto.
  • Sin listas de difusión ni mensajes masivos.
  • KopTup escribe primero solo a quien autorizó WhatsApp (casilla del formulario).
• Fase 5: la API de WhatsApp Cloud, a través de un proveedor, crea el Lead automáticamente y envía las plantillas aprobadas por Meta. La integración actual por Twilio se queda para los avisos internos al equipo.

Infraestructura (prerrequisito de toda secuencia):

Catálogo de secuencias. Todas usan OutboundMessage con sequenceKey y stepKey, y se detienen si el lead agenda, responde, pide propuesta, se da de baja o pasa a ganado o perdido.

Textos de seq_demo_rag (variables como en Sistema de demos):

Día 0: se envía una hora después de la prueba, solo si el borrado del documento quedó registrado.

Asunto: Tu prueba con el asistente de KopTup

Hola:

Gracias por probar el asistente con tu documento. Como te prometimos, ya lo borramos.

Lo que viste es el mismo motor que instalamos en empresas: responde con sus documentos y cita la página de donde sale cada respuesta.

¿Quieres saber cómo respondería con todos los documentos de tu empresa? [Agendar 30 minutos] · [Conocer el Piloto RAG]

Día 2

Asunto: ¿Qué tan bien respondería con todos tus documentos?

En el Piloto RAG lo medimos antes de que inviertas en un plan: cargamos hasta 100 documentos de una fuente, preparamos contigo 50 preguntas reales y te entregamos un informe con cuántas respondió bien y con qué fuente.

Dura 2 semanas y cuesta COP 3.900.000 (USD 1.200) + IVA si aplica. Si contratas un plan en los 30 días siguientes, te lo descontamos completo.

[Agendar llamada]

Día 5

Asunto: Dónde quedan tus documentos (y quién los ve)

Tres respuestas cortas: dónde se guardan, quién puede verlos y qué pasa cuando terminamos. Si tu empresa es de salud o legal, también puedes tener el sistema en tu propia nube (plan Empresarial). Lee el detalle: {{seguridadUrl}}

Día 10

Asunto: ¿Lo dejamos para más adelante?

Si ahora no es el momento, no te escribiremos más sobre esta prueba. Si quieres recibir novedades una vez al mes, actívalo aquí: {{optInUrl}}. Y si sí es el momento: {{agendaUrl}}.

El enlace {{optInUrl}} registra un ConsentRecord con marketing = true y canal demo_rag. Sin ese clic, el lead pasa a nutricion sin recibir el boletín.

Recordatorio del crédito del Piloto (seq_pilot):

Asunto: Te quedan 10 días para usar el crédito de tu Piloto

Hola {{nombre}}: el {{fechaLimite}} vence el crédito de COP {{valor}} de tu Piloto RAG. Si contratas el plan {{planRecomendado}} antes de esa fecha, lo descontamos completo del setup. ¿Revisamos juntos el informe? {{agendaUrl}}

Reglas

1. Ninguna cifra sin fuente. Cada número dice de dónde sale: "medido en el informe de precisión del Piloto, 50 preguntas, marzo de 2027".
2. Cada caso lleva una etiqueta: Cliente, Producto propio o Uso interno, como en las tarjetas de Home y Nosotros.
3. Nombre, logo, monto y cita solo con autorización escrita del cliente. Sin ella, el caso es anónimo ("Operador administrativo del sector salud, Bogotá"). Las banderas authorized y amountPublic viven en CASES de lib/company.ts.
4. No se paga por opiniones. No se dan descuentos a cambio de una reseña o de un testimonio positivo.
5. Nunca aggregateRating en los datos estructurados de la propia empresa. Google no muestra reseñas propias de una organización, y publicarlas sin reseñas reales es engañoso.
6. La cláusula de portafolio de los términos actuales (KopTup puede usar cualquier proyecto salvo que haya un NDA) se reemplaza por una referencia comercial opcional: una casilla aparte en el contrato (sección 16).

Inventario: qué se quita

Activos de prueba que se construyen

Cómo se consigue un testimonio. En la reunión de entrega del informe del Piloto, el comercial hace tres preguntas y pide permiso para usar la respuesta: "¿Cómo lo resolvían antes?", "¿Qué cambió con el asistente?" y "¿A quién se lo recomendarías?". La autorización se firma aparte, con el texto exacto que se publicará.

Plantilla de caso de estudio (la usan /casos/<slug> en la Fase 5, Home y Nosotros):

Título: Cómo {cliente o descripción anónima} {logró un resultado concreto}
Etiqueta: Cliente | Producto propio | Uso interno · Sector · Ciudad · Mes y año

Resumen (3 líneas): problema, solución y resultado medido.

1. Contexto: quién es (tamaño, sector) y cómo trabajaba antes.
2. Reto: el problema en palabras del cliente.
3. Solución: qué se hizo, plan o producto, duración, integraciones y diagrama simple.
4. Resultados: cada métrica con fuente, periodo y método
   ("78 % de 50 preguntas respondidas correctamente con cita, informe del Piloto, marzo de 2027").
   Antes y después medidos de la misma forma. Sin extrapolaciones.
5. Cita del cliente: nombre y cargo solo con autorización.
6. Qué sigue: próxima fase o plan.
7. Ficha: duración, plan, tecnologías y equipo.
CTA: Probar la demo · Solicitar demo · Agendar llamada.

Uso interno, no se publica: referencia del documento de autorización y fecha.

Herramienta: GA4 (ya decidida en la rama RAG), más el embudo de negocio calculado desde la base de datos, que no depende de cookies.

flowchart LR
  V["Visitante"] --> B{"Banner de cookies"}
  B -->|"Acepta analítica"| GA["GA4"]
  B -->|"Acepta publicidad"| AD["Google Ads y LinkedIn Insight"]
  B -->|"Rechaza"| NO["Sin etiquetas de terceros"]
  V --> FORM["Formularios con UTM y página de origen"]
  FORM --> API["Backend: Lead, DemoRequest y ConsentRecord"]
  API --> ADM["Admin Métricas: embudo de negocio"]
  GA --> REP["Informe semanal"]
  ADM --> REP
  AD --> OPT["Optimización de campañas"]
  API -.->|"Fase 5, solo con consentimiento"| OFF["Conversiones offline a Google Ads"]

Ver diagrama como imagen

Diccionario de eventos. Es la lista maestra: reúne los eventos de la rama RAG y de las demás páginas. Los nombres van en snake_case y ningún parámetro lleva datos personales.

Configuración de GA4

• Una propiedad con un flujo web para el dominio con www.
• Retención de datos de 14 meses. Google Signals desactivado.
• Dimensiones personalizadas de evento: lead_source, product, plan, demo_slug, access_mode, source_page, section y cta. Ninguna a nivel de usuario.
• Tráfico interno: el parámetro traffic_type=internal se envía cuando hay una sesión del equipo, más un filtro por IP si la oficina tiene una fija.
• Lista de referencias no deseadas: la pasarela de pagos y la agenda, para que no "roben" la fuente original.
• Sin etiquetas en /acceso/*, /baja, /dashboard ni /admin. Así ningún token ni dato de cuenta llega a un tercero.
• Vinculación con Google Ads y con Search Console.
• Sin Google Tag Manager en la Fase 1: las etiquetas se cargan desde components/analytics/Analytics.tsx (rama RAG) a través de lib/consent.ts (Legal). La CSP de next.config.js (línea 79) se amplía solo con los dominios de las etiquetas aceptadas, de la agenda y del captcha.

Atribución con UTM

• Convención (la misma de Landings SEO):
  • utm_source: google, linkedin, email, whatsapp, referido, agenda;
  • utm_medium: cpc, paid_social, organic_social, email, referral;
  • utm_campaign: <línea>-<segmento>-<año>q<trimestre>, por ejemplo rag-salud-2026q4;
  • utm_content: la variante del anuncio, la publicación o el paso de la secuencia.
• Generador: una hoja con el constructor de URL y la lista de campañas vigentes. Ningún enlace de pauta, LinkedIn o email sale sin UTM.
• Persistencia: el primer contacto (first touch) y el último (last touch) se guardan en sessionStorage (ya está en el inventario de cookies de Legal). Viajan con el formulario a Lead.source.utm (primer contacto) y a DemoRequest.source.utm (último contacto).
• Fase 5: se guarda gclid solo si hay consentimiento de publicidad (ad_user_data) y se suben a Google Ads las conversiones "lead calificado" y "cliente ganado" como conversiones offline.

Informe semanal (viernes, una página):

Correo en frío a personas: antes de usarlo hay que validar con el asesor su encaje en la Ley 1581 (decisión D9). Mientras tanto, la prospección va por LinkedIn, por referidos y por los canales generales de cada empresa.

Google Ads: estructura inicial

• Campañas: rag-salud-2026q4, rag-legal-2026q4, rag-soporte-2026q4 y marca. Cada una apunta a su landing (/rag/salud, /rag/legal, /rag/soporte) con concordancia de frase y exacta.
• Ejemplos de palabras clave: "chatbot con inteligencia artificial para empresas", "inteligencia artificial para documentos", "asistente virtual con IA para empresas", "IA para abogados", "buscar en contratos con IA", "chatbot de atención al cliente WhatsApp", "base de conocimiento con IA".
• Negativas: gratis, curso, empleo, trabajo, descargar, plantilla, tesis, "qué es", "chatgpt gratis".
• Anuncio de ejemplo (titulares de máximo 30 caracteres; descripciones de máximo 90):
  • Titulares: "IA con tus documentos" · "Respuestas con la fuente" · "Piloto RAG en 2 semanas" · "Prueba la demo sin registro" · "Equipo en Colombia".
  • Descripciones: "Tu equipo pregunta y la IA responde con tus manuales y políticas, citando la página." · "Valídalo en 2 semanas con un informe de precisión. Precios publicados en COP."
• Conversión principal: generate_lead y schedule_call_booked. Puja manual o por clics durante las 4 primeras semanas, hasta tener al menos 15 conversiones.
• Revisión semanal: términos de búsqueda (agregar negativas), CPL por campaña y calidad de los leads según Admin › Leads, no solo el volumen.

SEO técnico

Datos estructurados honestos

Validación: prueba de resultados enriquecidos de Google sin errores, y una prueba automática que falla si aparece aggregateRating en apps/web/src.

Open Graph: una imagen por landing de producto, sin precios (tarea 16 de Landing de producto), por landing RAG de sector y, en la Fase 5, por caso y por artículo. La imagen general ya cambió al mensaje RAG en la rama.

Inglés indexable (Fase 5)

• Rutas /en/* con next-intl y localePrefix: 'as-needed': el español queda sin prefijo y el inglés con /en. Hay que cambiar middleware.ts, que hoy lee solo la cookie (líneas 3–8).
• hreflang recíproco es, en y x-default (que apunta al español), canónico por idioma y alternates.languages en el sitemap.
• Primer grupo de páginas: home, /rag, planes RAG (en USD), /demo/chatbot y las 5 landings de producto más visitadas.
• Traducción revisada por una persona con dominio del inglés de negocios; nada se publica traducido solo a máquina.
• Hasta entonces se mantiene la regla actual: inglés por cookie y sin hreflang.

Contenido (Fase 5; la página pilar /rag va en la Fase 1)

• Formato: /blog/<slug> con archivos MDX en apps/web/content/blog/, Article en JSON-LD, RSS, autor (el fundador), fecha de publicación y de revisión, y fuentes citadas.
• Ritmo: 2 artículos al mes. Ningún texto generado con IA se publica sin revisión humana y sin verificar cada dato.
• Primeros temas:

Las reglas de presentación (moneda, IVA, TRM, valores especiales y fuente única) están en la sección 7 de Servicios y precios. Aquí va la política comercial que usan todas las páginas de producto.

Principios

1. Precios publicados. Los del Piloto y los planes RAG son exactos. Los de las otras soluciones son "desde", con el alcance de cada plan.
2. Una sola fuente: lib/rag-plans.ts y lib/services-catalog.ts; en la Fase 3, packages/catalog también para el backend.
3. No se publican descuentos que no se pueden cobrar. Se retiran los descuentos semestral y anual de BILLING_CYCLES (services-catalog.ts líneas 171–175) hasta la Fase 4.
4. Sin "Más popular" ni "Más vendido" mientras no haya ventas que lo respalden. Se usa "Ideal para…" con una condición concreta: "Ideal si atiendes por WhatsApp".

Anclaje y claridad

• Orden de los planes: Piloto → Esencial → Profesional → Empresarial ("desde"). El Empresarial visible ancla el valor y el Piloto baja el riesgo.
• Cada plan muestra el costo del primer año, para que nadie descubra la mensualidad al final:

Todos los valores en COP son + IVA si aplica. Las preguntas sobre el tope del plan cuestan COP 250 (USD 0,08) cada una y los mensajes de WhatsApp se cobran al costo de Meta.

IVA, retenciones y moneda (validar con el contador, decisión D7)

• IVA: "+ IVA si aplica" junto a cada precio en COP. Cada concepto se clasifica con el contador antes de la primera factura: desarrollo e implementación, mensualidad hospedada (puede tener un tratamiento distinto; el Estatuto Tributario, art. 476, num. 24, excluye algunos servicios de computación en la nube), Piloto, mantenimiento y exportación de servicios a clientes del exterior (art. 481).
• Retenciones: las empresas que compran practican retenciones (en la fuente, de IVA y de ICA según el caso). La propuesta dice: "Valores antes de retenciones. Las retenciones que practique tu empresa se descuentan del pago según la ley".
• Moneda:
  • Planes RAG en USD fijos.
  • Otras soluciones en USD de referencia (TRM_REFERENCIA = 3300).
  • Para clientes del exterior, la propuesta fija el precio en USD.
  • En la contabilidad, la TRM del día de la factura.

Condiciones de pago

Descuentos

Vigencia y cambios

• Las propuestas valen 30 días.
• Los precios publicados se revisan cada trimestre.
• A los clientes con mensualidad se les avisa cualquier cambio con 30 días de anticipación, y su precio se mantiene durante los primeros 12 meses del contrato.

Mantenimiento de la compra (decisión pendiente D2). Las opciones A (porcentaje anual del setup), B (bolsas de horas) y C (dejar el valor actual) están en la sección 7.3 de Servicios y precios.

Recomendación: la opción A, con un 18 % anual del setup pagado en cuotas mensuales y las horas de ajustes del plan incluidas, más una bolsa de horas adicional con tarifa publicada. Es fácil de explicar, se compara bien con el mercado y deja de generar la objeción de que el mantenimiento cuesta más que el setup en un año. Mientras el dueño decide, las landings muestran "+ mantenimiento según plan (se detalla en tu propuesta)".

Qué se vende como suscripción (DECISIÓN 7). Solo los planes RAG, hospedados por KopTup. Las otras 26 soluciones se venden como compra a medida y muestran "Suscripción: lista de espera".

Cómo se cobra en cada fase

Pasarelas (decisiones D3 y D4). Las condiciones y comisiones cambian, así que hay que verificarlas antes de contratar.

DECISIÓN 7 nombra Stripe para USD. Esta página no la cambia: deja constancia de que su viabilidad depende de la decisión D4 y propone la transferencia internacional como camino mientras tanto.

sequenceDiagram
  autonumber
  participant C as Cliente
  participant K as Comercial KopTup
  participant FE as Software contable con factura electrónica
  participant P as Pasarela COP
  participant A as Admin KopTup
  C->>K: Acepta la propuesta o el Piloto
  K->>FE: Emite la factura electrónica del anticipo
  FE-->>C: Factura con CUFE por email, en PDF y XML
  K->>C: Enlace de pago o datos para transferencia
  C->>P: Paga con PSE, tarjeta o Nequi
  P-->>A: Confirmación del pago, por webhook firmado desde la Fase 3
  A->>A: Marca la factura como pagada y crea el proyecto
  Note over FE,A: En la Fase 1 los pasos 2 y 7 son manuales y en la Fase 3 van por API

Ver diagrama como imagen

Esto es la facturación de la propia KopTup a sus clientes. El producto Facturación electrónica que KopTup vende a terceros es otra cosa.

Obligaciones a revisar con el contador (decisiones D5, D6 y D7)

Qué se factura y cuándo

Integración con la plataforma

• Fase 1: la factura se emite a mano en el software contable. El PDF y el XML se adjuntan en Admin › Facturas, que muestra "La factura electrónica DIAN se emite en el sistema contable" (Panel de administración).
• Fase 3: botón Emitir factura electrónica en el panel, que llama a la API del proveedor y guarda el CUFE, el PDF y el XML. El portal los muestra con una URL firmada (Portal del cliente, tarea P-18; Panel de administración, tarea 41).

El detalle (política, aviso, autorizaciones, derechos, cookies y retención) está en Legal y en la sección 14 de Sistema de demos. Esta es la lista operativa del negocio:

• Ley 2300 de 2023: fija horarios y límites de frecuencia para contactar a consumidores. Hay que validar con el asesor si aplica a contactos entre empresas (D9). Mientras tanto se usa la regla más estricta: lunes a viernes de 8:00 a 19:00, sin domingos ni festivos, máximo 1 mensaje comercial al día por lead, y canal y horario según lo que la persona autorizó.
• La baja de comunicaciones comerciales detiene todas las secuencias, pero no los avisos operativos de un acceso o de un contrato.
• WhatsApp saliente solo con autorización. Correo en frío a personas solo después de la validación del asesor.

• La información de la publicidad debe ser veraz y comprobable: es la razón de la lista negra de la sección 1.
• Las condiciones del Piloto (alcance, crédito y plazo) se publican en /terms#piloto y se repiten en la propuesta.
• Las promociones llevan fecha de inicio y de fin visibles. La landing de Product Hunt, sin fecha, se retira (Landings SEO).
• Si quien compra es un consumidor (persona natural para uso propio), aplican el Estatuto del Consumidor y el retracto en ventas a distancia cuando proceda (Legal, sección de términos).

flowchart TD
  NDA["Acuerdo de confidencialidad, antes de recibir datos o documentos del prospecto"] --> PROP["Propuesta: plan, modalidad, montos y vigencia de 30 días"]
  PROP --> ACE{"¿Qué acepta?"}
  ACE -->|"Piloto RAG"| OSP["Orden de servicio del Piloto, con condiciones cortas"]
  ACE -->|"Plan o proyecto"| MSA["Contrato marco de servicios"]
  MSA --> OS["Orden de servicio del plan o del proyecto"]
  OS --> AA["Anexo A: alcance y criterios de aceptación"]
  OS --> AB["Anexo B: cronograma y pagos"]
  OS --> AC["Anexo C: soporte y SLA"]
  OS --> AD["Anexo D: tratamiento de datos por encargo"]
  OS --> AE["Anexo E: seguridad, solo controles reales"]
  OS --> AF["Anexo F: licencias, productos base y código abierto"]
  OSP --> AD
  OSP --> T["Términos publicados en /terms"]
  MSA --> T

Ver diagrama como imagen

En Colombia, el software se protege como obra literaria. Además, en las obras creadas por encargo a través de un contrato de prestación de servicios se presume que los derechos patrimoniales pasan a quien encarga, salvo pacto en contrario (Ley 23 de 1982, art. 20, modificado por el art. 28 de la Ley 1450 de 2011; validar con el abogado). Por eso el contrato marco debe:

1. Listar en el Anexo F los productos base y componentes previos de KopTup que se usan en el proyecto, y dejar claro que no se ceden: se licencian.
2. Ceder de forma expresa, y solo al pagar el total, los derechos patrimoniales sobre lo desarrollado específicamente para el cliente.
3. Listar las licencias de código abierto y sus obligaciones.
4. Reemplazar el texto actual de los términos ("derechos de uso del software desarrollado"), que es ambiguo.

Sin esto, el modelo "estudio con productos base listos" pierde su ventaja: cada venta podría entregar el producto base.

• El porcentaje del objetivo de disponibilidad se publica solo cuando exista un monitoreo externo que lo mida (Seguridad y calidad). Se excluyen los mantenimientos programados (avisados con 48 h) y las caídas del proveedor de IA, que se informan en la página de estado.
• Los tiempos son de primera respuesta, no de solución.

• La firma electrónica es válida en Colombia si el método es confiable y apropiado (Ley 527 de 1999 y Decreto 2364 de 2012, compilado en el Decreto 1074 de 2015).
• Fase 1: firma electrónica con una herramienta del mercado para el contrato marco y la orden de servicio. La aceptación del Piloto puede ser por email desde el buzón corporativo del cliente, con la orden adjunta.
• Fase 3: aceptación en línea de la propuesta (/propuesta/[token]) con evidencia: identidad por enlace de un solo uso, fecha, IP en hash y versión del documento.
• La demo de Firma electrónica es una maqueta: no se usa para los contratos propios mientras no sea un producto real.

Antes de la primera propuesta a una IPS o a un pagador (detalle en Demo cuentas médicas):

• Evaluación de impacto de privacidad del caso de uso.
• Contrato de transmisión (Anexo D) con el cliente y con los subencargados (nube, proveedor de IA).
• Acuerdos de confidencialidad firmados por todo el equipo con acceso.
• Respuestas estándar al cuestionario de seguridad del comprador, solo con controles reales y sin afirmar certificaciones que no se tienen.
• Despliegue en la nube del cliente u on-premise (plan Empresarial) cuando haya historias clínicas.

• Registrar la marca KopTup ante la SIC, previa búsqueda de antecedentes. Las clases a validar con el abogado son las de software, servicios tecnológicos y publicidad o gestión comercial (por ejemplo, las clases 9, 42 y 35 de Niza).
• Usar "KopTup" en todo el sitio, los emails, los contratos y el JSON-LD.

Estas decisiones bloquean tareas de otras páginas. Se cierran con fecha y responsable, y esta tabla se actualiza en la wiki.

Las fechas son un ejemplo con inicio el lunes 19 de octubre de 2026; si el arranque es otro día, todo se corre igual. El calendario tiene en cuenta los festivos de Colombia (2 y 16 de noviembre, 8 y 25 de diciembre, 1 y 11 de enero) y la temporada baja de fin de año: muchas empresas cierran el presupuesto de 2027 en enero, así que diciembre se usa para pilotos en curso, contenido y casos, y la pauta se reanuda en enero.

Supuestos:

• La rama rag-reposicionamiento se fusiona en las dos primeras semanas.
• El sistema de solicitud de demos (hito 1a) llega en la fecha que fije el Roadmap. Hasta entonces, los leads de "otras soluciones" entran por contacto, WhatsApp y agenda.

gantt
  title Calendario comercial de 90 días
  dateFormat YYYY-MM-DD
  axisFormat %d/%m
  section Bases
  Decisiones y reunión con contador y abogado :b1, 2026-10-19, 5d
  Datos de empresa y limpieza de afirmaciones :b2, 2026-10-19, 10d
  GA4 con banner y convención de UTM :b3, 2026-10-26, 10d
  Agenda y WhatsApp Business y correo autenticado :b4, 2026-10-26, 5d
  Pipeline puente y kit de ventas :b5, 2026-11-03, 5d
  Contratos tipo y condiciones del Piloto :b6, 2026-10-26, 25d
  Facturación electrónica y pasarela :b7, 2026-10-26, 30d
  section Adquisición
  LinkedIn del fundador tres veces por semana :a1, 2026-11-03, 73d
  Google Ads de prueba por segmento :a2, 2026-11-09, 40d
  Pausa de pauta en temporada baja :crit, a3, 2026-12-19, 17d
  Relanzamiento con mensaje de presupuesto 2027 :a4, 2027-01-05, 11d
  Prospección de 100 cuentas objetivo :a5, 2026-11-09, 60d
  section Ventas
  Llamadas de descubrimiento y demos guiadas :v1, 2026-11-09, 68d
  Primeros Pilotos RAG :v2, 2026-11-30, 47d
  Propuestas de plan después de cada Piloto :v3, 2026-12-14, 33d
  section Prueba social
  Autorización de SoSalud y borrador del caso :p1, 2026-11-09, 30d
  Informe público de precisión del asistente :p2, 2026-11-23, 20d
  section Revisión
  Informe semanal del embudo :r1, 2026-11-20, 57d
  Revisión de la semana 8 :milestone, r2, 2026-12-11, 0d
  Solicitud de demos en producción, estimado :milestone, r3, 2027-01-08, 0d
  Retro de 90 días y plan del trimestre :r4, 2027-01-12, 4d

Ver diagrama como imagen

El plan de SEO está en la sección 12. Aquí van las reglas que afectan a todos los activos comerciales:

i18n

• Todo el copy comercial (emails, WhatsApp, propuestas, anuncios) va en español con "tú" y con "KopTup".
• En la Fase 1, las secuencias de email solo existen en español. Las versiones en inglés llegan con el sitio /en (Fase 5) y se eligen por el idioma del Lead.
• Las propuestas y los contratos rigen en español. La versión en inglés para clientes del exterior es de cortesía, salvo que el contrato diga otra cosa.

Accesibilidad

• Emails con versión en texto plano, alt en las imágenes, botones con texto descriptivo ("Agendar llamada", no "clic aquí") y contraste AA.
• El banner de cookies, la agenda y el botón de WhatsApp se pueden usar con teclado. El botón flotante lleva aria-label="Escribir por WhatsApp".
• Los informes y casos en PDF también se publican en HTML.

Rendimiento

• Ninguna etiqueta de terceros se carga antes del consentimiento. Las aceptadas cargan después de la interacción (afterInteractive o lazyOnload).
• La agenda se carga al pulsar "Ver horarios" y los videos usan el dominio sin cookies del proveedor.
• Sin Google Tag Manager en la Fase 1.
• Meta: LCP móvil p75 < 2,5 s en las landings de pauta, medido en Search Console.

Metas iniciales, a validar con 8 semanas de datos reales.

• Flujo del cliente · Sistema de demos · Panel de administración · Portal del cliente
• Legal · Servicios y precios · Landings SEO y de campaña · Contacto · Nosotros · Home · Landing de producto
• Visión de producto · Catálogo de productos · Backend y API · Seguridad y calidad · Roadmap