TMetric Haftalık Çalışma Saatlerini Otomatik Olarak Slack'e Gönder

Genel Bakış

Bu n8n iş akışı, TMetric'ten haftalık çalışma saatlerini alarak her çalışana özel, kişiselleştirilmiş özetleri Slack üzerinden otomatik olarak gönderen güçlü bir otomasyon çözümüdür. İş akışı, çalışanların kaydettiği gerçek saatleri bireysel çalışma programlarıyla karşılaştırır, onaylanmış izinleri dikkate alır ve saatlik hedeflerinin gerisinde kalanları tespit eder. Bu sayede, yöneticiler ve İnsan Kaynakları departmanları, manuel raporlama yükünden kurtulurken, çalışanlar da kendi performansları hakkında düzenli geri bildirim alırlar. Özellikle uzaktan çalışan ekipler ve esnek çalışma saatlerine sahip şirketler için zaman yönetimini şeffaf ve verimli hale getirir.

Bu otomasyon, zaman takibi süreçlerini modernleştirerek hata payını azaltır ve yöneticilerin daha stratejik görevlere odaklanmasını sağlar. Çalışanların zaman yönetimi konusunda daha bilinçli olmalarına yardımcı olurken, şirket genelinde verimliliğin artırılmasına katkıda bulunur.

Gereksinimler

Bu iş akışını başarıyla kurmak ve çalıştırmak için aşağıdaki hesaplara ve bilgilere ihtiyacınız olacaktır:

• n8n Hesabı: İş akışını barındırmak ve çalıştırmak için aktif bir n8n Cloud hesabı veya kendi kendine barındırılan bir n8n kurulumu.
• TMetric Hesabı: Çalışan zaman verilerini almak için yönetici erişimine sahip bir TMetric hesabı. TMetric API'sine erişim için bir API Anahtarı gerekecektir.
• Slack Hesabı: Çalışanlara raporları göndermek için bir Slack çalışma alanı. Slack API'sine erişim için bir Bot Token'ı veya OAuth kimlik bilgileri gerekecektir. Slack uygulamanızın chat:write ve users:read izinlerine sahip olduğundan emin olun.
• Çalışan Bilgileri: Her çalışanın TMetric kullanıcı kimliği, Slack kullanıcı kimliği ve haftalık çalışma kotası gibi bilgileri içeren bir veri kaynağı (örneğin, bir Google Sheets veya Airtable).

Kurulum Adımları

Bu iş akışını n8n'de kurmak için aşağıdaki adımları izleyin:

1. n8n İş Akışını İçe Aktarma: Sağlanan JSON dosyasını n8n arayüzünüze içe aktarın. Bu, iş akışının temel yapısını oluşturacaktır.

2. TMetric Kimlik Bilgilerini Yapılandırma:

   • HTTP Request (TMetric API) düğümüne tıklayın.
   • Credentials bölümünde New Credential seçeneğini seçin.
   • Authentication tipini Header Auth olarak ayarlayın.
   • Header Name alanına X-TMetric-API-Key yazın.
   • Header Value alanına TMetric API anahtarınızı girin. TMetric API anahtarınızı TMetric hesabınızın ayarlarından (genellikle Ayarlar > API Erişimi altında) alabilirsiniz.
   • Kimlik bilgilerini kaydedin.

3. Slack Kimlik Bilgilerini Yapılandırma:

   • HTTP Request (Slack API) düğümüne tıklayın.
   • Credentials bölümünde New Credential seçeneğini seçin.
   • Authentication tipini OAuth2 olarak ayarlayın veya Header Auth kullanarak Bot Token'ınızı Authorization: Bearer YOUR_BOT_TOKEN şeklinde girin.
   • Slack uygulamanızı oluşturup gerekli izinleri (örneğin, chat:write, users:read) verdiğinizden ve Bot Token'ınızı aldığınızdan emin olun.
   • Kimlik bilgilerini kaydedin.

4. Zamanlama Tetikleyicisini Ayarlama:

   • Schedule Trigger düğümüne tıklayın.
   • İş akışının ne zaman çalışacağını ayarlayın. Genellikle haftalık raporlar için Cuma veya Pazartesi sabahı çalışacak şekilde ayarlanır.
   • Mode olarak Every Week seçeneğini belirleyin ve haftanın gününü, saati ve dakikayı ayarlayın.

