Ver Conversaciones WhatsApp
El sistema te permite consultar todas las conversaciones que los pacientes han tenido con el bot de WhatsApp. Esto es útil para:- Monitorear la actividad del bot
- Verificar que el bot está agendando citas correctamente
- Detectar conversaciones problemáticas
- Auditar interacciones con pacientes
- Analizar patrones de uso
Acceder a la Lista de Conversaciones
Paso 1: Ir a la Sección WhatsApp
1
Navega al menú principal
Desde el dashboard, haz clic en la sección “WhatsApp” en el menú lateral izquierdo.
2
Selecciona 'Conversaciones'
Dentro de la sección WhatsApp, haz clic en “Conversaciones” para ver el listado completo.
Paso 2: Entender la Vista de Conversaciones
La vista de conversaciones muestra una tabla con las siguientes columnas:| Columna | Descripción |
|---|---|
| Paciente | Nombre del paciente (si está registrado) o “Paciente Desconocido” |
| Teléfono | Número de WhatsApp en formato E.164 (+34612345678) |
| Último Mensaje | Fragmento del último mensaje enviado o recibido |
| Fecha | Timestamp del último mensaje (fecha y hora) |
| Estado | Activa, Pausada, o Finalizada |
| Mensajes | Cantidad total de mensajes en la conversación |
| Acciones | Botones para ver detalles, pausar, o enviar mensaje |
Ejemplo de Vista
Filtrar Conversaciones
Filtro por Estado
Usa el dropdown “Estado” para filtrar conversaciones por estado:- Todas
- Activas
- Pausadas
- Finalizadas
Muestra todas las conversaciones independientemente del estado.
Filtro por Fecha
Usa el selector de rango de fechas para filtrar conversaciones por período:Hoy
Hoy
Muestra solo conversaciones con mensajes de hoy.
Últimos 7 días
Últimos 7 días
Filtra conversaciones de la última semana.
Últimos 30 días
Últimos 30 días
Filtra conversaciones del último mes (opción por defecto).
Rango personalizado
Rango personalizado
Selecciona fechas específicas de inicio y fin.
Buscar por Paciente o Teléfono
Usa la barra de búsqueda para encontrar conversaciones específicas: Ejemplos de búsqueda:María- Busca por nombre de pacienteGarcía- Busca por apellido+34612- Busca por número de teléfono612345678- Busca por parte del número
Interpretar los Estados
Estado: Activa
Activa: El bot está respondiendo automáticamente a los mensajes del paciente.
- El paciente puede enviar mensajes y recibir respuestas instantáneas
- El bot procesará mensajes con LLM y herramientas
- No hay intervención manual de staff
Estado: Pausada
Pausada: El bot NO responderá automáticamente. Staff debe responder manualmente.
- El bot ignorará nuevos mensajes del paciente
- Staff debe enviar respuestas manualmente
- La conversación requiere atención humana
Estado: Finalizada
Finalizada: Conversación completada. El bot no responderá a menos que se reactive.
- La conversación alcanzó un objetivo (cita agendada, cancelación confirmada)
- O el paciente dijo explícitamente “adiós”, “gracias”, etc.
- El bot marcó la conversación como completa
Acciones Disponibles
Ver Detalles
Haz clic en el botón “Ver” o en la fila completa para:- Ver el historial completo de mensajes
- Revisar qué herramientas invocó el bot
- Ver timestamps precisos de cada mensaje
- Acceder a acciones adicionales (pausar, enviar mensaje manual)
Pausar Conversación
Haz clic en el botón “Pausar” (icono de pausa) para detener el bot en esa conversación. Resultado:- Bot dejará de responder automáticamente
- Estado cambia a “Pausada”
- Staff puede tomar control manualmente
Enviar Mensaje Manual
Haz clic en el botón “Enviar” (icono de avión de papel) para enviar un mensaje como staff. Cuándo usar:- Responder preguntas complejas que el bot no maneja
- Enviar información personalizada
- Contactar proactivamente a un paciente
- Resolver quejas o situaciones delicadas
Indicadores Visuales
Badges de Estado
El sistema usa badges de colores para indicar estado:Verde
Conversación activa (bot respondiendo)
Naranja
Conversación pausada (atención manual)
Gris
Conversación finalizada
Iconos de Mensajes Recientes
El sistema marca conversaciones con mensajes nuevos:Punto rojo junto al nombre indica que hay mensajes sin leer (recibidos en los últimos 5 minutos).
Ordenamiento de la Lista
Por defecto, las conversaciones se ordenan por última actividad (más reciente primero). Puedes cambiar el ordenamiento haciendo clic en los encabezados de columna:| Columna | Ordenamiento |
|---|---|
| Paciente | Alfabético (A-Z o Z-A) |
| Fecha | Cronológico (más reciente o más antiguo primero) |
| Mensajes | Cantidad (más mensajes o menos mensajes primero) |
Paginación
Si tienes más de 50 conversaciones, el sistema usa paginación:1
Navegación inferior
Usa los botones “Anterior” y “Siguiente” en la parte inferior de la tabla.
2
Ir a página específica
Escribe el número de página en el campo y presiona Enter.
3
Cambiar resultados por página
Usa el dropdown para mostrar 10, 25, 50, o 100 conversaciones por página.
Casos de Uso Comunes
Monitorear Actividad del Bot
Objetivo: Verificar que el bot está funcionando correctamente.1
Filtra por 'Hoy'
Selecciona el filtro de fecha “Hoy” para ver conversaciones activas.
2
Revisa estados
Verifica que la mayoría están en estado “Activa” (verde).
3
Identifica pausadas
Si hay muchas “Pausadas” (naranja), puede indicar problemas con el bot.
4
Revisa detalles de pausadas
Haz clic en conversaciones pausadas para entender por qué fallaron.
Auditar Citas Agendadas
Objetivo: Verificar que el bot agendó citas correctamente.1
Busca paciente
Usa la barra de búsqueda para encontrar al paciente.
2
Abre historial
Haz clic en “Ver” para abrir el historial completo.
3
Verifica herramientas
Busca mensajes del bot que digan “Herramienta usada: create_appointment”.
4
Confirma datos
Verifica que fecha, hora, y servicio sean correctos en la confirmación del bot.
5
Valida en calendario
Ve al calendario de citas para confirmar que la cita existe en el sistema.
Identificar Conversaciones Problemáticas
Objetivo: Detectar conversaciones donde el bot no pudo ayudar. Señales de problemas:- Conversación con 10+ mensajes sin agendar cita (paciente repite preguntas)
- Paciente usa palabras como “no entiendo”, “error”, “no funciona”
- Conversación pausada por staff
- Múltiples invocaciones de la misma herramienta (ej:
get_availability5+ veces)
- Abre el historial completo
- Identifica el mensaje donde falló
- Revisa qué herramienta invocó el bot
- Reporta el problema a equipo técnico con ID de conversación
Exportar Conversaciones
Actualmente puedes:- Copiar manualmente información de conversaciones específicas
- Tomar screenshots de la lista de conversaciones
- Contactar a soporte técnico para exportaciones manuales
Mejores Prácticas
Troubleshooting
No veo ninguna conversación
Posibles causas:- Filtros muy restrictivos: Verifica que no estés filtrando por fecha muy antigua o estado incorrecto.
- WhatsApp no activado: Verifica en configuración que WhatsApp esté activado para tu clínica.
- Sin actividad: Si es una clínica nueva, aún no hay conversaciones. Prueba enviando un mensaje desde tu WhatsApp al número del bot.
Conversación aparece como “Paciente Desconocido”
Causa: El número de WhatsApp no está registrado en la base de datos de pacientes. Qué significa:- Es la primera vez que ese número contacta la clínica
- O el paciente aún no ha agendado una cita (no tiene datos en sistema)
Todas las conversaciones aparecen como “Pausadas”
Causa probable: Configuración incorrecta de WhatsApp o problema con Twilio. Pasos para diagnosticar:- Ve a Configuración → WhatsApp
- Verifica que el estado sea “Activo” (verde)
- Verifica variables de entorno (
TWILIO_ACCOUNT_SID,TWILIO_AUTH_TOKEN) - Contacta a soporte técnico si el problema persiste