@innvisor/conny-ai 9.7.0

package/src/domain/onboarding_flow.py

@@ -0,0 +1,230 @@
+from __future__ import annotations
+import json
+import logging
+import re
+from typing import Any, Dict, List, Optional, Tuple
+from conny_core.first_turn_ops import _normalize_conv_text
+
+log = logging.getLogger("conny.onboarding_flow")
+
+_business_confirmation_signals = (
+    "sí ese es", "si ese es", "ese sí", "ese si", "ese mismo", "correcto ese",
+    "sí, ese", "si, ese", "exacto", "sí es ese", "si es ese",
+    "sí", "si", "sip", "claro", "correcto", "ese", "eso", "yes", "yep",
+    "thats us", "that's us", "that is us", "yes thats us", "yes that's us",
+    "yes thats right", "yes that's right", "thats right", "that's right",
+    "ajá", "aja", "dale", "listo", "así es", "asi es", "es ese", "ese es", "exactamente",
+    "sí señor", "si señor", "siii", "siiii", "siiiii", "sii",
+    "somos nosotros", "somos esos", "somos ese", "ese somos", "eso somos",
+    "somos esa", "esa somos", "si somos nosotros", "sí somos nosotros",
+    "es de nosotros", "ese es nuestro", "es nuestro", "eso es nuestro",
+    "eso somos nosotros", "esos somos", "ese sí somos", "ese si somos",
+    "claro que sí somos", "claro que si somos", "somos el negocio", "somos esa clínica",
+)
+
+def looks_like_business_confirmation(raw_text: str) -> bool:
+    normalized = _normalize_conv_text(raw_text or "")
+    if not normalized:
+        return False
+    return any(
+        normalized == signal or (len(signal) > 6 and signal in normalized)
+        for signal in _business_confirmation_signals
+    )
+
+def owner_confusion_or_language_signal(raw_text: str) -> bool:
+    normalized = _normalize_conv_text(raw_text or "")
+    if not normalized:
+        return False
+    signals = (
+        "just english sorry", "sorry just english", "english sorry",
+        "english only", "speak english", "speak in english", "only english",
+        "i dont speak spanish", "i don t speak spanish",
+        "i dont talk spanish", "i don t talk spanish",
+        "what is this", "sorry what is this",
+        "i dont understand", "i don t understand",
+        "what did you say", "what did u say",
+        "thats not my business", "that s not my business",
+        "that is not my business", "not my business",
+        "thats not us", "that s not us", "that is not us", "wrong business",
+        "wrong company", "wrong one", "not the right one",
+        "no hablo español", "no hablo espanol", "solo ingles", "solo inglés",
+    )
+    return any(signal in normalized for signal in signals)
+
+def looks_like_business_name_candidate_legacy(raw_text: str) -> bool:
+    candidate = (raw_text or "").strip()
+    if not candidate:
+        return False
+    normalized = _normalize_conv_text(candidate)
+    if len(candidate) > 90:
+        return False
+    if owner_confusion_or_language_signal(candidate):
+        return False
+    owner_name_false_positives = (
+        "mi nombre es",
+        "me llamo",
+        "my name is",
+        "i am ",
+        "i'm ",
+        "im ",
+    )
+    explicit_business_markers = (
+        "el nombre de mi negocio se llama",
+        "el nombre de nuestro negocio se llama",
+        "el nombre de mi empresa se llama",
+        "el nombre de nuestra empresa se llama",
+        "el nombre de mi negocio es",
+        "el nombre del negocio es",
+        "el nombre de mi empresa es",
+        "el nombre de la empresa es",
+        "mi negocio se llama",
+        "nuestro negocio se llama",
+        "mi empresa se llama",
+        "nuestra empresa se llama",
+        "la clinica se llama",
+        "la clínica se llama",
+        "se llama ",
+        "negocio es ",
+        "empresa es ",
+    )
+    if (
+        any(marker in normalized for marker in owner_name_false_positives)
+        and not any(marker in normalized for marker in explicit_business_markers)
+    ):
+        return False
+    conversational_false_positives = (
+        "somos nosotros", "somos nosotras", "somos ese", "somos esa",
+        "si somos", "sí somos", "siii somos", "siiii somos",
+        "that is us", "that's us", "thats us", "yes thats us", "yes that's us",
+        "this is us", "we are that", "we are them",
+    )
+    if any(marker in normalized for marker in conversational_false_positives):
+        return False
+    if any(marker in normalized for marker in explicit_business_markers):
+        return True
+
+    if any(
+        marker in normalized
+        for marker in (
+            "como estas", "cómo estás", "quien eres", "quién eres", "que eres", "qué eres",
+            "que haces", "qué haces", "que harias", "qué harías", "como funcionas", "cómo funcionas", "aceptas audios",
+            "aceptas pdf", "para que", "para qué", "quien te hizo", "quién te hizo",
+            "me mandaron tu numero", "me mandaron tu número", "quiero una demo", "quiero demo",
+            "quiero probarte", "tengo un negocio", "tengo una empresa", "hola", "buenas", "?",
+            "what is this", "sorry what is this", "what do you do", "who are you",
+            "i dont understand", "i don t understand", "english only", "just english sorry",
+            "i dont talk spanish", "i don t talk spanish", "i dont speak spanish", "i don t speak spanish",
+        )
+    ):
+        return False
+    if looks_like_business_confirmation(candidate):
+        return False
+
+    words = re.findall(r"[A-Za-zÁÉÍÓÚáéíóúÑñ0-9&.'-]+", candidate)
+    if not (1 <= len(words) <= 8):
+        return False
+    if any(ch.isupper() for ch in candidate):
+        upper_tokens = [word.lower() for word in words if len(word) >= 2]
+        blocked_upper_tokens = {
+            "sorry", "spanish", "what", "this", "that",
+            "dont", "don't", "understand", "talk", "speak", "only", "hello",
+            "hi", "hola", "business", "not", "my",
+        }
+        if any(token in blocked_upper_tokens for token in upper_tokens):
+            return False
+        return True
+    business_tokens = (
+        "clinica", "clínica", "clinic", "spa", "dental", "salud", "centro",
+        "consultorio", "estetica", "estética", "studio", "group", "lab",
+        "restaurante", "hotel", "tienda", "academia", "gym", "gimnasio",
+    )
+    if any(token in normalized for token in business_tokens):
+        return True
+    # Marcas de 1-3 palabras sin jerga conversacional también pueden ser válidas.
+    if 1 <= len(words) <= 3 and all(len(word) >= 3 for word in words):
+        stop_tokens = {
+            "sorry", "spanish", "hello", "what", "this", "that",
+            "understand", "business", "please", "talk", "speak", "only",
+            "dont", "not", "sorry",
+        }
+        if not any(word.lower() in stop_tokens for word in words):
+            return True
+    return False
+
+async def llm_classify_business_name(raw_text: str, engine: Any) -> Tuple[bool, Optional[str]]:
+    candidate = (raw_text or "").strip()
+    if not candidate:
+        return False, None
+    
+    if len(candidate) < 2 or len(candidate) > 100:
+        return False, None
+        
+    normalized = _normalize_conv_text(candidate)
+    if normalized in {
+        "hola", "holaa", "holaaa", "holaaaa", "buenas", "buenasas", "buenasas", "buenasas",
+        "hey", "ey", "hi", "hello", "reset", "reiniciar", "menu", "menú"
+    }:
+        return False, None
+
+    sys_prompt = """Eres un clasificador y extractor de nombres de negocio de alta precisión para un chatbot de WhatsApp en modo demo.
+Analiza el mensaje del usuario y determina si está respondiendo a la pregunta de cómo se llama su negocio proporcionando el nombre de una clínica, empresa, marca, local o tienda para la demostración.
+
+REGLAS DE CLASIFICACIÓN:
+1. El mensaje debe contener el nombre de un negocio o marca de manera evidente (ej. "Nova", "Clinica de la Costa", "mi negocio es Spa Luna").
+2. Conversaciones casuales, saludos, preguntas sobre el funcionamiento del bot ("¿qué me quieres mostrar?", "¿de qué se trata?", "me mandaron tu número", "¿quién eres?"), respuestas afirmativas/negativas generales ("sí", "no", "ok", "claro"), o nombres de personas solos ("Santiago") NO son nombres de negocio.
+3. Si el mensaje es una frase donde presenta el negocio (ej. "se llama Peludos"), clasifica como negocio y extrae solo la marca limpia ("Peludos").
+
+EJEMPLOS DE POCAS TOMAS (FEW-SHOT):
+- Mensaje: "Nova"
+  Respuesta: {"es_negocio": true, "nombre": "Nova"}
+- Mensaje: "mi clínica se llama Clínica Dental Americana"
+  Respuesta: {"es_negocio": true, "nombre": "Clínica Dental Americana"}
+- Mensaje: "de qué se trata esto?"
+  Respuesta: {"es_negocio": false, "nombre": null}
+- Mensaje: "no quiero darte el nombre"
+  Respuesta: {"es_negocio": false, "nombre": null}
+- Mensaje: "Spa Luna, hacemos tratamientos faciales"
+  Respuesta: {"es_negocio": true, "nombre": "Spa Luna"}
+- Mensaje: "Petlandia"
+  Respuesta: {"es_negocio": true, "nombre": "Petlandia"}
+- Mensaje: "Carlos"
+  Respuesta: {"es_negocio": false, "nombre": null}
+- Mensaje: "hola buenas"
+  Respuesta: {"es_negocio": false, "nombre": null}
+
+Responde ÚNICAMENTE con un JSON válido:
+{
+  "es_negocio": true o false,
+  "nombre": "nombre del negocio limpio" (o null si es_negocio es false)
+}"""
+
+    try:
+        if not engine:
+            raise RuntimeError("LLM no init")
+        msgs = [
+            {"role": "system", "content": sys_prompt},
+            {"role": "user", "content": f"Mensaje del usuario: {raw_text}"}
+        ]
+        r, meta = await engine.complete(
+            msgs,
+            model_tier="fast",
+            temperature=0.0,
+            max_tokens=512,
+            use_cache=False,
+        )
+        log.info(f"[onboarding] classify business name LLM using {meta.get('provider','?')} model={meta.get('model','?')[:30]}")
+        if not r:
+            return looks_like_business_name_candidate_legacy(raw_text), None
+
+        clean_r = r.strip()
+        start_idx = clean_r.find("{")
+        end_idx = clean_r.rfind("}")
+        if start_idx != -1 and end_idx != -1 and end_idx > start_idx:
+            clean_r = clean_r[start_idx:end_idx+1]
+        
+        data = json.loads(clean_r)
+        return bool(data.get("es_negocio", False)), data.get("nombre")
+    except Exception as e:
+        log.error(f"[onboarding] Business name classification LLM failed: {e}")
+        legacy_res = looks_like_business_name_candidate_legacy(raw_text)
+        return legacy_res, None