5. Çalışan Verilerini Entegre Etme:

   • İş akışında, çalışanların TMetric kullanıcı kimliklerini, Slack kullanıcı kimliklerini ve haftalık çalışma kotalarını içeren bir veri kaynağına (örneğin, bir Google Sheets veya Airtable düğümü) ihtiyacınız olacaktır. Bu örnekte, bu verilerin bir Set düğümü veya harici bir kaynaktan geldiği varsayılmıştır.
   • Eğer harici bir kaynak kullanıyorsanız, ilgili düğümü ekleyin ve kimlik bilgilerini yapılandırın. Verilerin her bir çalışan için ayrı bir öğe olarak geldiğinden ve gerekli alanları (örneğin, tmetricUserId, slackUserId, weeklyQuotaHours) içerdiğinden emin olun.

6. TMetric API Çağrısını Özelleştirme:

   • HTTP Request (TMetric API) düğümünde, TMetric API'sinin doğru uç noktasına çağrı yaptığınızdan emin olun. Genellikle https://api.tmetric.com/api/v3/accounts/{accountId}/timeentries gibi bir uç nokta kullanılır.
   • URL ve Query Parameters kısmını, raporlamak istediğiniz haftanın başlangıç ve bitiş tarihlerini dinamik olarak alacak şekilde ayarlayın. n8n ifadelerini ({{ $now.minus({ weeks: 1 }).startOf('week').toFormat('yyyy-MM-dd') }}) kullanabilirsiniz.

7. Veri İşleme ve Karşılaştırma:

   • Item Lists ve Set düğümlerini, TMetric'ten gelen verileri işlemek, her çalışan için toplam çalışma saatlerini hesaplamak ve haftalık kotalarıyla karşılaştırmak için yapılandırın.
   • Filter düğümünü, örneğin, kotasının altında kalan çalışanları veya belirli bir eşiğin üzerinde fazla mesai yapanları filtrelemek için kullanabilirsiniz.

8. Slack Mesajını Oluşturma:

   • Set düğümünde, Slack'e gönderilecek mesajın içeriğini oluşturun. Bu mesaj, çalışanın toplam çalışma saatlerini, kotasını ve varsa eksik kalan saatleri içermelidir. Markdown formatını kullanarak mesajı zenginleştirebilirsiniz.
   • Örnek mesaj yapısı: Merhaba {{ $json.employeeName }}, geçen hafta {{ $json.totalHours }} saat çalıştınız. Haftalık kotanız {{ $json.weeklyQuota }} saattir. {{ $json.missingHours }} saat eksiğiniz bulunmaktadır.

9. Slack Mesajını Gönderme:

   • HTTP Request (Slack API) düğümünde, Slack'in chat.postMessage uç noktasına çağrı yaptığınızdan emin olun (https://slack.com/api/chat.postMessage).
   • Method olarak POST seçeneğini belirleyin.
   • Body Parameters kısmında channel (çalışanın Slack kullanıcı kimliği) ve text (oluşturduğunuz mesaj) alanlarını dinamik olarak ayarlayın.
   • Content-Type başlığını application/json olarak ayarlayın.

10. İş Akışını Test Etme ve Etkinleştirme:

    • İş akışını manuel olarak çalıştırarak test edin ve her adımın beklendiği gibi çalıştığından emin olun.
    • Herhangi bir hata durumunda, n8n'in hata ayıklama araçlarını kullanarak sorunları giderin.
    • Testler başarılı olduktan sonra iş akışını Active duruma getirin.

Gerçek Dünya Kullanım Senaryoları

• Uzaktan Çalışan Ekipler İçin Haftalık Performans Takibi: Uzaktan çalışan ekiplerin haftalık çalışma saatlerini otomatik olarak takip ederek, yöneticilere ve çalışanlara şeffaf bir performans görünürlüğü sağlar. Bu, özellikle farklı zaman dilimlerinde çalışan ekipler için koordinasyonu kolaylaştırır.
• Proje Bazlı Çalışmalarda Bütçe ve Zaman Yönetimi: Proje bazlı çalışan ekiplerin belirli projelere harcadığı zamanı izleyerek, proje bütçelerinin ve zaman çizelgelerinin doğru bir şekilde yönetilmesine yardımcı olur. Fazla mesai veya eksik çalışma durumlarını erken tespit eder.
• İnsan Kaynakları İçin Otomatik Raporlama: İnsan Kaynakları departmanlarının manuel zaman raporlama yükünü azaltır. Çalışanların izinlerini ve çalışma saatlerini otomatik olarak karşılaştırarak maaş bordrosu süreçlerini ve performans değerlendirmelerini destekler.
• Esnek Çalışma Saatleri Olan Şirketlerde Şeffaflık: Esnek çalışma saatleri sunan şirketlerde, çalışanların haftalık taahhütlerini yerine getirip getirmediğini izlemek için idealdir. Bu, hem çalışana özgürlük tanırken hem de şirketin hedeflerine ulaşmasını sağlar.
• Danışmanlık ve Hizmet Şirketlerinde Müşteri Faturalandırması: Müşterilere faturalandırılan saatlerin doğru ve şeffaf bir şekilde kaydedilmesini sağlar. Her hafta müşteriye özel raporlar oluşturarak faturalandırma süreçlerini hızlandırır ve müşteri güvenini artırır.

