---
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*