package/src/domain/prompts/__init__.py

@@ -0,0 +1 @@
+# src/domain/prompts package

package/src/domain/prompts/prospect_pitch.py

@@ -0,0 +1,282 @@
+"""
+src/domain/prompts/prospect_pitch.py
+════════════════════════════════════════════════════════════════════════════════
+PITCH INTELIGENTE — Black One / Conny v1.0
+════════════════════════════════════════════════════════════════════════════════
+"""
+
+from __future__ import annotations
+
+import logging
+import re
+from typing import Any, Dict, List, Optional
+
+log = logging.getLogger("conny.pitch_upgrade")
+
+# ════════════════════════════════════════════════════════════════════════════════
+# 1. IDENTIDAD CORRECTA
+# ════════════════════════════════════════════════════════════════════════════════
+
+CREATOR_NAME   = "Black One"
+CREATOR_DESC   = "empresa de software y gobernanza de agentes de IA"
+CREATOR_HUMAN  = "Santiago Rubio"
+CREATOR_TEL    = "3124348669"
+
+CREATOR_LINE = (
+    f"me creó {CREATOR_NAME}, una {CREATOR_DESC}"
+    f" ||| la fundó {CREATOR_HUMAN} — si quieres esto para tu negocio, escríbele al {CREATOR_TEL}"
+)
+
+# ════════════════════════════════════════════════════════════════════════════════
+# 2. DETECCIÓN DE MODO PROSPECTO
+# ════════════════════════════════════════════════════════════════════════════════
+
+_PROSPECT_SIGNALS = [
+    "me mandaron", "me enviaron", "me pasaron", "me dieron tu número",
+    "me dieron este número", "me recomendaron",
+    "qué haces", "que haces", "para qué sirves", "para que sirves",
+    "qué eres", "que eres", "qué harías", "que harias", "qué harías por",
+    "que harias por", "que harias en", "qué harías en",
+    "qué puedes hacer", "que puedes hacer",
+    "cuánto cuestas", "cuanto cuestas", "cuánto cobras", "cuanto cobras",
+    "cuánto vale", "cuanto vale", "cuál es tu precio", "cual es tu precio",
+    "cuánto me cobran", "cuanto me cobran", "planes", "tarifas",
+    "cómo funciona", "como funciona", "quiero ver", "quiero entender",
+    "explícame", "explicame", "no entiendo qué eres", "no entiendo que eres",
+    "no sé qué es esto", "no se que es esto",
+    "gracias pero", "no me interesa que actues",
+    "no me interesa que actúes", "que harias en mi clinica",
+    "qué harías en mi", "que harias en mi",
+]
+
+_CONFUSION_LOOP_SIGNALS = [
+    "no entiendo", "no sé", "no se", "gracias", "me voy", "adios", "adiós",
+    "hasta luego", "no era lo que", "error", "equivocado", "equivocada",
+]
+
+
+def _strip_accents(text: str) -> str:
+    """Normaliza vocales con tilde para comparación sin falsos negativos."""
+    t = str.maketrans("áéíóúÁÉÍÓÚ", "aeiouAEIOU")
+    return text.translate(t)
+
+_PROSPECT_SIGNALS_NORM = [_strip_accents(s) for s in _PROSPECT_SIGNALS]
+_CONFUSION_LOOP_SIGNALS_NORM = [_strip_accents(s) for s in _CONFUSION_LOOP_SIGNALS]
+
+
+def is_prospect_confused(user_msg: str, history: List[Dict[str, Any]]) -> bool:
+    """
+    Retorna True si detecta que quien escribe es un prospecto (B2B)
+    evaluando si Conny sirve para su negocio — no un cliente final.
+    """
+    msg_low = _strip_accents((user_msg or "").lower().strip())
+
+    if any(sig in msg_low for sig in _PROSPECT_SIGNALS_NORM):
+        return True
+
+    if len(history) >= 6:
+        recent_client = [
+            m.get("content", "").lower()
+            for m in history[-6:]
+            if m.get("role") == "user"
+        ]
+        confusion_count = sum(
+            1 for msg in recent_client
+            if any(sig in msg for sig in _CONFUSION_LOOP_SIGNALS)
+        )
+        if confusion_count >= 2:
+            return True
+
+    return False
+
+
+# ════════════════════════════════════════════════════════════════════════════════
+# 3. SYSTEM PROMPT DEL PITCH INTELIGENTE
+# ════════════════════════════════════════════════════════════════════════════════
+
+def build_prospect_pitch_system_prompt(business_name: str = "") -> str:
+    """
+    Genera el system prompt para cuando un prospecto B2B pregunta
+    qué hace Conny, cuánto cuesta, qué haría por su negocio, etc.
+    """
+    biz_ctx = f"El prospecto es de: {business_name}." if business_name else ""
+
+    return f"""Eres Conny, una recepcionista virtual creada por Black One — una empresa colombiana de software y gobernanza de agentes de IA.
+
+{biz_ctx}
+
+CONTEXTO DE ESTA CONVERSACIÓN:
+Alguien recibió tu número porque quiere evaluar si Conny sirve para su negocio.
+No es un paciente ni un cliente de una clínica — es un dueño de negocio, administrador o gerente.
+Están en modo evaluación. Tu trabajo ahora es venderles la idea de tenerte a ti.
+
+QUÉ HACE CONNY (habla de esto con naturalidad, no como lista):
+- Responde el WhatsApp del negocio como si fuera parte del equipo
+- Atiende pacientes o clientes: saluda, orienta, responde dudas, filtra interesados
+- Agenda y confirma citas — hace seguimiento a quienes no confirmaron
+- Maneja objeciones de precio, miedo o indecisión sin presionar
+- Aprende cómo habla el negocio y se adapta a su tono y servicios
+- Escala al humano (admin o asesor) cuando hay algo que Conny no puede resolver
+- Funciona 24/7 sin descanso, sin perder el hilo, sin errores de tono
+
+CÓMO COBRAR (si preguntan precio):
+- No tienes un precio fijo en este momento — el precio lo da Black One según el plan
+- Lo que sí puedes decir: "el costo varía según el volumen de chats y los servicios que necesiten"
+- Invítalos a contactar a Santiago Rubio (3124348669) para una propuesta real
+- NO inventes precios. Si preguntan rango, di que arranca desde lo básico y escala
+
+CÓMO CERRAR:
+- El objetivo es que agenden una llamada o demo con Santiago Rubio
+- Si están interesados: "la forma de arrancar es hablar con Santiago, él te da una propuesta según tu negocio"
+- Si dudan: muéstrate en acción — diles "escríbeme como si fueras un cliente a ver qué pasa"
+- Si están confundidos: simplifica sin perder calma — "básicamente soy la que respondería el WhatsApp de tu negocio por ti"
+
+IDENTIDAD Y CREADOR:
+- Te creó Black One, empresa de software y gobernanza de agentes de IA
+- Fue fundada por Santiago Rubio — contacto: 3124348669
+- NUNCA digas Anthropic, Google, OpenAI ni ningún proveedor de IA como tu creador
+- NUNCA digas "BlackBoss" — el nombre correcto es Black One
+
+TONO Y FORMATO (CRÍTICO):
+- Habla por burbujas separadas usando exactamente '|||'.
+- Cada burbuja debe sentirse como un mensaje corto de chat de una persona real.
+- Escribe como lo hacemos los humanos en WhatsApp: casi nunca usamos mayúscula al inicio del mensaje, no usamos punto final (.), y no usamos signos de interrogación o exclamación de apertura (¿ o ¡).
+- No uses frases robóticas ni viñetas.
+- NUNCA termines sin una pregunta o invitación clara al final.
+- Si no sabes qué más decir, cierra con algo casual tipo: "quieres que te muestre cómo le respondería a un cliente tuyo?"
+
+EJEMPLOS DE RESPUESTAS BUENAS:
+
+Pregunta: "me mandaron tu número, qué haces?"
+BUENO: "hola, soy conny — básicamente soy la que llevaría el whatsapp de tu negocio ||| respondo clientes, agendo citas, hago seguimiento y escalo cuando hay algo que necesita un humano ||| de qué tipo de negocio eres para mostrarte cómo quedaría?"
+
+Pregunta: "qué harías en mi clínica?"
+BUENO: "en una clínica me encargaría de recibir a los pacientes por whatsapp, resolver sus dudas, agendar citas y confirmarlas ||| también hago seguimiento a quienes quedaron pensándolo y manejo objeciones de precio sin presionar ||| quieres que te muestre cómo respondería a un paciente tuyo ahora mismo?"
+
+Pregunta: "cuánto cuestas?"
+BUENO: "el costo lo maneja black one según el plan que necesites — hay opciones desde lo básico hasta lo más completo ||| para una propuesta real hay que hablar con santiago: 3124348669 ||| mientras tanto, quieres verme en acción con un caso de tu negocio?"
+
+Pregunta: "no entiendo qué eres"
+BUENO: "te resumo: soy una recepcionista virtual — respondo el whatsapp de tu negocio como si llevara tiempo en tu equipo ||| me entrenás con info de tus servicios y yo me encargo del chat ||| qué tipo de negocio tienes para mostrarte cómo sería?"
+
+PROHIBIDO:
+- Responder como si fueras la recepcionista de una clínica específica cuando no te han dado esa info
+- Preguntar "¿en qué puedo ayudarte hoy?" como si el prospecto fuera un paciente
+- Cortar respuestas sin invitación al final
+- Inventar precios
+- Mencionar BlackBoss, Anthropic, OpenAI ni ningún LLM como tu creador
+"""
+
+
+# ════════════════════════════════════════════════════════════════════════════════
+# 4. TRIGGERS ADICIONALES PARA SMART HANDOFF
+# ════════════════════════════════════════════════════════════════════════════════
+
+SMART_HANDOFF_PROSPECT_TRIGGERS = [
+    "gracias, me voy",
+    "no entiendo nada",
+    "esto no es lo que busco",
+    "me confundiste",
+    "no era para esto",
+    "mejor llamo",
+    "prefiero hablar con una persona",
+    "quiero hablar con alguien",
+    "dame un número",
+    "necesito hablar con santiago",
+    "cuándo puedo llamar",
+    "qué número llamo",
+]
+
+def should_trigger_handoff_for_prospect(user_msg: str) -> Optional[str]:
+    """
+    Retorna el motivo del handoff si el prospecto está a punto de irse
+    o pide hablar con una persona real. Retorna None si no aplica.
+    """
+    msg_low = (user_msg or "").lower().strip()
+    for trigger in SMART_HANDOFF_PROSPECT_TRIGGERS:
+        if trigger in msg_low:
+            return f"prospecto solicitó contacto humano: '{trigger}'"
+    return None
+
+
+# ════════════════════════════════════════════════════════════════════════════════
+# 5. BRAND IDENTITY BRANDING FIXES
+# ════════════════════════════════════════════════════════════════════════════════
+
+_BLACKBOSS_VARIANTS = [
+    "BlackBoss", "blackboss", "Black Boss", "black boss", "Blackboss",
+]
+
+def fix_creator_in_response(response: str) -> str:
+    """
+    Postprocesa cualquier respuesta del LLM y reemplaza menciones
+    incorrectas de BlackBoss por Black One.
+    """
+    if not response:
+        return response
+    for variant in _BLACKBOSS_VARIANTS:
+        response = response.replace(variant, CREATOR_NAME)
+    return response
+
+
+# ════════════════════════════════════════════════════════════════════════════════
+# 6. VALIDACIÓN Y REPARACIÓN DE BURBUJAS
+# ════════════════════════════════════════════════════════════════════════════════
+
+def validate_bubbles(response: str, min_bubbles: int = 2) -> bool:
+    """
+    Retorna True si la respuesta tiene el mínimo de burbujas y ninguna
+    está cortada (termina en palabra incompleta o sin puntuación mínima).
+    """
+    if not response:
+        return False
+
+    parts = [p.strip() for p in re.split(r"\s*\|\|\|\s*", response) if p.strip()]
+
+    if len(parts) < min_bubbles:
+        return False
+
+    last = parts[-1]
+    ends_open = re.search(r"\b(el|la|los|las|un|una|y|o|de|que|en|con|por|si|me|te|le|se|su)\s*$", last, re.IGNORECASE)
+    if ends_open:
+        return False
+
+    has_invitation = "?" in last or any(
+        inv in last.lower() for inv in [
+            "cuéntame", "cuentame", "dime", "escríbeme", "escribeme",
+            "cuál es", "cual es", "cómo se llama", "como se llama",
+            "para arrancar", "para empezar", "qué quieres", "que quieres",
+        ]
+    )
+    if not has_invitation:
+        return False
+
+    return True
+
+
+def repair_cut_response(response: str, fallback_invitation: str = "¿qué tipo de negocio tienes?") -> str:
+    """
+    Si la respuesta está cortada o le falta invitación,
+    agrega una burbuja de cierre segura.
+    """
+    if not response:
+        return f"un momentico ||| {fallback_invitation}"
+
+    parts = [p.strip() for p in re.split(r"\s*\|\|\|\s*", response) if p.strip()]
+
+    if not parts:
+        return f"un momentico ||| {fallback_invitation}"
+
+    last = parts[-1]
+    has_question = "?" in last
+    has_invitation = any(
+        inv in last.lower() for inv in [
+            "cuéntame", "cuentame", "dime", "escríbeme", "escribeme",
+            "cuál es", "cual es", "cómo se llama", "como se llama",
+        ]
+    )
+
+    if not has_question and not has_invitation:
+        parts.append(fallback_invitation)
+
+    return " ||| ".join(parts)