rckrdmrd
c4620ca4e9
- 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>
282 lines
8.4 KiB
Markdown
282 lines
8.4 KiB
Markdown
---
|
|
id: MGN-021-whatsapp-vet
|
|
title: Modulo WhatsApp Business para Clinicas Veterinarias
|
|
type: Module
|
|
status: Draft
|
|
priority: P1
|
|
phase: 05-fase-ia
|
|
version: 1.0.0
|
|
created_date: 2026-01-13
|
|
updated_date: 2026-01-13
|
|
---
|
|
|
|
# MGN-021: WhatsApp Business para Clinicas Veterinarias
|
|
|
|
> Comunicacion inteligente con propietarios de mascotas via WhatsApp
|
|
|
|
## Resumen Ejecutivo
|
|
|
|
El modulo WhatsApp Business permite a las clinicas veterinarias comunicarse con los propietarios de mascotas a traves de WhatsApp, procesando mensajes con IA para proporcionar respuestas sobre vacunacion, citas, y cuidados de mascotas.
|
|
|
|
---
|
|
|
|
## Normativas Aplicables
|
|
|
|
- **NOM-064-ZOO-2000**: No prescribir medicamentos via WhatsApp
|
|
- **SENASICA**: Recordatorios de vacunacion oficial
|
|
- **LFPDPPP**: Proteccion de datos personales de propietarios
|
|
|
|
---
|
|
|
|
## 1. Objetivos del Modulo
|
|
|
|
### 1.1 Objetivos Principales
|
|
|
|
- **Recordatorios de vacunacion**: Notificar proximas vacunas pendientes
|
|
- **Confirmacion de citas**: Confirmar asistencia a consultas
|
|
- **Consultas rapidas**: Responder dudas sobre cuidados basicos
|
|
- **Instrucciones post-operatorias**: Enviar cuidados despues de cirugias
|
|
- **Resultados de laboratorio**: Notificar cuando esten listos
|
|
|
|
### 1.2 Objetivos Secundarios
|
|
|
|
- Soporte multi-mascota por propietario
|
|
- Templates aprobados por Meta
|
|
- Trazabilidad de conversaciones
|
|
- Metricas de engagement
|
|
|
|
---
|
|
|
|
## 2. Templates de WhatsApp Veterinarios
|
|
|
|
### 2.1 recordatorio_vacuna
|
|
|
|
```
|
|
Hola {{nombre_propietario}}! 🐾
|
|
|
|
Te recordamos que {{nombre_mascota}} tiene pendiente su vacuna de {{tipo_vacuna}}.
|
|
|
|
Ultima aplicacion: {{fecha_ultima}}
|
|
Fecha recomendada: {{fecha_proxima}}
|
|
|
|
¿Te agendamos una cita?
|
|
Responde "SI" para agendar o "LLAMAR" para que te contactemos.
|
|
|
|
Clinica Veterinaria {{nombre_clinica}}
|
|
📞 {{telefono}}
|
|
```
|
|
|
|
### 2.2 confirmacion_cita_veterinaria
|
|
|
|
```
|
|
Hola {{nombre_propietario}}! 📅
|
|
|
|
Confirmamos tu cita en Clinica {{nombre_clinica}}:
|
|
|
|
🐾 Mascota: {{nombre_mascota}}
|
|
📅 Fecha: {{fecha_cita}}
|
|
🕐 Hora: {{hora_cita}}
|
|
👨⚕️ Veterinario: {{nombre_veterinario}}
|
|
📍 Direccion: {{direccion}}
|
|
|
|
Responde "CONFIRMAR" para confirmar o "CAMBIAR" para reagendar.
|
|
|
|
¡Te esperamos!
|
|
```
|
|
|
|
### 2.3 instrucciones_cuidado
|
|
|
|
```
|
|
Hola {{nombre_propietario}}! 🏥
|
|
|
|
Instrucciones de cuidado post-{{tipo_procedimiento}} para {{nombre_mascota}}:
|
|
|
|
{{instrucciones_detalladas}}
|
|
|
|
⚠️ Senales de alerta (llama inmediatamente si notas):
|
|
{{senales_alerta}}
|
|
|
|
📞 Emergencias: {{telefono_emergencia}}
|
|
|
|
¿Tienes alguna duda? Responde este mensaje.
|
|
```
|
|
|
|
### 2.4 alerta_desparasitacion
|
|
|
|
```
|
|
Hola {{nombre_propietario}}! 🐛
|
|
|
|
{{nombre_mascota}} necesita su desparasitacion de rutina.
|
|
|
|
Ultima desparasitacion: {{fecha_ultima}}
|
|
Proxima recomendada: {{fecha_proxima}}
|
|
|
|
La desparasitacion regular protege a tu mascota de parasitos internos y externos.
|
|
|
|
¿Agendamos una cita? Responde "SI"
|
|
|
|
Clinica {{nombre_clinica}}
|
|
```
|
|
|
|
### 2.5 resultados_laboratorio
|
|
|
|
```
|
|
Hola {{nombre_propietario}}! 🔬
|
|
|
|
Los resultados del laboratorio de {{nombre_mascota}} ya estan listos.
|
|
|
|
Estudio: {{tipo_estudio}}
|
|
Fecha de toma: {{fecha_muestra}}
|
|
|
|
Para revisar los resultados, puedes:
|
|
1. Agendar cita con el veterinario
|
|
2. Solicitar envio por correo electronico
|
|
|
|
Responde "CITA" o "CORREO"
|
|
|
|
Clinica {{nombre_clinica}}
|
|
```
|
|
|
|
---
|
|
|
|
## 3. Flujo de Mensaje Completo
|
|
|
|
```
|
|
+----------+ +----------+ +---------------+ +------------+
|
|
|Propietario|---->| WhatsApp |---->| Meta API |---->| Webhook |
|
|
| (movil) | | (app) | | (Cloud API) | | (Backend) |
|
|
+----------+ +----------+ +---------------+ +------------+
|
|
|
|
|
v
|
|
+------------------+
|
|
| WhatsApp Service |
|
|
| 1. Identificar |
|
|
| propietario |
|
|
| 2. Cargar |
|
|
| mascotas |
|
|
+------------------+
|
|
|
|
|
v
|
|
+------------------+
|
|
| AI Veterinaria |
|
|
| 1. System prompt |
|
|
| veterinario |
|
|
| 2. Contexto |
|
|
| mascotas |
|
|
+------------------+
|
|
|
|
|
v
|
|
+------------------+
|
|
| MCP Tools |
|
|
| - historial |
|
|
| - vacunas |
|
|
| - citas |
|
|
+------------------+
|
|
|
|
|
v
|
|
+------------------+
|
|
| Respuesta |
|
|
| Veterinaria |
|
|
+------------------+
|
|
```
|
|
|
|
---
|
|
|
|
## 4. Integracion con MCP Tools
|
|
|
|
### Herramientas Disponibles para WhatsApp
|
|
|
|
| Tool | Descripcion | Ejemplo de Uso |
|
|
|------|-------------|----------------|
|
|
| `consultar_historial_mascota` | Expediente clinico | "¿Que tiene Max registrado?" |
|
|
| `registrar_vacuna` | Registrar vacuna | (Solo por staff, no propietario) |
|
|
| `agendar_consulta` | Programar cita | "Quiero agendar cita para Luna" |
|
|
| `consultar_cartilla_vacunacion` | Ver vacunas | "¿Que vacunas tiene mi gato?" |
|
|
| `verificar_desparasitacion` | Estado desparasitacion | "¿Cuando toca desparasitar?" |
|
|
|
|
---
|
|
|
|
## 5. System Prompt para WhatsApp Veterinario
|
|
|
|
```
|
|
Eres el asistente de WhatsApp de {{CLINICA_NAME}}, clinica veterinaria.
|
|
|
|
El propietario {{PROPIETARIO_NOMBRE}} tiene las siguientes mascotas registradas:
|
|
{{LISTA_MASCOTAS}}
|
|
|
|
PUEDES:
|
|
- Informar sobre vacunas pendientes
|
|
- Agendar citas
|
|
- Dar instrucciones de cuidado basico
|
|
- Consultar el expediente de sus mascotas
|
|
- Responder sobre horarios y servicios
|
|
|
|
NO PUEDES:
|
|
- Diagnosticar enfermedades
|
|
- Prescribir medicamentos
|
|
- Dar consejos medicos especificos
|
|
|
|
ESTILO:
|
|
- Espanol mexicano, amigable
|
|
- Usa emojis moderadamente (🐾 🐶 🐱 📅 💉)
|
|
- Respuestas cortas y claras
|
|
- Si no sabes algo, ofrece contactar al veterinario
|
|
|
|
EMERGENCIAS:
|
|
Si el propietario describe una emergencia, responde:
|
|
"🚨 Esto suena como una emergencia. Por favor llama inmediatamente al {{TELEFONO_EMERGENCIA}} o acude a la clinica."
|
|
```
|
|
|
|
---
|
|
|
|
## 6. Disponibilidad por Plan
|
|
|
|
| Plan | WhatsApp | Mensajes/mes | Templates |
|
|
|------|----------|--------------|-----------|
|
|
| Basico | No | - | - |
|
|
| Profesional | Si | 1,000 | Basicos |
|
|
| Clinica | Si | 5,000 | Todos |
|
|
| Hospital | Si | Ilimitados | Todos + Custom |
|
|
|
|
---
|
|
|
|
## 7. Metricas de Exito
|
|
|
|
| Metrica | Target | Medicion |
|
|
|---------|--------|----------|
|
|
| Tasa de respuesta | > 90% | Mensajes respondidos < 5 min |
|
|
| Confirmacion citas | > 70% | Citas confirmadas via WhatsApp |
|
|
| Satisfaccion | > 4.0/5.0 | Encuestas post-interaccion |
|
|
| Costo por mensaje | < $0.10 MXN | Costo Meta + IA |
|
|
|
|
---
|
|
|
|
## Dependencias
|
|
|
|
### Internas
|
|
|
|
- `MGN-020-ai-integration` - Procesamiento con IA
|
|
- `MGN-022-mcp-server` - Herramientas veterinarias
|
|
- `MGN-017-plans` - Limites por plan
|
|
|
|
### Externas
|
|
|
|
- Meta Cloud API (WhatsApp Business)
|
|
- OpenRouter (Gateway LLM)
|
|
|
|
---
|
|
|
|
## Indices
|
|
|
|
- [Requerimientos](./requerimientos/INDICE-RF-WHATSAPP.md)
|
|
- [Especificaciones](./especificaciones/INDICE-ET-WHATSAPP.md)
|
|
- [Historias de Usuario](./historias-usuario/INDICE-US-WHATSAPP.md)
|
|
- [Trazabilidad](./implementacion/TRACEABILITY.yml)
|
|
|
|
---
|
|
|
|
*Modulo: MGN-021-whatsapp-business-vet*
|
|
*Propagado desde: erp-core/MGN-021-whatsapp-business*
|
|
*Adaptado para: Dominio veterinario*
|
|
*Creado: 2026-01-13*
|