Intenciones del Bot

Cada vez que un cliente envía un mensaje, el bot lo clasifica en una intención -- es decir, determina qué quiere lograr el cliente. Esta clasificación es el primer paso del pipeline y define cómo el bot procesará y responderá al mensaje.

Cómo funciona la clasificación

El bot utiliza inteligencia artificial para analizar el mensaje del cliente junto con el historial reciente de la conversación (los últimos 5 mensajes). El resultado es:

• Una intención (una de las 8 categorías)
• Un nivel de confianza (de 0 a 1)

Si el nivel de confianza es menor a 0.70 (70%), el bot no intenta responder y automáticamente escala la conversación a un agente humano. Esto evita respuestas incorrectas o fuera de contexto.

Las 8 intenciones

1. Búsqueda de propiedad (search_property)

El cliente busca una propiedad para comprar o alquilar.

Ejemplos de mensajes:

• "Busco un apartamento de 2 habitaciones en Escazú"
• "Tienen casas en alquiler en Santa Ana?"
• "Necesito un terreno de al menos 500m2"
• "Busco algo amueblado que acepte mascotas"

Qué hace el bot:

1. Extrae los filtros de búsqueda (ubicación, precio, tipo, habitaciones, mascotas, amueblado, etc.)
2. Ejecuta una búsqueda híbrida en su inventario
3. Presenta hasta 3 propiedades con detalles y enlaces a la página de cada propiedad
4. Si hay proyectos relacionados, los menciona brevemente
5. Hace 1 pregunta de seguimiento para refinar la búsqueda

Si no encuentra propiedades después de 3 intentos consecutivos, escala automáticamente a un agente.

2. Búsqueda de proyecto (search_project)

El cliente busca información sobre proyectos de desarrollo (condominios, residenciales, plazas, torres).

Ejemplos de mensajes:

• "Qué proyectos tienen?"
• "Me interesa Torres del Valle"
• "Busco un condominio con piscina"
• "Tienen proyectos nuevos en preventa?"

Qué hace el bot:

1. Busca en el catálogo de proyectos usando búsqueda semántica
2. Presenta hasta 3 proyectos con información clave: ubicación, rango de precios, estado de construcción, amenidades y enlace al proyecto
3. Ofrece mostrar unidades disponibles dentro de los proyectos

3. Detalles de propiedad (property_details)

El cliente pregunta detalles sobre una propiedad que ya se mencionó en la conversación.

Ejemplos de mensajes:

• "Tiene parqueo?"
• "Cuánto mide el terreno?"
• "Es amueblado?"
• "Cuántos baños tiene?"

Qué hace el bot:

1. Identifica la propiedad en cuestión basándose en el historial de la conversación
2. Responde con la información disponible en la base de datos
3. Si no tiene la información solicitada, sugiere contactar a un agente

4. Agendar visita (schedule_visit)

El cliente quiere ver una propiedad en persona o agendar una cita.

Ejemplos de mensajes:

• "Puedo visitarla mañana?"
• "Quiero ver la propiedad"
• "Cuándo podemos coordinar una visita?"
• "Me gustaría conocer el proyecto"

Qué hace el bot:

1. Verifica si la conversación tiene un agente asignado
2. Consulta la disponibilidad del agente vía Google Calendar
3. Ofrece hasta 3 horarios disponibles con botones interactivos de WhatsApp
4. Si no hay agente asignado o no hay horarios disponibles, escala a un agente humano

Vea Agendar Visitas para más detalles sobre este flujo.

5. Pregunta general (general_question)

El cliente tiene una pregunta que no está directamente relacionada con búsqueda de propiedades.

Ejemplos de mensajes:

• "Cuál es el horario de atención?"
• "Qué documentos necesito para comprar?"
• "Dónde están ubicados?"
• "Cómo funciona el proceso de compra?"

Qué hace el bot:

1. Busca la respuesta en el contexto de la organización (la información que usted configuró en Ajustes > Bot)
2. Si tiene información relevante, responde directamente
3. Si no tiene la información, sugiere contactar a un agente

6. Información de financiamiento (financing_info)

El cliente pregunta sobre opciones de financiamiento, crédito hipotecario o pagos.

Ejemplos de mensajes:

• "Aceptan financiamiento?"
• "Cuál es la prima?"
• "Hacen plan de pagos?"
• "Trabajan con algún banco?"

Qué hace el bot:

1. Busca información de financiamiento en el contexto de la organización
2. Responde con la información disponible
3. Si no tiene detalles específicos, sugiere contactar a un agente para asesoramiento personalizado

7. Saludo (greeting)

El cliente envía un saludo o mensaje introductorio.

Ejemplos de mensajes:

• "Hola"
• "Buenos días"
• "Buenas tardes"
• "Buenas"

Qué hace el bot:

1. Responde con un saludo amigable
2. Se presenta como asistente de su agencia (usando el nombre de la organización)
3. Pregunta en qué puede ayudar

8. Escalamiento (escalate)

El cliente necesita o pide atención humana, o el bot no puede clasificar el mensaje con confianza.

Ejemplos de mensajes:

• "Quiero hablar con alguien"
• "No me sirve el bot"
• "Necesito hablar con un agente"
• "Estoy frustrado, necesito ayuda real"

Qué hace el bot:

1. Informa al cliente que lo conectará con un agente
2. Desactiva el bot para esa conversación
3. Marca la conversación con la etiqueta "necesita atención"
4. Intenta asignar la conversación a un agente disponible

Vea Escalamiento para más detalles.

Resumen de intenciones

Siguientes pasos

• Base de conocimiento -- Cómo funciona la búsqueda que alimenta las intenciones de propiedades y proyectos
• Agendar visitas -- Detalles del flujo de agendamiento
• Escalamiento -- Qué pasa cuando el bot transfiere a un humano