{"components":{"securitySchemes":{"BearerAuth":{"bearerFormat":"JWT","scheme":"bearer","type":"http"}}},"info":{"description":"API y herramientas de correo, CRM Kanban, calendario y libreta de contactos de Mesi Mail para Agentes de Inteligencia Artificial (compatible con Gemini, OpenAI, Claude y Antigravity).","title":"Mesi Mail API","version":"1.0.0"},"openapi":"3.1.0","paths":{"/api/v1/calendar/events":{"post":{"description":"Agendar una reunión, cita o evento en el calendario del usuario o del dominio.","operationId":"create_calendar_event","requestBody":{"content":{"application/json":{"schema":{"properties":{"attendees":{"items":{"type":"string"},"type":"array"},"end":{"type":"string"},"location":{"type":"string"},"start":{"type":"string"},"title":{"type":"string"}},"required":["title","start","end"],"type":"object"}}},"required":true},"responses":{"200":{"description":"Evento agendado exitosamente"}},"summary":"Agendar reunión en calendario"}},"/api/v1/contacts":{"post":{"description":"Crea o busca contactos en la libreta compartida del dominio.","operationId":"manage_contacts","requestBody":{"content":{"application/json":{"schema":{"properties":{"action":{"enum":["create","search"],"type":"string"},"email":{"type":"string"},"name":{"type":"string"},"organization":{"type":"string"},"phone":{"type":"string"}},"required":["action"],"type":"object"}}},"required":true},"responses":{"200":{"description":"Contacto gestionado exitosamente"}},"summary":"Gestionar contactos"}},"/api/v1/kanban/card":{"post":{"description":"Crea una nueva tarjeta o lead en un tablero Kanban del CRM de la empresa.","operationId":"create_crm_kanban_card","requestBody":{"content":{"application/json":{"schema":{"properties":{"amount":{"type":"number"},"board_id":{"type":"integer"},"column_id":{"type":"integer"},"contact_email":{"type":"string"},"description":{"type":"string"},"priority":{"enum":["low","medium","high","urgent"],"type":"string"},"title":{"type":"string"}},"required":["title"],"type":"object"}}},"required":true},"responses":{"200":{"description":"Tarjeta creada exitosamente"}},"summary":"Crea una tarjeta o lead en CRM Kanban"}},"/api/v1/messages":{"get":{"description":"Busca y lista correos en una carpeta con filtros opcionales de búsqueda o no leídos.","operationId":"search_and_read_emails","parameters":[{"in":"query","name":"folder","required":false,"schema":{"type":"string"}},{"in":"query","name":"q","required":false,"schema":{"type":"string"}},{"in":"query","name":"page","required":false,"schema":{"type":"integer"}},{"in":"query","name":"limit","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Lista de mensajes"}},"summary":"Busca y lista correos"}},"/api/v1/messages/schedule":{"post":{"description":"Programa un correo electrónico para ser enviado automáticamente en una fecha y hora futura.","operationId":"schedule_email","requestBody":{"content":{"application/json":{"schema":{"properties":{"body_html":{"type":"string"},"send_at":{"description":"ISO 8601","type":"string"},"subject":{"type":"string"},"to":{"items":{"type":"string"},"type":"array"}},"required":["to","subject","body_html","send_at"],"type":"object"}}},"required":true},"responses":{"200":{"description":"Correo programado exitosamente"}},"summary":"Programa un correo electrónico"}},"/api/v1/messages/send":{"post":{"description":"Envía un correo electrónico de inmediato a uno o varios destinatarios con seguimiento opcional de lectura.","operationId":"send_email","requestBody":{"content":{"application/json":{"schema":{"properties":{"body_html":{"description":"Cuerpo en formato HTML","type":"string"},"subject":{"description":"Asunto","type":"string"},"to":{"description":"Destinatarios","items":{"type":"string"},"type":"array"},"track_pixel":{"description":"Activa seguimiento","type":"boolean"}},"required":["to","subject","body_html"],"type":"object"}}},"required":true},"responses":{"200":{"description":"Correo enviado con éxito"}},"summary":"Envía un correo electrónico de inmediato"}}},"security":[{"BearerAuth":[]}],"servers":[{"description":"Servidor Mesi Mail","url":"https://webmail.mesi.com.ar"}],"tools":[{"function":{"description":"Envía un correo electrónico de inmediato a uno o varios destinatarios con seguimiento opcional de lectura.","name":"send_email","parameters":{"properties":{"body_html":{"description":"Cuerpo del correo en formato HTML","type":"string"},"subject":{"description":"Asunto del mensaje","type":"string"},"to":{"description":"Lista de direcciones de correo electrónico de los destinatarios principales","items":{"type":"string"},"type":"array"},"track_pixel":{"description":"Activa el pixel invisible de seguimiento de lectura (por defecto true)","type":"boolean"}},"required":["to","subject","body_html"],"type":"object"}},"type":"function"},{"function":{"description":"Programa un correo electrónico para ser enviado automáticamente en una fecha y hora futura.","name":"schedule_email","parameters":{"properties":{"body_html":{"description":"Contenido del mensaje en HTML","type":"string"},"send_at":{"description":"Fecha y hora de envío en formato ISO 8601 (ej: 2026-09-28T10:00:00-03:00)","type":"string"},"subject":{"description":"Asunto del mensaje","type":"string"},"to":{"description":"Lista de destinatarios","items":{"type":"string"},"type":"array"}},"required":["to","subject","body_html","send_at"],"type":"object"}},"type":"function"},{"function":{"description":"Busca y lista correos en una carpeta (ej: INBOX, Sent, Spam) con filtros opcionales de búsqueda o no leídos.","name":"search_and_read_emails","parameters":{"properties":{"folder":{"description":"Nombre de la carpeta (INBOX por defecto)","type":"string"},"limit":{"description":"Cantidad de mensajes por página (máximo 50)","type":"integer"},"page":{"description":"Número de página a consultar","type":"integer"},"q":{"description":"Texto de búsqueda libre (asunto, remitente o contenido)","type":"string"}},"type":"object"}},"type":"function"},{"function":{"description":"Crea una nueva tarjeta o lead en un tablero Kanban del CRM de la empresa.","name":"create_crm_kanban_card","parameters":{"properties":{"amount":{"description":"Monto económico estimado de la oportunidad","type":"number"},"board_id":{"description":"ID del tablero Kanban (0 para el tablero predeterminado)","type":"integer"},"column_id":{"description":"ID de la columna del tablero (ej: Nuevos Leads, Presupuestos)","type":"integer"},"contact_email":{"description":"Correo del cliente vinculado al lead","type":"string"},"description":{"description":"Descripción detallada, notas o resumen del requerimiento","type":"string"},"priority":{"description":"Prioridad de la tarjeta","enum":["low","medium","high","urgent"],"type":"string"},"title":{"description":"Título de la tarjeta o nombre del lead","type":"string"}},"required":["title"],"type":"object"}},"type":"function"},{"function":{"description":"Agendar una reunión, cita o evento en el calendario del usuario o del dominio.","name":"create_calendar_event","parameters":{"properties":{"attendees":{"description":"Lista de correos electrónicos de los invitados","items":{"type":"string"},"type":"array"},"end":{"description":"Fecha y hora de fin (formato ISO 8601)","type":"string"},"location":{"description":"Lugar o enlace de la reunión (Meet / Zoom)","type":"string"},"start":{"description":"Fecha y hora de inicio (formato ISO 8601)","type":"string"},"title":{"description":"Título o asunto de la reunión","type":"string"}},"required":["title","start","end"],"type":"object"}},"type":"function"},{"function":{"description":"Crea o busca contactos en la libreta de direcciones compartida del dominio.","name":"manage_contacts","parameters":{"properties":{"action":{"description":"Acción a realizar","enum":["create","search"],"type":"string"},"email":{"description":"Correo electrónico del contacto","type":"string"},"name":{"description":"Nombre del contacto","type":"string"},"organization":{"description":"Empresa del contacto","type":"string"},"phone":{"description":"Teléfono de contacto","type":"string"}},"required":["action"],"type":"object"}},"type":"function"}]}