Problemas del Bot
El bot no responde, da resultados incorrectos, escala demasiado o responde en el idioma equivocado.
Problemas del Bot
El asistente de IA de Trochai procesa los mensajes entrantes de WhatsApp, busca propiedades relevantes y genera respuestas automáticas. Esta guía le ayuda a diagnosticar problemas cuando el bot no se comporta como se espera.
El bot no responde a los mensajes
Si el contacto envía un mensaje por WhatsApp y el bot no genera ninguna respuesta, revise los siguientes puntos en orden:
Verificar que el bot está habilitado globalmente
El bot tiene un interruptor principal a nivel de organización. Vaya a Configuración > Bot y confirme que el bot está activado.
Si el interruptor está desactivado, el bot no responderá a ninguna conversación, independientemente de la configuración individual.
Verificar que el bot está habilitado en la conversación
Cada conversación tiene su propio interruptor de bot en la barra de herramientas. Abra la conversación en la bandeja de entrada y verifique que el toggle del bot está encendido.
El bot se desactiva automáticamente en una conversación cuando:
- Un agente responde manualmente (el bot se pausa para no interferir).
- Alguien responde desde la app de WhatsApp Business directamente (coexistencia).
- El bot escala la conversación a un agente humano.
- Un agente desactiva el bot manualmente.
Para reactivarlo, haga clic en el toggle del bot en la barra de herramientas de la conversación.
Verificar el límite de mensajes de IA
El bot consume mensajes de IA de su plan. Si su cuota mensual se agotó y no tiene paquetes de créditos adicionales, el bot dejará de responder.
Vaya a Configuración > Facturación y revise el uso de mensajes de IA. Los límites por plan son:
| Plan | Mensajes de IA por mes |
|---|---|
| Solo | 500 |
| Pro | 2,500 |
| Enterprise | 10,000 |
Si alcanzó el límite, puede comprar un paquete de créditos o esperar al próximo ciclo de facturación.
Verificar el debounce de mensajes
El bot espera 30 segundos de silencio después del último mensaje del contacto antes de generar una respuesta. Esto es intencional: agrupa múltiples mensajes consecutivos en una sola respuesta para evitar responder a mensajes incompletos.
Si el contacto está escribiendo múltiples mensajes seguidos, el bot esperará hasta que deje de escribir. El tiempo máximo de espera es de 3 minutos desde el primer mensaje.
Verificar que el mensaje es de texto
El bot solo procesa mensajes de texto. Los mensajes de imagen, video, audio, documentos, stickers y ubicaciones no activan al bot. Si el contacto envió solo una foto o un audio, el bot no responderá.
Verificar la ventana de 24 horas
El bot solo puede enviar mensajes de texto libre. Si la ventana de 24 horas está cerrada (escenario muy raro, ya que el contacto acaba de escribir), el bot no podrá enviar su respuesta. Consulte Problemas con la Ventana de 24h para más información.
El bot da resultados de búsqueda incorrectos
Si el bot responde pero sugiere propiedades que no coinciden con lo que el contacto pidió, el problema puede estar en los datos o en los embeddings.
Verificar los datos de las propiedades
El bot busca propiedades usando una combinación de filtros estructurados (precio, ubicación, habitaciones) y búsqueda semántica (embeddings de IA). Si la información de las propiedades está incompleta, la búsqueda será menos precisa.
Asegurese de que las propiedades en su inventario tengan:
- Categoría correcta (casa, apartamento, lote, etc.)
- Ubicación completa (provincia, cantón, distrito)
- Precio actualizado
- Número de habitaciones y baños
- Descripción detallada que incluya las características más relevantes
- Amenidades seleccionadas
Verificar los embeddings
Los embeddings son representaciones numéricas del contenido de sus propiedades que el bot usa para la búsqueda semántica. Se generan automáticamente cuando usted crea o edita una propiedad.
Si sospecha que los embeddings están desactualizados:
- Edite la propiedad en cuestión (puede hacer un cambio menor en la descripción).
- Guarde los cambios. Esto regenera automáticamente el embedding de esa propiedad.
Cuando actualiza un proyecto, los embeddings de todas las propiedades asociadas a ese proyecto se regeneran automáticamente. Esto asegura que la información del proyecto (amenidades, estado de construcción, desarrollador) se refleje en las búsquedas de propiedades.
La búsqueda no encuentra propiedades que existen
Si la búsqueda devuelve cero resultados aunque usted tiene propiedades que deberían coincidir:
- Verifique que la propiedad está activa. Solo las propiedades con estado "activa" aparecen en los resultados del bot.
- Revise los filtros de ubicación. Si el contacto pide propiedades en "Escazú" pero la propiedad está registrada como "San Rafael de Escazú", la búsqueda por filtro exacto podría no encontrarla. La búsqueda semántica debería manejar estos casos, pero funciona mejor con datos completos.
- El bot escala después de 3 búsquedas vacías. Si el bot no encuentra propiedades en 3 intentos consecutivos para una misma conversación, escala automáticamente la conversación a un agente humano.
El bot escala demasiado (o muy poco)
Escala demasiado
El bot escala a un agente humano en los siguientes casos:
- El contacto pide hablar con un humano o el bot clasifica la intención como "escalación".
- La confianza en la clasificación de intención es baja.
- No se encontraron propiedades en 3 o más búsquedas consecutivas.
- El contacto quiere agendar una visita pero no hay agentes o horarios disponibles.
- Se alcanzó el límite de mensajes de IA del plan.
Si el bot escala con demasiada frecuencia, revise:
- Que sus propiedades tengan datos completos y detallados.
- Que las instrucciones personalizadas del bot (si las tiene configuradas en su plan Pro o Enterprise) sean claras y no contengan indicaciones contradictorias.
No escala cuando debería
Si el bot sigue respondiendo cuando el contacto claramente necesita un agente, tenga en cuenta que el bot está diseñado para intentar resolver la consulta primero. El contacto puede escribir frases como "quiero hablar con una persona" o "necesito un agente" para activar la escalación manualmente.
El bot responde en el idioma equivocado
El bot responde por defecto en español. El idioma del bot se configura a nivel de organización.
Si el bot está respondiendo en un idioma diferente al esperado:
- Vaya a Configuración > Bot.
- Verifique el idioma configurado para el bot.
- Ajuste el idioma si es necesario.
El bot puede detectar el idioma del contacto y adaptar su respuesta si está configurado para hacerlo mediante instrucciones personalizadas. Esta funcionalidad está disponible en los planes Pro y Enterprise.
El bot tarda mucho en responder
El tiempo de respuesta del bot depende de varios factores:
- Debounce de 30 segundos: El bot espera 30 segundos de silencio antes de generar una respuesta. Esto es normal.
- Procesamiento de IA: La generación de la respuesta toma entre 2-5 segundos adicionales dependiendo de la complejidad de la consulta.
- Búsqueda de propiedades: Si el bot necesita buscar propiedades, esto agrega 1-2 segundos.
En total, el tiempo normal de respuesta del bot es de 32 a 38 segundos después del último mensaje del contacto. Si el bot tarda más de un minuto, puede haber un problema temporal con el servicio de IA.
Siguientes pasos
- Para configurar el bot, consulte la sección de Configuración del Bot.
- Para entender cómo funciona el bot internamente, consulte Cómo Funciona el Bot.
- Si el bot no responde por falta de créditos, consulte Paquetes de Créditos.
- Si el bot no responde y sospecha un problema de conexión, consulte Problemas de Conexión.