Siła rozszerzeń przeglądarki i web jako platforma
Web to wspaniała platforma. Rozszerzenia przeglądarki to potężne narzędzie do rozszerzania funkcjonalności internetu. Oto przykład WhatsApp Web i MaraDocs.
Siła rozszerzeń przeglądarki
Jestem naprawdę absolutnie zachwycony webem jako platformą. Przeglądarka w ostatnich latach stała się najważniejszym środowiskiem uruchomieniowym programów i zawsze jest zdumiewające, co jest możliwe w nowoczesnych przeglądarkach (ale także w nowoczesnych frameworkach JavaScript, takich jak React).
Długo szukaliśmy rozwiązania dla importu obrazów z WhatsApp
Od około dwóch lat regularnie zastanawiam się, jak możemy zaprojektować import (lub eksport) obrazów lub dokumentów z WhatsApp do innych programów w sposób bezpieczny i zgodny z ochroną danych. WhatsApp należy do Meta i – niezależnie od tego, czy się to pochwala, czy nie – jest po prostu komunikatorem o największym zasięgu.
Co jest fajne: Treści wiadomości w WhatsApp są szyfrowane end-to-end.
Co nie jest fajne: WhatsApp nie oferuje API, aby programowo odbierać wiadomości WhatsApp. W czasach obecnych narzędzi automatyzacji (n8n, różne narzędzia LegalTech, MaraDocs...) jest to irytujące, ponieważ oznacza, że konieczne pozostają manualne kroki, aby dotrzeć do dokumentów.
W co trudno uwierzyć: Napisałem właśnie, że nie ma API. To nie jest do końca prawda. Istnieje API oferowane przez Meta, za pomocą którego można odbierać i wysyłać wiadomości. Jednak wymaga to konta WhatsApp Business. A Meta zastrzega sobie rozległe prawa do używania wysyłanych (i odbieranych) treści:
Warunki WhatsApp Business są nie do zaakceptowania z punktu widzenia ochrony danych
Oto fragment z aktualnych Warunków WhatsApp Business:
Nr 5 Licencje i własność intelektualna
Udzielasz WhatsApp oraz jego spółkom zależnym i powiązanym ogólnoświatowej, niewyłącznej, podlegającej sublicencjonowaniu i zbywalnej licencji na używanie, reprodukowanie, modyfikowanie, adaptowanie, publikowanie, tłumaczenie, tworzenie dzieł pochodnych, dystrybucję i publiczne wykonywanie lub wyświetlanie treści biznesowych, które przesyłasz, przedkładasz, przechowujesz, wysyłasz lub otrzymujesz w naszych usługach biznesowych lub za ich pośrednictwem (...).
Źródło: Warunki WhatsApp Business, dostęp w październiku 2025
Myślę, że jest oczywiste, że import poufnej komunikacji z klientami poprzez takie konto WhatsApp Business nie jest możliwy. Nie ma więc użytecznego API.
Meta zastrzega sobie zatem rozległe prawa do używania wysyłanych (i odbieranych) treści. W związku z tym nikt, kto przetwarza dane osobowe lub inne poufne dane swoich klientów/klientów kancelarii, nie może korzystać z konta WhatsApp Business. A od tego zależy możliwość programowego (czyli przez API) dostępu do wiadomości lub przesłanych obrazów.
Uwaga: Nasze rozszerzenie przeglądarki (zobacz artykuł na blogu) omija opisany dylemat i nie używa API ani konta WhatsApp Business do importowania obrazów z WhatsApp. Tutaj eksport działa zgodnie z przepisami o ochronie danych.
Jak więc wyeksportować obrazy z WhatsApp bez katastrofy w zakresie ochrony danych?
Tu mogą zabłysnąć: rozszerzenia webowe, czyli po polsku: rozszerzenia przeglądarki.
Rozszerzenia przeglądarki to programy, które są następczo ładowane przez przeglądarkę do określonych stron internetowych i mogą (w bardzo zdefiniowany sposób) wchodzić w interakcję z zawartymi w nich treściami.
A WhatsApp w swoim bardzo zamkniętym i ufortyfikowanym ekosystemie otworzył lukę do swoich wewnętrznych funkcji, tworząc WhatsApp Web. Można zalogować się przez kod QR ze swojej aplikacji WhatsApp na telefonie na web.whatsapp.com i otrzymać wszystkie czaty w oknie przeglądarki do wygodnego użytkowania.
I w to okno przeglądarki możemy interweniować za pomocą rozszerzeń.
Architektura rozszerzenia przeglądarki
Rozszerzenie zasadniczo udostępnia trzy komponenty:
- background script, który działa niezależnie od aktualnej strony internetowej
- Po jednym content script, który jest „wstrzykiwany" do wcześniej zdefiniowanych stron internetowych i działa w ich kontekście
Ze względów bezpieczeństwa poszczególne karty przeglądarki są bardzo mocno od siebie odizolowane. Oznacza to, że bezpośrednia komunikacja między dwiema stronami internetowymi nie jest możliwa.
Background script rozszerzenia przejmuje funkcję centrum wiadomości. Zarówno content script w web.whatsapp.com, jak i content script na app.maradocs.io mogą wysyłać wiadomości do background script i otrzymywać od niego wiadomości.
Jeśli więc content script WhatsApp chce wysłać obraz do content script MaraDocs, pakuje obraz w wiadomość zakodowaną jako tekst (Base64) i wysyła ją do background script. W zależności od zdefiniowanego typu wiadomości jest ona następnie odpowiednio przekierowywana.
Content script MaraDocs z kolei czeka na takie wiadomości, waliduje je i przesyła dalej (teraz przez tak zwane CustomEvents) do oryginalnego kodu MaraDocs.
Tutaj pies ma oczywiście jeszcze więcej pcheł: Oprócz ogólnej walidacji danych (czy wszystko, co jest w tej wiadomości, jest poprawne?) dane z różnych Messages muszą być złożone razem (CustomEvents mają limit rozmiaru jednego megabajta...). Co z podwójnie wysłanymi wiadomościami, co z brakującymi wiadomościami... 100 kolejnych potencjalnych problemów.
Ale jeśli te poszczególne kroki są czysto zamodelowane i zaimplementowane, sztuczka jest wykonana i (wiele) plików graficznych jest jednym kliknięciem zmigrowanych z normalnie zamkniętego ekosystemu WhatsApp do MaraDocs i może tam być wygodnie przekształconych w porządne dokumenty PDF.
To mnie fascynuje nawet po intensywnym weekendzie kodowania.
Nasze darmowe rozszerzenie przeglądarki Easy Image Exporter for WhatsApp Web ułatwia masowe pobieranie obrazów z WhatsApp Web i oferuje również bezpośredni import do MaraDocs. Przedstawiamy je szczegółowo w linkowanym artykule na blogu.
Zasubskrybuj newsletter już teraz
Bądź z nami na bieżąco i otrzymuj najnowsze wiadomości, artykuły i zasoby pocztą e-mail.
To jest MaraDocs: Optymalizuj, Łącz, Pobieraj
Przepływ pracy jest konsekwentnie dostosowany do potrzeb codzienności kancelarii: musi być szybko i prosto!
- Przeciągnij e-mail z załącznikami lub pliki metodą drag & drop lub copy & paste do aplikacji
- Wszystkie załączniki są automatycznie wyodrębniane i analizowane
- Dokumenty są automatycznie rozpoznawane i wycinane oraz przekształcane w przeszukiwalne skany
- Pliki PDF są zmniejszane, w razie potrzeby przeprowadzane jest rozpoznawanie tekstu
- Wszystkie strony są automatycznie wyrównywane i obracane zgodnie z kierunkiem tekstu
- Strony można bardzo łatwo łączyć w nowe pliki PDF
- Zmiana nazwy to tylko jedno kliknięcie
- Pobieranie. Gotowe.
Inteligentne przygotowanie dokumentów z MaraDocs
Dzięki MaraDocs zmienisz załączniki e-mail od swoich klientów w idealne skany. Wycinanie, prostowanie, łączenie, rozpoznawanie tekstu i wiele więcej.
Zacznij teraz za darmo