Wiki Detay | wiki workcube

Workcube GoMail, Google Workspace (Gmail) hesaplarının Workcube arayüzüne çift yönlü entegrasyonunu sağlayan özel bir iş objesidir. Sistem, gücünü Google API altyapısından ve güvenli OAuth 2.0 kimlik doğrulama protokolünden alır. GoMail, kullanıcıların tarayıcı sekmeleri arasında geçiş yapma zorunluluğunu ortadan kaldırarak tüm gelen, gönderilen, taslak ve çöp kutusu e-postalarını tek bir çatı altında toplar. Workcube CRM (Müşteri İlişkileri Yönetimi), SCM (Tedarik Zinciri Yönetimi) ve HR (İnsan Kaynakları) modülleriyle entegre çalışarak çalışan kartlarındaki e-posta adresleri üzerinden dinamik yetkilendirme ve rehber sorgulaması gerçekleştirir.

Bir İşletme İçin GoMail Entegrasyonunun Önemi

Zaman ve Verimlilik Artışı: Çalışanlar, Workcube ERP sisteminden ayrılmadan kurumsal e-postalarını okuyabilir, yanıtlayabilir ve yönetebilirler.
Bütünleşik İletişim Altyapısı: Workcube HR modülündeki çalışan veritabanı ile entegre rehber araması (searchContacts) sayesinde, şirket içi e-posta gönderimlerinde rehbere tam erişim sağlanır.
Güvenli Yetkilendirme (OAuth 2.0): Kullanıcı şifreleri hiçbir şekilde Workcube veritabanında saklanmaz; tüm işlemler Google'ın resmi OAuth 2.0 protokolü ve Refresh Token mekanizması ile yürütülür.
Operasyonel Kolaylık: Gmail üzerindeki etiketler (Labels), yıldızlı e-postalar ve klasör yapıları Workcube içerisine anlık olarak yansıtılır ve toplu işlemler (bulk actions) senkronize biçimde gerçekleştirilir.

GoMail İşlemlerini Yönetirken Nelere Dikkat Etmeli?

A. Şirket Akış Parametrelerinin Yapılandırılması

GoMail entegrasyonunun aktifleşmesi için sistem yöneticileri tarafından şirket akış parametrelerinden Google API entegrasyonunun aktif edilmesi ve geçerli bir Client ID / Client Secret tanımlanması zorunludur. Aksi takdirde kullanıcılar sistem uyarısı ile karşılaşır.

B. Çalışan Kartı E-posta Eşleşmesi

Sisteme bağlanmaya çalışan kullanıcının Workcube çalışan kartındaki kurumsal e-posta adresi ile Google yetkilendirmesi yapılacak e-posta adresi birebir aynı olmalıdır. Farklı adreslerle yapılan eşleştirme denemeleri güvenlik protokolleri gereği engellenir.

C. Session Token ve Zaman Aşımı Yönetimi

Sistem, API istek limitlerini aşmamak adına Google Access Token bilgisini session seviyesinde (session.goMail_access_token) saklar. Token süresi dolmadan 60 saniye önce otomatik yenileme mekanizması devreye girer.

D. Lisans ve Deneme Süresi Kontrolü (Add-on Yönetimi)

GoMail entegrasyonu, Workcube Add-on mimarisi (WGM038 kodu) kapsamında lisanslanmaktadır. 3 günlük deneme süresi (trial) boyunca eklenti ücretsiz test edilebilir. Bu süre sonunda lisanslama tamamlanmazsa sistem API isteklerini durdurur.

E. Geçici Dosya (Temp Directory) Temizliği ve Ek Boyutları

E-posta gönderiminde veya yanıtlamada (reply) eklenen dosyalar sunucunun geçici klasörüne (temp directory) yüklenir, base64 formatına dönüştürülerek Google API'ye iletilir ve ardından sunucu sağlığı için anında diskten silinir.

GoMail Sistem Ekran Mimarisi ve Fonksiyonel Analiz

Workcube sayfalarından hiç ayrılmadan, tüm özellikleri ile, Google Workspace hesabınıza ait Gmail adresinizi kullanabilirsiniz. GoMail eklentisi satın alındıktan sonra kullanılabilir.

Kullanım için çalışan detay sayfasında, E-posta alanına Workspace Gmail adresinin yazılması gereklidir. Bu maile ait bilgilerin elinizde bulunması zorunludur.

Girilen mail adresi ile fuseaction=workspace.gmail adresi üzerinden Google girişi yapılması gerekecek. (3 günlük deneme süresi bulunuyor)

Giriş yapıldıktan sonra, kullanılan mail adresi ile, refresh token kaydı atılır. (fuseaction=dev.refresh_token_google) Sonrasında bu sayfaya giriş yapıldığında, tüm Gmail özellikleri Workcube sayfasından kullanılabilir.

GoMail arayüzü, gelişmiş bir e-posta istemcisinin tüm yeteneklerini kurumsal ERP dinamikleriyle birleştirir. Ekrandaki temel alanlar ve işlevleri şu şekildedir:

Ekran Alanı / Öğe	Sistemdeki Karşılığı / Teknik Tetikleyici	İşlevi ve Operasyonel Önemi
Google Bağlantı Ekranı	`gm-connect-screen` / `connectGoogleAccount()`	İlk kullanımda veya token silindiğinde kullanıcının Google hesabına güvenli erişim izni vermesini tetikler.
Sol Klasör ve Navigasyon Paneli	`gm-sidebar` (Inbox, Starred, Sent, Trash vb.)	Gmail'deki standart klasörleri ve kullanıcıya özel tanımlanmış tüm etiketleri (Labels) hiyerarşik olarak listeler.
Toplu İşlem Barı	`bulkAction()` (Mark Read, Trash, Move, Untrash)	Seçilen birden fazla e-postanın tek tıkla okunmuş sayılmasını, silinmesini veya farklı bir klasöre taşınmasını sağlar.
E-Posta Detay ve Yanıtlama	`replyEmail` & `sendEmail` (cc, bcc, attachments)	Gelen postaya zengin editör formatında yanıt yazılmasını, CC/BCC eklenmesini ve base64 formatında dosya yüklenmesini yönetir.
Rehber Arama Kutusu	`searchContacts`	E-posta yazarken Workcube Çalışan Kartları (HR) veritabanında anlık arama yaparak alıcı listesini otomatik tamamlar.