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>
364 lines
11 KiB
Markdown
364 lines
11 KiB
Markdown
---
|
|
id: MGN-021-whatsapp-business
|
|
title: Modulo WhatsApp Business con IA para Clinica Dental
|
|
type: Module
|
|
status: Draft
|
|
priority: P1
|
|
phase: 05-fase-ia
|
|
version: 1.0.0
|
|
created_date: 2026-01-13
|
|
updated_date: 2026-01-13
|
|
normativas: [NOM-013-SSA2-2015, LFPDPPP]
|
|
---
|
|
|
|
# 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:
|
|
1. Nombre del paciente
|
|
2. Nombre de la clinica
|
|
3. Fecha (ej: "Miercoles 15 de enero")
|
|
4. Hora (ej: "10:00 AM")
|
|
5. Nombre del doctor
|
|
6. 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:
|
|
1. Nombre del paciente
|
|
2. Nombre del procedimiento
|
|
3. Piezas tratadas (ej: "16, 17")
|
|
4. Nombre del doctor
|
|
5. Fecha del tratamiento
|
|
6. Proxima cita o "Pendiente de agendar"
|
|
7. Instrucciones breves de cuidado
|
|
8. 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:
|
|
1. Nombre del paciente
|
|
2. Tipo de procedimiento
|
|
3. Lista de instrucciones de cuidado
|
|
4. Medicamentos recetados
|
|
5. Sintomas de alerta
|
|
6. Telefono de emergencias
|
|
7. Fecha de seguimiento
|
|
8. 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 dentales
|
|
- `MGN-020-ai-integration` - Gateway LLM
|
|
- `MGN-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
|
|
|
|
- [ARQUITECTURA-IA.md](../../00-vision-general/ARQUITECTURA-IA.md)
|
|
- [erp-core/MGN-021-whatsapp](../../../../../erp-core/docs/05-fase-ia/MGN-021-whatsapp-business/)
|
|
- [Meta Cloud API](https://developers.facebook.com/docs/whatsapp/cloud-api)
|
|
|
|
---
|
|
|
|
*Modulo MGN-021 - WhatsApp Business | Clinica Dental*
|
|
*Propagado desde erp-core via erp-clinicas*
|
|
*Actualizado: 2026-01-13*
|