Ton mailcow garde le courrier ; cette extension donne à tes propres programmes un accès contrôlé. Crée une clé API dans l’administration mailcow, choisis les boîtes et les droits, puis appelle l’API depuis un script, un CRM ou une automatisation. Séparément, choisis les boîtes à surveiller : chaque nouveau message peut partir en JSON vers ton webhook et vers un chat Telegram.
Ce qu’il fait
- Clés API dans System → Mailbox API : droits lire, envoyer, organiser, limités aux boîtes choisies ; seul le SHA-256 est conservé, la clé n’est affichée qu’une fois.
- Lire : lister les dossiers et les messages, chercher, lire un message complet (texte, HTML, en-têtes, pièces jointes), avec pagination. Les pièces jointes sont des liens signés valables 1 heure, liés à la clé API qui peut lire la boîte.
- Envoyer : envoyer en tant que la boîte (à, cc, cci, sujet, texte ou HTML, répondre à) ; une copie va dans Envoyés.
- Organiser : lu/non lu, déplacer vers un autre dossier, supprimer.
- Webhooks : par boîte surveillée, une adresse https et un secret. Chaque nouveau message part en JSON signé
X-MLW-Signature(HMAC-SHA256, comme Stripe) ; les échecs sont réessayés avec un délai croissant et listés dans l’administration. - Telegram : un jeton de bot et un chat par boîte surveillée, avec un bouton de test.
- Tout reste sur ton serveur : la lecture passe par le login master dovecot, dans le réseau mailcow (le même mécanisme que mailcow utilise pour imapsync). Rien n’est envoyé à medialab.works ; seuls tes webhooks et chats Telegram reçoivent des données.
Prérequis
- mailcow-dockerized avec mailcow Toolkit 0.5.0 ou plus récent de MediaLab Works (produit du pack, avec sa propre licence).
- Accès root sur l’hôte pour l’installation ; le serveur doit joindre
medialab.worksen HTTPS (vérification de licence). - Pour les webhooks : un point d’accès https ; pour Telegram : un jeton de bot de @BotFather et l’id du chat par boîte.
- Open source (GPL-3.0) : code source complet.
Limites et confidentialité
- Chaque clé n’atteint que les boîtes et les droits choisis ; chaque appel est journalisé.
- L’API est désactivée jusqu’à ce que tu l’actives ; sans licence valide l’API et les notifications s’arrêtent, rien n’est supprimé.
- Le contenu des messages ne nous est jamais envoyé : il va vers ton webhook et ton chat Telegram. Les liens signés expirent après 1 heure.
- L’API ne crée, ne supprime et ne modifie aucune boîte.
Licence
Une licence par serveur mailcow, abonnement mensuel ou annuel ou à vie, avec 30 jours d’essai gratuit. Sans licence valide le module s’arrête ; les boîtes et les messages restent intacts. Voir Tarifs et le guide d’installation et d’API.