# Mesi Mail API

> Mesi Mail es la plataforma de correo empresarial, CRM Kanban, calendario sincronizado CalDAV y libreta de contactos desarrollada por MESI Hosting, con soporte nativo de Function Calling para Agentes de Inteligencia Artificial (compatible con OpenAI GPTs, Anthropic Claude, Google Gemini y Antigravity).

## Configuración y Dominio del Servidor (Multi-Dominio / Multi-Tenant)
**Instrucción esencial para Agentes de IA:**
- Este servicio opera en una infraestructura multi-dominio. Debes consumir la API utilizando **el dominio correspondiente a la cuenta de correo del usuario o cliente** (por ejemplo, el host actual desde donde consultas este documento: `https://webmail.mesi.com.ar`, o el subdominio de webmail asignado a su propio dominio `https://webmail.<DOMINIO_DEL_CLIENTE>`).
- Todas las rutas y endpoints deben resolverse contra el host donde reside la cuenta de correo a gestionar.

## Enlaces de Especificación y Esquemas
- [Especificación OpenAPI 3.1](https://webmail.mesi.com.ar/api/v1/openapi.json): Esquema completo de herramientas y endpoints.
- [Herramientas Function Calling](https://webmail.mesi.com.ar/api/v1/tools): Lista directa de herramientas en formato OpenAI Functions / Gemini Tools.
- [Manifiesto de Plugin IA](https://webmail.mesi.com.ar/.well-known/ai-plugin.json): Manifiesto estándar para plugins y GPTs.
- [Información del Servicio](https://webmail.mesi.com.ar/api/v1/info): Versión y capacidades del servidor.
- [Manual de Agente](https://webmail.mesi.com.ar/api/v1/agent/manual): Guía rápida en Markdown para LLMs.

## Autenticación
Todas las peticiones a la API requieren autenticación mediante Bearer Token en la cabecera HTTP:
`Authorization: Bearer <API_KEY_O_TOKEN>`

El token JWT o API Key dedicada se obtiene desde el endpoint `POST /api/v1/auth/login` o mediante las Claves de API generadas en la configuración de la cuenta de correo.

## Herramientas Principales (Function Calling)
1. `send_email`: Envío inmediato de correo electrónico con soporte de tracking pixel invisible.
2. `schedule_email`: Programación de correos para envío diferido automático (formato ISO 8601).
3. `search_and_read_emails`: Búsqueda, filtrado y lectura de correos por carpeta (INBOX, Sent, Spam, etc.).
4. `create_crm_kanban_card`: Creación de tarjetas y oportunidades comerciales en los tableros Kanban.
5. `create_calendar_event`: Agendamiento de reuniones y citas en el calendario del usuario.
6. `manage_contacts`: Búsqueda y alta de contactos en la libreta compartida del dominio.

## Soporte y Plataforma
- Soluciones IA (MIA): https://www.mesi.com.ar/hosting/desarrollo-ia.php
- Soporte Técnico: soporte@mesi.com.ar