rckrdmrd
27b4e7bccf
- Update docs/_MAP.md with new phase references - Add docs/04-fase-saas/ phase structure - Add docs/05-fase-ia/ phase structure Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
11 KiB
11 KiB
| id | title | type | status | priority | phase | version | created_date | updated_date | normativas | ||
|---|---|---|---|---|---|---|---|---|---|---|---|
| MGN-021-whatsapp-business | Modulo WhatsApp Business con IA para Clinica Dental | Module | Draft | P1 | 05-fase-ia | 1.0.0 | 2026-01-13 | 2026-01-13 |
|
MGN-021: WhatsApp Business con IA para Clinica Dental
Integracion de WhatsApp Business API con procesamiento inteligente para comunicacion con pacientes
Resumen Ejecutivo
El modulo WhatsApp Business permite a las clinicas dentales comunicarse con sus pacientes a traves de WhatsApp, procesando mensajes entrantes con inteligencia artificial para proporcionar respuestas contextuales sobre citas, tratamientos, instrucciones de cuidado y ejecutar acciones de negocio automaticamente.
1. Objetivos del Modulo
1.1 Objetivos Principales
- Recepcion de mensajes: Webhook para recibir mensajes de pacientes via Meta Cloud API
- Procesamiento inteligente: Analisis con LLM especializado en odontologia
- Ejecucion de acciones: Uso de herramientas MCP para consultar citas, odontogramas
- Respuestas automaticas: Generacion de respuestas en espanol mexicano profesional
- Trazabilidad: Registro completo de conversaciones y acciones
1.2 Objetivos Secundarios
- Soporte multi-clinica (un numero por clinica)
- Templates pre-aprobados por Meta
- Recordatorios automaticos de citas
- Dashboard de conversaciones
- Metricas de respuesta
2. Alcance
2.1 Incluido
| Caracteristica | Descripcion | Prioridad |
|---|---|---|
| Recepcion mensajes | Webhook Meta + almacenamiento | P0 |
| Procesamiento LLM | Analisis con Claude/GPT | P0 |
| Herramientas MCP | Citas, Odontograma, Tratamientos | P0 |
| Envio respuestas | API Meta para texto | P0 |
| Templates dentales | Mensajes pre-aprobados | P1 |
| Audio (voz) | Transcripcion con Whisper | P1 |
| Imagenes | Recepcion de radiografias | P2 |
| UI Bandeja | Dashboard de conversaciones | P1 |
2.2 Excluido (Futuro)
- Chatbots de otras plataformas
- Llamadas de voz
- Pagos dentro de WhatsApp
- Envio de radiografias via WhatsApp
3. Flujo de Mensaje Completo
+----------+ +----------+ +---------------+ +------------+
| Paciente |---->| WhatsApp |---->| Meta API |---->| Webhook |
| (movil) | | (app) | | (Cloud API) | | (Backend) |
+----------+ +----------+ +---------------+ +------------+
|
v
+------------------+
| WhatsApp Service |
| 1. Verificar |
| 2. Extraer clinica|
| 3. Guardar msg |
+------------------+
|
v
+------------------+
| LLM Service |
| 1. Cargar ctx |
| 2. System prompt |
| (dental) |
| 3. Llamar modelo |
+------------------+
|
v
+------------------+
| MCP Server |
| Tools dentales: |
| - consultar_cita |
| - ver_odontograma|
| - agendar_cita |
+------------------+
|
v
+------------------+
| LLM Service |
| 4. Generar resp |
| en espanol |
+------------------+
|
v
+----------+ +----------+ +---------------+ +------------+
| Paciente |<----| WhatsApp |<----| Meta API |<----| WA Service |
| (movil) | | (app) | | (send msg) | | (responde) |
+----------+ +----------+ +---------------+ +------------+
4. Templates WhatsApp para Clinica Dental
4.1 Recordatorio de Cita (recordatorio_cita_dental)
Hola {{1}}, te recordamos tu cita en {{2}}:
Fecha: {{3}}
Hora: {{4}}
Doctor(a): {{5}}
Tratamiento: {{6}}
Por favor confirma tu asistencia respondiendo SI o reprogramar respondiendo CAMBIAR.
Si tienes alguna duda, estamos para ayudarte.
Variables:
- Nombre del paciente
- Nombre de la clinica
- Fecha (ej: "Miercoles 15 de enero")
- Hora (ej: "10:00 AM")
- Nombre del doctor
- Tipo de tratamiento
4.2 Confirmacion de Tratamiento (confirmacion_tratamiento)
{{1}}, tu tratamiento ha sido registrado:
Procedimiento: {{2}}
Pieza(s) dental(es): {{3}}
Doctor(a): {{4}}
Fecha: {{5}}
Proxima cita: {{6}}
{{7}}
Cualquier duda sobre los cuidados, escribenos.
Clinica {{8}}
Variables:
- Nombre del paciente
- Nombre del procedimiento
- Piezas tratadas (ej: "16, 17")
- Nombre del doctor
- Fecha del tratamiento
- Proxima cita o "Pendiente de agendar"
- Instrucciones breves de cuidado
- Nombre de la clinica
4.3 Instrucciones Postoperatorio (instrucciones_postoperatorio)
{{1}}, instrucciones despues de tu {{2}}:
{{3}}
Medicamentos:
{{4}}
IMPORTANTE: Si presentas {{5}}, acude de inmediato o llama a {{6}}.
Recuerda tu cita de seguimiento el {{7}}.
Clinica {{8}} - Cuidamos tu sonrisa
Variables:
- Nombre del paciente
- Tipo de procedimiento
- Lista de instrucciones de cuidado
- Medicamentos recetados
- Sintomas de alerta
- Telefono de emergencias
- Fecha de seguimiento
- Nombre de la clinica
5. Integracion con MCP Dental
5.1 Herramientas Disponibles
El LLM tiene acceso a herramientas especializadas en odontologia:
| Herramienta | Descripcion | Uso |
|---|---|---|
consultar_odontograma |
Ver estado de piezas dentales | Cuando paciente pregunta sobre dientes |
consultar_historial_dental |
Historial de tratamientos | Preguntas sobre tratamientos previos |
agendar_cita_dental |
Programar nueva cita | Solicitudes de cita |
verificar_disponibilidad |
Horarios disponibles | Antes de agendar |
consultar_cita_proxima |
Proxima cita del paciente | Preguntas sobre citas |
cancelar_reprogramar_cita |
Modificar cita existente | Cambios de cita |
5.2 Ejemplo de Interaccion
Paciente: "Hola, necesito saber cuando es mi proxima cita"
LLM piensa: Necesito consultar las citas del paciente
LLM llama: consultar_cita_proxima({ paciente_telefono: "+521234567890" })
MCP retorna: {
"fecha": "2026-01-15",
"hora": "10:00",
"doctor": "Dra. Garcia",
"tratamiento": "Limpieza dental",
"sillon": 2
}
LLM responde: "Hola! Tu proxima cita es el miercoles 15 de enero a las 10:00 AM
con la Dra. Garcia para una limpieza dental. Te esperamos!"
6. System Prompts Dentales
6.1 Para Pacientes
Eres el asistente virtual de {{CLINICA_DENTAL}}, una clinica dental en Mexico.
Ayudas a los pacientes con:
- Informacion sobre tratamientos dentales
- Agendar, confirmar o reprogramar citas
- Consultar proximas citas
- Dudas sobre cuidados bucales
- Instrucciones pre y post operatorias
Reglas:
1. Responde en espanol mexicano profesional pero calido
2. Se breve y claro
3. NUNCA diagnostiques - recomienda siempre visita al odontologo
4. Para urgencias (dolor intenso, sangrado, trauma), indica acudir de inmediato
5. Usa las herramientas MCP para consultar informacion real
6. No inventes datos de citas o tratamientos
7. Respeta la confidencialidad del expediente
8. Si no puedes ayudar, ofrece comunicar con recepcion
6.2 Para Staff de Clinica
Eres el asistente de {{CLINICA_DENTAL}} para el equipo de trabajo.
Ayudas al staff con:
- Consulta rapida de agenda
- Estado de citas del dia
- Recordatorios pendientes
- Busqueda de pacientes
Se directo, profesional y eficiente.
Proporciona informacion precisa usando las herramientas MCP.
7. Estructura del Modulo
docs/05-fase-ia/MGN-021-whatsapp-business/
+-- README.md <- Este archivo
+-- _MAP.md <- Indice del modulo
+-- requerimientos/
| +-- INDICE-RF-WHATSAPP.md
| +-- RF-WHATSAPP-001.md <- Recepcion de mensajes
| +-- RF-WHATSAPP-002.md <- Procesamiento con LLM
| +-- RF-WHATSAPP-003.md <- Templates dentales
+-- especificaciones/
| +-- INDICE-ET-WHATSAPP.md
| +-- ET-WHATSAPP-DATABASE.md <- Modelo de datos
| +-- ET-WHATSAPP-BACKEND.md <- Servicios y webhook
| +-- ET-WHATSAPP-FRONTEND.md <- UI de conversaciones
+-- historias-usuario/
| +-- INDICE-US-WHATSAPP.md
+-- implementacion/
+-- TRACEABILITY.yml
8. Dependencias
8.1 Internas
MGN-022-mcp-server- Herramientas MCP dentalesMGN-020-ai-integration- Gateway LLMMGN-017-plans- Feature gating (solo Centro Dental)
8.2 Externas
- Meta Cloud API (WhatsApp Business)
- OpenRouter (Gateway LLM)
- Whisper API (transcripcion de audio)
9. Normativas y Privacidad
9.1 NOM-013-SSA2-2015
- No proporcionar diagnosticos via WhatsApp
- Registrar interacciones relacionadas con tratamientos
- Mantener trazabilidad de comunicaciones
9.2 LFPDPPP (Datos Personales)
- Expediente clinico es dato sensible
- Requerir consentimiento para comunicacion via WhatsApp
- No almacenar radiografias recibidas sin cifrar
- Anonimizar logs para analytics
9.3 Reglas de Confidencialidad
- No compartir informacion de un paciente con otro
- No enviar resultados de estudios sin confirmar identidad
- Mensajes deben ser leidos solo por destinatario
10. Metricas de Exito
| Metrica | Target | Medicion |
|---|---|---|
| Tiempo de respuesta | < 5 segundos | P95 latencia |
| Tasa de resolucion | > 70% | Mensajes resueltos sin staff |
| Satisfaccion | > 4.0/5.0 | Encuestas post-chat |
| Costo por mensaje | < $0.02 USD | Tokens LLM + API Meta |
| Citas agendadas via WA | > 30% | Del total de citas |
Referencias
Modulo MGN-021 - WhatsApp Business | Clinica Dental Propagado desde erp-core via erp-clinicas Actualizado: 2026-01-13