# Manual de Operación: WhatsApp AI Bot

Esta guía explica el funcionamiento lógico y las capacidades de interacción del bot de WhatsApp integrado con inteligencia artificial (Google Gemini).

##  1. Lógica de Funcionamiento e IA

El bot no solo responde mensajes, sino que procesa el flujo de la conversación mediante tres pilares:

### A. Memoria Dinámica (Contexto)

El bot mantiene un historial de los **últimos 10 mensajes** por cada chat. Esto le permite:

-   Entender referencias como "él", "eso" o "lo que dijimos antes".
    
-   Seguir hilos de conversación complejos.
    
-   Diferenciar entre lo que dicen los usuarios y lo que responde él mismo.
    

### B. Escucha Pasiva

El bot está en modo "aprendizaje" constante. Incluso si no se le hace una pregunta directa, guarda los mensajes de texto plano en su memoria local. Cuando finalmente se le consulta algo, utiliza esos mensajes previos para dar una respuesta informada.

### C. Procesamiento de Consultas

Cuando recibe una instrucción, el bot envía a la IA un **"Prompt Maestro"** que incluye:

1.  Una instrucción de personalidad (asistente útil).
    
2.  El bloque de historial reciente del grupo.
    
3.  La pregunta actual del usuario.
    

----------

##  2. Interacción en WhatsApp

El bot reacciona a comandos específicos dentro de los chats autorizados. Cualquier mensaje que **no** empiece con / será guardado silenciosamente en el historial para dar contexto.

| Comando | Acción del Bot | Respuesta |
| :--- | :--- | :--- |
| `/bot` | Saludo de cortesía. | "¡Hola! Usa `/consulta` para hablar conmigo." |
| `/info` | Identificación técnica. | Envía el ID del chat actual (JID). |
| `/consulta [texto]` | Activación de IA. | El bot reacciona con un 🧠 y genera una respuesta basada en el historial. |

### Ejemplo de flujo:

1.  **Usuario A:** "Mañana tenemos la revisión del servidor a las 3 PM." (El bot lo guarda en memoria).
    
2.  **Usuario B:**  /consulta ¿A qué hora es la reunión de mañana?
    
3.  **Bot:** "La revisión del servidor está programada para las 3 PM."
    

----------

## 3. Métodos de la API (Integración Externa)

El bot expone una interfaz HTTP para que sistemas externos puedan enviar mensajes automáticamente a los grupos de WhatsApp sin intervención humana.

### A. Mensajería General

Se utiliza para enviar anuncios o recordatorios generales.

-   **URL:**  POST /send-message
    
-   **Cuerpo (JSON):**
    

codeJSON

```
{
  "message": "Escriba aquí el mensaje que desea difundir"
}
```

### B. Notificaciones de Monitoreo (Zabbix)

Diseñado específicamente para alertas técnicas. Al recibir un mensaje por esta vía, el bot también lo añade a su memoria para poder responder preguntas sobre fallos técnicos más tarde.

-   **URL:**  POST /zabbix
    
-   **Cuerpo (JSON):**
    

codeJSON

```
{
  "message": "⚠️ CRITICAL: Fallo de conexión en Base de Datos Principal"
}
```

### Estados de Respuesta de la API:

-   **200 OK:** El mensaje fue enviado exitosamente a los grupos.
    
-   **400 Bad Request:** El cuerpo del JSON no contiene el campo message.
    
-   **503 Service Unavailable:** El bot está desconectado de WhatsApp o el servidor está iniciando.
    

----------

##  Notas de Uso

-   **Reacciones:** Cuando el bot está "pensando" una respuesta de IA, colocará una reacción de cerebro (🧠) en tu mensaje.
    
-   **Límite de Historial:** Si la conversación es muy larga, el bot olvidará los mensajes más antiguos (solo conserva los 10 más recientes) para mantener la precisión de la IA.
    
-   **Texto Seguro:** El bot solo procesa mensajes de texto; actualmente no analiza imágenes, audios o archivos adjuntos en el historial de contexto.