Mailbox API para mailcow

Tu mailcow guarda el correo; esta extensión da a tus programas un acceso controlado. Crea una clave API en la administración de mailcow, elige los buzones y los derechos, y llama a la API desde un script, un CRM o una automatización. Por separado, elige los buzones a vigilar: cada mensaje nuevo puede ir en JSON a tu webhook y a un chat de Telegram.

Qué hace

• Claves API en System → Mailbox API: derechos leer, enviar, organizar, limitados a los buzones elegidos; solo se guarda el SHA-256 y la clave se muestra una vez.
• Leer: listar carpetas y mensajes, buscar, leer un mensaje completo (texto, HTML, cabeceras, adjuntos), con paginación. Los adjuntos son enlaces firmados válidos 1 hora, ligados a la clave API que puede leer el buzón.
• Enviar: enviar como el buzón (para, cc, cco, asunto, texto o HTML, responder a); una copia va a Enviados.
• Organizar: leído/no leído, mover a otra carpeta, borrar.
• Webhooks: por buzón vigilado, una dirección https y un secreto. Cada mensaje nuevo va en JSON firmado con X-MLW-Signature (HMAC-SHA256, como Stripe); los fallos se reintentan con espera creciente y se listan en la administración.
• Telegram: un token de bot y un chat por buzón vigilado, con botón de prueba.
• Todo queda en tu servidor: la lectura usa el login master de dovecot dentro de la red mailcow (el mismo mecanismo que mailcow usa para imapsync). Nada se envía a medialab.works; solo tus webhooks y chats de Telegram reciben datos.

Requisitos

• mailcow-dockerized con mailcow Toolkit 0.5.0 o más reciente de MediaLab Works (producto del paquete, con su propia licencia).
• Acceso root en el host para instalar; el servidor debe llegar a medialab.works por HTTPS (comprobación de licencia).
• Para webhooks: un endpoint https propio; para Telegram: un token de bot de @BotFather y el id del chat por buzón.
• Código abierto (GPL-3.0): código fuente completo.

Límites y privacidad

• Cada clave solo llega a los buzones y derechos elegidos; cada llamada se registra.
• La API está apagada hasta que la actives; sin licencia válida la API y las notificaciones se detienen y nada se borra.
• El contenido de los mensajes nunca se nos envía: va a tu webhook y a tu chat de Telegram. Los enlaces firmados caducan a los 60 minutos.
• La API no crea, borra ni modifica buzones.

Licencia

Una licencia por servidor mailcow, suscripción mensual o anual o de por vida, con 30 días de prueba gratis. Sin licencia válida el módulo se detiene; los buzones y mensajes quedan intactos. Ver Precios y la guía de instalación y API.