Mailbox API for mailcow

Mailcow-ul tău ține poșta; această extensie dă programelor tale o cale controlată spre ea. Faci o cheie API în pagina de administrare mailcow, alegi cutiile în care are voie să lucreze și drepturile ei, apoi apelezi API-ul dintr-un script, un CRM sau o automatizare. Separat, alegi cutiile pe care vrei să le urmărești: fiecare mesaj nou poate pleca în webhook-ul tău ca JSON și într-un chat Telegram.

Ce face

  • Chei API făcute în System → Mailbox API: fiecare cheie are drepturi — citire, trimitere, organizare — și e limitată la cutiile alese. Se păstrează doar SHA-256 al cheii; cheia se arată o singură dată, la creare.
  • Citire: listează foldere și mesaje, caută, citește mesajul complet (text, HTML, antete și atașamente), cu paginare. Atașamentele vin ca linkuri semnate (1 oră, legate de cheia API care poate citi cutia), deci se pot descărca fără a trimite cheia.
  • Trimitere: trimite un mesaj ca acea cutie poștală (către, cc, bcc, subiect, text sau HTML, reply-to); o copie se pune în Sent.
  • Organizare: marchează citit sau necitit, mută în alt folder, șterge.
  • Webhook-uri: pentru fiecare cutie monitorizată, o adresă https și un secret. Fiecare mesaj nou din folderul urmărit pleacă în JSON (de la, către, cc, subiect, dată, message id, text, HTML, antete, atașamente cu nume, tip, mărime, sha256 și link semnat), semnat cu X-MLW-Signature (HMAC-SHA256, ca la Stripe). Livrările eșuate se reîncearcă cu o pauză crescătoare și apar în pagina de administrare.
  • Telegram: un token de bot și un chat per cutie monitorizată, cu buton de test. Mesajul arată expeditorul, subiectul și primele rânduri.
  • Totul rămâne pe serverul tău: API-ul citește poșta prin login-ul master al dovecot, în rețeaua mailcow (același mecanism pe care mailcow îl folosește pentru imapsync). Nimic nu pleacă spre medialab.works; doar webhook-urile și chat-urile Telegram pe care le setezi tu primesc date.

Cerințe

  • mailcow-dockerized cu mailcow Toolkit 0.5.0 sau mai nou de la MediaLab Works instalat (produsul e unul dintre modulele pachetului, cu licența lui).
  • Acces root pe server pentru instalarea Toolkit-ului; serverul trebuie să ajungă la medialab.works prin HTTPS pentru verificarea licenței.
  • Pentru webhook-uri: un endpoint https al tău; pentru Telegram: un token de bot de la @BotFather și id-ul chatului pentru fiecare cutie.
  • Sursă deschisă (GPL-3.0): primești codul sursă complet.

Limite și confidențialitate

  • Fiecare cheie ajunge doar la cutiile și drepturile alese; fiecare apel se jurnalizează.
  • API-ul e oprit până îl pornești; fără licență validă API-ul și notificările se opresc, iar nimic nu se șterge.
  • Conținutul mesajelor nu ne este trimis niciodată: merge spre webhook-ul și chatul Telegram pe care le-ai configurat. Linkurile semnate expiră după 1 oră și sunt legate de cheia API care poate citi cutia; ca să le regenerezi, citești mesajul din nou prin API.
  • API-ul nu creează, nu șterge și nu modifică cutii poștale; lucrează doar în cutiile pe care le permiți.

Licențiere

O licență per server mailcow, abonament lunar sau anual ori lifetime, cu proba gratuită de 30 de zile. Fără licență validă modulul se oprește (pagina de administrare spune de ce); cutiile și mesajele rămân neatinse. Vezi Prețuri și ghidul de instalare și API.