WhatsApp sohbet ve kişi dışa aktarıcı

WhatsApp Sohbet ve Kişi Dışa Aktarıcı, WhatsApp Web'deki sohbetleri ve kişi listesini HTML, PDF, CSV, TXT ya da XLSX biçiminde bilgisayara indiren bir tarayıcı eklentisidir. Brave başta olmak üzere Chromium tabanlı tarayıcılar için Manifest V3 ile geliştirdim. Eklenti, tarayıcının yan panelinde açılıyor ve arayüzünün tamamı Türkçe.

Amaç

WhatsApp iş yazışmalarının, müşteri taleplerinin ve grup duyurularının önemli bir kısmının döndüğü bir araç haline geldi. Ancak bir sohbeti düzgün bir belge olarak arşivlemek, belirli bir tarih aralığındaki mesajları raporlamak ya da bir grubun üye listesini tabloya dökmek WhatsApp'ın kendi araçlarıyla oldukça zahmetli. Ben bu işleri tarayıcıdan birkaç tıkla yapabilmek, çıktıyı da hem okunabilir hem de işlenebilir biçimlerde alabilmek istedim.

Nasıl çalışır

Eklenti üç ayrı JavaScript bağlamında çalışıyor ve bunlar birbirleriyle mesajlaşarak haberleşiyor. Yan panel, kullanıcının sohbetleri seçtiği ve ayarları yaptığı arayüz. Servis çalışanı yalnızca aktif sekmenin adresine bakıyor: sekme WhatsApp Web ise yan panelde asıl arayüzü, değilse "bu sayfada kullanılamaz" ekranını gösteriyor.

İçerik betiği WhatsApp Web sayfasına yükleniyor ve sayfanın kendi bağlamına bazı yardımcı modüller enjekte ediyor. Sayfa bağlamı, WhatsApp Web'in kendi kodunun çalıştığı ortam demek ve tarayıcı eklentilerinin yalıtılmış betikleri buraya doğrudan erişemiyor. Enjekte edilen modüller WhatsApp Web'in iç veri depolarından mesajları, kişileri ve grup bilgilerini okuyor, sonucu içerik betiğine geri gönderiyor. İçerik betiği de seçilen biçime göre ZIP, PDF ya da Excel dosyasını üretip diske kaydediyor. İşlem sürerken ilerleme durumu yan panelde ve sayfadaki küçük bir kartta gösteriliyor.

Öne çıkan özellikler

• Sohbetleri tek tek ya da toplu olarak HTML, PDF, CSV, TXT veya tek dosyalık XLSX biçiminde indirebiliyorsunuz.
• HTML çıktısı, sohbeti tarayıcıda açılabilen bir web sayfası olarak sunuyor.
• Belirli bir tarih aralığındaki mesajları süzebiliyorsunuz ve bitiş tarihi günün sonuna kadar dahil ediliyor.
• WhatsApp'taki tüm kişileri ya da yalnızca seçtiğiniz etiketlere ait kişileri CSV olarak çıkarabiliyorsunuz. Sütunları hazır şablonlardan seçebiliyor ya da kendiniz belirleyebiliyorsunuz.
• Açık olan grubun katılımcılarını, yönetici ve süper yönetici bilgileriyle birlikte CSV olarak indirebiliyorsunuz.
• Medyayı pakete ekleme, videoları atlama ve çözülemeyen medya için zaman aşımı gibi ince ayarlar bulunuyor.
• Bir CSV ya da XLSX dosyasındaki telefon numaralarını okuyup WhatsApp'ta bunlarla eşleşen sohbetleri otomatik olarak seçebiliyorsunuz.
• Sistem ayarını izleyen ya da elle değiştirilebilen açık ve koyu tema var.

Teknik altyapı

Eklentide derleme adımı yok. Klasör doğrudan geliştirici modunda yüklenebiliyor. Arayüz Bootstrap ve jQuery ile, tarih işlemleri Moment ile yapılıyor. Dosya üretimi için JSZip, html2pdf, SheetJS ve FileSaver kütüphanelerini kullanırım. Hepsi depoya dahil edilmiş durumda, npm ya da paket yöneticisi gerektirmiyor.

Yan panel mantığını görev bazında küçük modüllere ayırdım. Arayüz akışı, dışa aktarma komutları, sohbet ve grup seçicileri, kişi ve etiket önbelleği, CSV içe aktarma, ilerleme göstergesi ve mesajlaşma köprüsü ayrı dosyalarda duruyor. Arama destekli çoklu seçici ve liste seçici bileşenlerini de kendim yazdım.

PDF üretimi sayfa bağlamında değil içerik betiğinde yapılıyor. Belge geçici bir alanda oluşturuluyor, html2pdf ile çiziliyor ve ardından temizleniyor. Aynı anda iki PDF başlatıldığında birbirine karışmasın diye işler bir kuyruğa alınıyor.

Tema renkleri CSS değişkenleriyle tanımlı ve koyu tema tek bir öznitelikle bu değişkenlerin üzerine yazıyor. Seçim kutuları, radyo düğmeleri ve onay kutuları gibi form öğelerini iki temada da düzgün görünsün diye özel olarak çizdim.

Bilinen kısıtlar

WhatsApp Web iç modüllerinin adlarını düzenli olarak değiştiriyor. Bu yüzden sayfa bağlamına enjekte edilen sarmalayıcı modüllerin zaman zaman güncellenmesi gerekiyor. Brave'in parmak izi korumasının bazı modüllerin yüklenmesini engellediği durumlar da oluyor. Yan panel boş kalırsa WhatsApp Web için Shields korumasını düşürmek sorunu çözüyor.

Kullanım alanları

• Müşteri yazışmalarını belge olarak arşivlemesi gereken küçük işletmeler ve destek ekipleri için kullanışlıdır.
• Bir projeye ya da döneme ait yazışmaları tarih aralığıyla süzüp PDF veya Excel olarak raporlamak için uygundur.
• Etiketlenmiş müşteri listelerini ya da grup üyelerini CRM gibi başka sistemlere aktarmak için CSV çıktısı alınabilir.
• Elindeki bir telefon listesinde yer alan kişilerle yapılan sohbetleri topluca bulup indirmek isteyenlerin işini hızlandırır.

Durum

Güncel sürüm 1.1.7. Eklenti mağazada yayımlanmadı ve geliştirici modunda yüklenerek kullanılıyor. Sıradaki işler arasında küçük boyutlu ikonlar, uyarı pencereleri yerine uygulama içi bildirimler, klavye erişilebilirliğinin gözden geçirilmesi ve WhatsApp Web modülleri değiştiğinde kullanıcıyı uyaran bir sağlık kontrolü var.