İpuçları ve En İyi Uygulamalar

• Hata Yönetimi Ekleme: İş akışınıza hata yönetimi düğümleri (örneğin, Try/Catch blokları) ekleyerek API çağrılarında veya veri işlemelerinde oluşabilecek hataları yakalayın ve yöneticilere bildirim gönderin.
• Dinamik Tarih Aralıkları: TMetric API çağrılarında tarih aralıklarını dinamik olarak ayarlamak için n8n ifadelerini kullanın (örneğin, {{ $now.minus({ weeks: 1 }).startOf('week') }}). Bu, her hafta manuel müdahale gereksinimini ortadan kaldırır.
• Çalışan Verilerini Merkezi Bir Yerde Tutma: Çalışanların TMetric ID'leri, Slack ID'leri ve haftalık kotaları gibi bilgileri merkezi bir yerde (örneğin, Google Sheets, Airtable veya bir veritabanı) tutun ve bu verileri iş akışına dinamik olarak çekin. Bu, yönetimi kolaylaştırır.
• Slack Mesajlarını Özelleştirme: Slack mesajlarını çalışanların rolüne veya performansına göre özelleştirmek için koşullu mantık (örneğin, IF ifadeleri) kullanın. Örneğin, kotasını aşanlara farklı bir mesaj gönderebilirsiniz.
• Güvenlik: API anahtarlarınızı ve kimlik bilgilerinizi n8n'in güvenli kimlik bilgileri yönetim sisteminde saklayın ve asla doğrudan düğümlere yazmayın.
• Performans İzleme: İş akışının performansını düzenli olarak izleyin. Büyük ekipler için Split In Batches ve Wait düğümlerini kullanarak API hız limitlerine takılmamak için çağrıları yavaşlatabilirsiniz.
• Dokümantasyon: İş akışınızın her düğümünü ve amacını açıklayan yorumlar ekleyin. Bu, gelecekteki değişiklikler veya sorun giderme için çok faydalı olacaktır.

Sık Sorulan Sorular

S: İş akışı neden çalışmıyor? C: Kimlik bilgilerinizin (TMetric API anahtarı, Slack Bot Token'ı) doğru yapılandırıldığından ve gerekli izinlere sahip olduğundan emin olun. TMetric veya Slack API'sinde bir kesinti olup olmadığını kontrol edin. n8n'deki yürütme günlüklerini inceleyerek hata mesajlarını kontrol edin.

S: Haftalık raporlama zamanını nasıl değiştirebilirim? C: Schedule Trigger düğümüne tıklayarak haftanın gününü, saati ve dakikayı istediğiniz gibi ayarlayabilirsiniz. Örneğin, Pazartesi sabahı yerine Cuma akşamı rapor gönderilmesini sağlayabilirsiniz.

S: Belirli çalışanları raporlamanın dışında tutabilir miyim? C: Evet, çalışan verilerini çektikten sonra bir Filter düğümü ekleyerek belirli koşullara uyan çalışanları iş akışının geri kalanından çıkarabilirsiniz. Örneğin, isActive alanı false olan çalışanları filtreleyebilirsiniz.

S: Slack yerine başka bir platforma (örneğin, E-posta) rapor gönderebilir miyim? C: Evet, iş akışının sonundaki Slack API çağrısı düğümünü kaldırıp yerine bir Email Send düğümü veya başka bir mesajlaşma platformunun (örneğin, Microsoft Teams, Discord) API'sini çağıran bir HTTP Request düğümü ekleyebilirsiniz. İlgili kimlik bilgilerini ve mesaj formatını yapılandırmanız gerekecektir.

Bu rehber Otomasyonevi.com tarafından hazırlanmıştır.