Il potere delle estensioni web e il web come piattaforma
Il web è una piattaforma meravigliosa. Le estensioni del browser sono un modo potente per ampliare le funzionalità del web. Qui mostrato attraverso l'esempio di WhatsApp Web e MaraDocs.
Il potere delle estensioni web
Sono davvero entusiasta del web come piattaforma. Negli ultimi anni il browser è diventato l'ambiente di esecuzione più importante per i programmi ed è sempre sorprendente ciò che è possibile fare con i browser moderni (ma anche con i moderni framework JavaScript come React).
Abbiamo cercato a lungo una soluzione per l'importazione di immagini da WhatsApp
Da circa due anni rifletto su come poter gestire l'importazione (o l'esportazione) di immagini o documenti da WhatsApp in altri programmi in modo sicuro e conforme alla privacy. WhatsApp appartiene a Meta ed è – che piaccia o no – il messenger con la maggiore diffusione.
Cosa è positivo: I contenuti dei messaggi in WhatsApp sono crittografati end-to-end.
Cosa non è positivo: WhatsApp non offre un'API per ricevere i messaggi in modo programmatico. Questo è frustrante nell'era degli attuali strumenti di automazione (n8n, vari strumenti LegalTech, MaraDocs...) perché significa che sono necessari passaggi manuali per accedere ai documenti.
Cosa difficilmente credibile: Ho appena scritto che non esiste un'API. Non è del tutto corretto. Esiste un'API offerta da Meta con cui è possibile ricevere e inviare messaggi. Tuttavia, per questo è necessario un account WhatsApp Business. E Meta si fa concedere diritti di utilizzo estesi sui contenuti inviati (e ricevuti):
I termini di WhatsApp Business sono inaccettabili dal punto di vista della protezione dei dati
Ecco un estratto dagli attuali termini di WhatsApp Business:
N. 5 Licenze e proprietà intellettuale
Tu concedi a WhatsApp e alle sue società controllate e affiliate una licenza mondiale, non esclusiva, sublicenziabile e trasferibile per utilizzare, riprodurre, modificare, adattare, pubblicare, tradurre, creare opere derivate, distribuire ed eseguire o mostrare pubblicamente i Contenuti aziendali che carichi, invii, archivi, invii o ricevi su o attraverso i nostri Business Services (...).
Fonte: WhatsApp Business Terms, consultati nell'ottobre 2025
Penso sia chiaro che un'importazione di comunicazioni riservate con i clienti tramite un account WhatsApp Business di questo tipo non sia praticabile. Non esiste quindi un'API utilizzabile.
Meta si fa quindi concedere diritti di utilizzo estesi sui contenuti inviati (e ricevuti). Pertanto, chiunque tratti dati personali o altrimenti riservati dei propri clienti/clienti dello studio non può utilizzare un account WhatsApp Business. E da questo dipende la possibilità di accedere in modo programmatico (cioè tramite API) ai messaggi o alle immagini inviate.
Nota: La nostra estensione del browser (vedi articolo del blog) aggira il dilemma descritto e non utilizza alcuna API o account WhatsApp Business per importare immagini da WhatsApp. In questo modo l'esportazione funziona in modo conforme alla privacy.
Come possiamo quindi esportare immagini da WhatsApp senza disastri per la privacy?
Qui entrano in gioco le webextensions, ovvero in italiano: le estensioni del browser.
Le estensioni del browser sono programmi che vengono caricati successivamente dal browser in determinate pagine web e possono interagire (in modo molto definito) con i contenuti in esse contenuti.
E WhatsApp, nel suo ecosistema molto chiuso e blindato, ha aperto un varco verso i suoi interni creando WhatsApp Web. È possibile accedere tramite un codice QR con l'app WhatsApp sul cellulare su web.whatsapp.com e ottenere tutte le chat in una finestra del browser per un utilizzo comodo.
E in questa finestra del browser possiamo intervenire con le estensioni.
L'architettura di un'estensione del browser
L'estensione fornisce essenzialmente tre componenti:
- Uno background script, che funziona indipendentemente da una pagina web corrente
- Uno content script ciascuno, che viene "iniettato" in pagine web predefinite e funziona nel loro contesto
Per motivi di sicurezza, le singole schede del browser sono molto isolate l'una dall'altra. Ciò significa che la comunicazione diretta tra due pagine web non è possibile.
Lo background script dell'estensione assume la funzione di centro di messaggistica. Sia il content script in web.whatsapp.com che il content script su app.maradocs.io possono inviare messaggi allo background script e ricevere messaggi da esso.
Quindi, se il content script di WhatsApp vuole inviare un'immagine al content script di MaraDocs, impacchetta l'immagine in un messaggio codificato come testo (codificato in Base64) e lo invia allo background script. A seconda del tipo di messaggio definito, questo viene poi inoltrato di conseguenza.
Il content script di MaraDocs, a sua volta, attende tali messaggi, li convalida e li invia (ora tramite i cosiddetti CustomEvents) al codice MaraDocs originale.
Naturalmente qui ci sono molti più problemi da risolvere: oltre alla convalida generale dei dati (è tutto corretto in questo messaggio?), i dati di diversi messaggi devono essere assemblati (i CustomEvents hanno un limite di dimensione di un megabyte...). Cosa succede con i messaggi inviati due volte, cosa succede con i messaggi mancanti... altri 100 potenziali problemi.
Ma se questi singoli passaggi sono modellati e implementati in modo pulito, il trucco magico è compiuto e (più) file di immagini vengono migrati con un clic dall'ecosistema normalmente chiuso di WhatsApp a MaraDocs, dove possono essere comodamente convertiti in documenti PDF ordinati.
Questo mi affascina ancora dopo un intenso fine settimana di programmazione.
La nostra estensione gratuita del browser Easy Image Exporter for WhatsApp Web facilita il download in blocco di immagini da WhatsApp Web e offre anche l'importazione diretta in MaraDocs. La presentiamo in dettaglio nell'articolo del blog linkato.
Abbonati alla newsletter ora
Rimanete aggiornati con noi e ricevete le ultime notizie, articoli e risorse via email.
Questo è MaraDocs: Ottimizzare, Combinare, Scaricare
Il flusso di lavoro è costantemente orientato alle esigenze della routine dello studio legale: deve essere veloce e semplice!
- Trascinare e-mail con allegati o file nell'app tramite drag & drop o copia e incolla
- Tutti gli allegati vengono estratti e analizzati automaticamente
- I documenti vengono riconosciuti e ritagliati automaticamente e convertiti in scansioni ricercabili
- I PDF vengono ridotti di dimensione, eventualmente viene eseguito un riconoscimento del testo
- Tutte le pagine vengono automaticamente orientate e ruotate in base alla direzione del testo
- Le pagine possono essere facilmente combinate in nuovi PDF
- La ridenominazione richiede un solo clic
- Download. Fatto.
Elaborazione intelligente dei documenti con MaraDocs
Con MaraDocs, trasformate retroattivamente gli allegati e-mail dei vostri clienti in scansioni perfette. Ritaglio, raddrizzamento, unione, riconoscimento del testo e molto altro.
Inizia gratuitamente ora