Slack Entegrasyonu

Automind Agentflow platformu, otomasyon ajanınızı doğrudan Slack'te oluşturmanıza ve dağıtmanıza olanak tanır, ekibinizin iletişim ve iş akışı süreçleriyle sorunsuz entegrasyon sağlar.

Ön Koşullar

Automind Agentflow'u Slack ile entegre etmeden önce, aşağıdakilere sahip olduğunuzdan emin olun:

• Oluşturulmuş ve yayınlanmış bir Automind Agentflow botu
• Uygun izinlere sahip bir Slack hesabı
• Çalışma alanınızda Slack uygulamaları oluşturma erişimi
• Slack çalışma alanınızda uygulamalar yükleme için yönetici hakları

Not: Slack kanal entegrasyonu bulut dağıtımı gerektirir. Şirket içi kurulumlar Slack entegrasyonu için sınırlı işlevselliğe sahip olabilir.

Bu bölüm, Slack API ve Bot Framework kullanarak Automind Agentflow'unuzu Slack ile nasıl entegre edeceğinizi açıklar.

Adım 1: Botunuz İçin Slack Uygulaması Oluşturma

Slack API Portal'a Erişim

1. Slack'e Giriş Yapma

   • Tarayıcınızda Slack Sign In'e gidin
   • Slack kimlik bilgilerinizle giriş yapın

2. Your Apps Paneline Gitme

   • Slack API portalında Your Apps'a gidin
   • Burası tüm Slack uygulamalarınızı yöneteceğiniz yerdir

Yeni Slack Uygulaması Oluşturma

1. Uygulama Oluşturmaya Başlama

   • Bu ilk Slack uygulamanızsa Create New App'a tıklayın
   • Mevcut uygulamalarınız varsa Create an App'a tıklayın

2. Yapılandırma Yöntemini Seçme

   • Uygulamanızın kapsamlarını ve ayarlarını nasıl yapılandıracağınızı seçin
   • Manuel yapılandırma için From scratch'i seçin
   • Alternatif olarak, önceden tanımlanmış bir yapılandırmanız varsa From an app manifest'i seçebilirsiniz

3. Temel Uygulama Bilgilerini Yapılandırma

   • App Name alanına Automind Agentflow'unuz için açıklayıcı bir ad girin
   • Development Slack Team açılır menüsünden geliştirme çalışma alanınızı seçin
   • Bir geliştirme takımının üyesi değilseniz, bir tane oluşturun veya katılın

4. Uygulamayı Oluşturma

   • Devam etmek için Create App'a tıklayın
   • Yeni Slack uygulamanız oluşturulacak ve uygulama ayarlarına yönlendirileceksiniz

Uygulama Kimlik Bilgilerini Alma

1. Uygulama Detaylarına Erişim

   • Your Apps'a gidin ve az önce oluşturduğunuz Slack uygulamasına tıklayın
   • App Credentials bölümüne kadar aşağı kaydırın

2. Temel Kimlik Bilgilerini Kopyalama Daha sonra ihtiyacınız olacağından aşağıdaki değerleri kaydedin:

   • Client ID: Uygulamanız için benzersiz tanımlayıcı
   • Client Secret: Kimlik doğrulama için gizli anahtar
   • Signing Secret: Slack'ten gelen istekleri doğrulamak için kullanılır

Önemli: Bu kimlik bilgilerini güvenli tutun ve asla herkese açık paylaşmayın. Bunlara Adım 3'te Automind Agentflow kanalını yapılandırırken ihtiyacınız olacak.

Adım 2: (İsteğe Bağlı) Özel Kapsamlar Ekleme ve Bot User OAuth Token Oluşturma

Automind Agentflow'unuz özel izinler gerektiriyorsa (dosya işleme, gelişmiş mesajlaşma özellikleri veya çalışma alanı bilgilerine erişim gibi), OAuth kapsamlarını yapılandırmanız ve Bot User OAuth Token oluşturmanız gerekecektir.

Slack Kapsamlarını Anlama

Bir Slack uygulamasının yetenekleri ve izinleri, talep ettiği kapsamlar tarafından yönetilir. Farklı özellikler farklı kapsamlar gerektirir:

• Dosya işlemleri: files:read, files:write
• Kullanıcı bilgileri: users:read, users:read.email
• Kanal yönetimi: channels:read, channels:write
• Mesaj işleme: chat:write, chat:write.public

OAuth Kapsamlarını Yapılandırma

1. OAuth Ayarlarına Erişim

   • Slack uygulama ayarlarınızda Features > OAuth & Permissions'a gidin
   • Scopes bölümüne kadar aşağı kaydırın

2. Bot Token Kapsamları Ekleme

   • Bot Token Scopes altında Add an OAuth scope'a tıklayın
   • Ajanınızın işlevselliği için gerekli kapsamları seçin
   • Yaygın kapsamlar şunları içerir:
     • chat:write - Bot olarak mesaj gönderme
     • files:read - Dosya içeriğini okuma
     • users:read - Kullanıcı bilgilerine erişim

OAuth Token Oluşturma

1. Uygulamayı Çalışma Alanına Yükleme

   • OAuth Tokens for Your Workspace'e kadar yukarı kaydırın
   • Install to Workspace'e tıklayın

2. Uygulamayı Yetkilendirme

   • Uygulamanızın talep ettiği izinleri gözden geçirin
   • Çalışma alanınıza erişim vermek için Allow'a tıklayın

3. Bot User OAuth Token'ını Kopyalama

   • Yetkilendirmeden sonra Bot User OAuth Token otomatik olarak oluşturulacaktır
   • Gelişmiş Automind Agentflow özellikleri için ihtiyacınız olacağından bu token'ı kopyalayın

Önemli: Daha sonra yeni Bot Token Kapsamları eklerseniz, değişikliklerin etkili olması için Reinstall to Workspace'e tıklamanız gerekir. Bot User OAuth Token yeniden yükleme sırasında değişmez.

Adım 3: Automind Agentflow'da Slack Kanalı Oluşturma

Slack Kanalını Yapılandırma

1. Kanal Oluşturma Erişimi

   • Automind Agentflow Portal'ınıza giriş yapın
   • Kenar çubuğu menüsünden Channels'a gidin
   • Yeni kanal oluşturmaya başlamak için Yeni düğmesine tıklayın

2. Temel Bilgileri Yapılandırma

   • Slack kanalınız için açıklayıcı bir Ad girin
   • Kanalın amacını açıklayan bir Açıklama sağlayın
   • Açılır menüden Ajanınızı seçin
   • Platform açılır menüsünden Slack'i seçin
   • Devam etmek için İleri'ye tıklayın

3. Slack Özel Ayarlarını Yapılandırma

   • OAuth Erişim Anahtarı'nı girin (Adım 2'den Bot User OAuth Token, yapılandırdıysanız, veya temel kurulum için boş bırakın)
   • Devam etmek için İleri'ye tıklayın

4. Kanal Kurulumunu Tamamlama

   • Webhook yapılandırması için son sayfada görüntülenen Çağırma URL'sini kopyalayın
   • Kurulumu tamamlamak için Kanal Oluştur'a tıklayın
   • Kanal oluşturulacak ve etkinleştirilecektir

Mevcut Bağlam Parametreleri

Başarılı kanal etkinleştirmesinden sonra, Automind Agentflow aşağıdaki kullanıcı bağlam parametrelerini sağlar:

• [[ChatUser]].ChannelId = "slack"
• [[ChatUser]].UserId - Slack kullanıcı hesabı için benzersiz tanımlayıcı
• Slack uygulamanızın izinlerine bağlı olarak ek parametreler mevcut olabilir

Adım 4: Slack Uygulamanızı Yapılandırma

Redirect URL Ekleme

1. OAuth Ayarlarına Erişim

   • Slack'te Your Apps'a gidin
   • Uygulamanıza tıklayın

2. Redirect URL'leri Yapılandırma

   • Sol menüde OAuth & Permissions'a tıklayın
   • Redirect URLs bölümüne kadar aşağı kaydırın
   • Add a new Redirect URL'e tıklayın

3. Automind Agentflow URL'sini Girme

   • Adım 3'ten kopyalanan OAuth & Permissions Redirect URL'yi yapıştırın
   • URL'yi kaydetmek için Add'e tıklayın
   • Değişiklikleri onaylamak için Save URLs'e tıklayın

Uygulama Etkileşimini Ayarlama

1. Etkileşimli Özellikleri Yapılandırma

   • Sol menüde Interactivity & Shortcuts'a tıklayın
   • Interactivity'yi On konumuna getirin

2. Request URL'sini Ayarlama

   • Request URL alanına şunu girin: https://slack.botframework.com/api/Actions
   • Bu, Slack Bot Framework entegrasyonu için standart uç noktadır
   • Save Changes'e tıklayın

Bot Etkinliklerine Abone Olma

Etkinlik abonelikleri, Automind Agentflow'unuzun Slack'teki kullanıcı etkinlikleri hakkında bildirim almasını sağlar.

1. Etkinlik Aboneliklerini Etkinleştirme

   • Sol menüde Event Subscriptions'a tıklayın
   • Enable Events'i On konumuna getirin

2. Request URL'sini Yapılandırma

   • Request URL alanına Adım 3'ten Event Subscription Request URL'yi girin
   • Slack URL'yi otomatik olarak doğrulayacaktır

3. Gerekli Bot Etkinliklerini Ekleme

   • Subscribe to Bot Events'te Add Bot User Event'e tıklayın
   • Aşağıdaki temel etkinlik türlerini ekleyin:
     • member_joined_channel - Kullanıcı kanala katılır
     • member_left_channel - Kullanıcı kanaldan ayrılır
     • message.channels - Genel kanallardaki mesajlar
     • message.groups - Özel kanallardaki mesajlar
     • message.im - Doğrudan mesajlar
     • message.mpim - Çok taraflı doğrudan mesajlar

4. Etkinlik Yapılandırmasını Kaydetme

   • Sayfanın altındaki Save Changes'e tıklayın
   • Slack bu etkinlikler için gerekli ek kapsamları gösterecektir

App Home'u Yapılandırma

1. Messages Sekmesini Etkinleştirme

   • Features menüsünden App Home'a tıklayın
   • Show Tabs bölümüne kadar aşağı kaydırın

2. Doğrudan Mesajlaşmaya İzin Verme

   • Messages Tab'ı On konumuna getirin
   • Allow users to send Slash commands and messages from the messages tab'ı işaretleyin

Adım 5: Uygulamayı Slack Çalışma Alanına Yükleme

Son Yükleme

1. Uygulamayı Yeniden Yükleme

   • Sol menüden Basic Information'a tıklayın
   • Install your app bölümünde Reinstall to Workspace'e tıklayın

2. İzinleri Verme

   • Automind Agentflow'unuzun talep ettiği izinleri gözden geçirin
   • Slack çalışma alanınıza erişim vermek için Allow'a tıklayın

Yüklemeyi Doğrulama

1. Uygulama Varlığını Onaylama

   • Uygulama Slack'te sol kenar çubuğundaki Apps bölümünde görünecektir
   • Artık Automind Agentflow'unuzu Slack'te kullanabilirsiniz

2. Ek Onay (gerekirse)

   • Çalışma alanı yapılandırmanıza bağlı olarak ek onay gerekebilir:
     • Automind Agentflow Portal'da Channels sekmesine gidin
     • Slack kanal simgesine tıklayın
     • İstenirse Slack çalışma alanınıza giriş yapın
     • İzinleri gözden geçirin ve Allow'a tıklayın

Not: Son sürümlerden itibaren, kullanıcı bot ile sohbet başlattığında Hoş Geldin akışı otomatik olarak tetiklenir ve sorunsuz etkileşim deneyimi sağlar.

Automind Agentflow'unuzu Slack'te Kullanma

Doğrudan Mesajlaşma

• Slack kenar çubuğundaki Automind Agentflow uygulamanıza tıklayın
• Sohbet başlatmak için yazmaya başlayın
• Ajan yapılandırılmış otomasyon iş akışlarınıza göre yanıt verecektir

Kanal Entegrasyonu

Automind Agentflow'unuzu Slack kanallarında kullanmak için:

1. Botu Kanala Ekleme

   • Ajanı kullanmak istediğiniz Slack kanalını seçin
   • Kanal adının yanındaki açılır oka tıklayın
   • Integrations sekmesine tıklayın
   • Add an app'a tıklayın
   • Listeden Automind Agentflow'unuzu seçin

2. Kanallarda Bot ile Etkileşim

   • Bota bir şey sormak için mesajınızı @<bot adı> ile başlatın
   • Bu, sohbet için özel bir konu oluşturur
   • Sohbeti konu içinde devam ettirin

Not: Her konunun Automind Agentflow'da sohbeti Sohbet Geçmişinde saklayan benzersiz bir sohbet ID'si vardır.

Özellikler ve Yetenekler

Slack'teki Automind Agentflow'unuz şunları destekler:

• Etkileşimli Sohbetler: Kullanıcı sorguları için doğal dil işleme
• Dosya İşleme: Yükleme ve indirme yetenekleri (uygun kapsamlarla)
• Otomasyon İş Akışları: Yapılandırılmış otomasyon süreçlerini yürütme
• Bağlam Farkındalığı: Kullanıcı ve kanal bilgilerine erişim
• Zengin Yanıtlar: Düğmeler, kartlar ve multimedya içeriği desteği
• Konu Yönetimi: Kanal konularında düzenli sohbetler

Sorun Giderme

Yaygın Sorunlar

1. Uygulama Yüklemesi Başarısız

   • Slack uygulama ayarlarında tüm gerekli alanların doldurulduğunu doğrulayın
   • Automind Agentflow'dan gelen URL'lerin doğru girildiğini kontrol edin
   • Uygun çalışma alanı izinlerine sahip olduğunuzdan emin olun

2. Bot Yanıt Vermiyor

   • Slack kanalının Automind Agentflow'da aktif ve yayınlanmış olduğunu onaylayın
   • Event Subscription URL'sinin doğru yapılandırıldığını doğrulayın
   • Gerekli bot etkinliklerinin abone olduğunu kontrol edin

3. İzin Hataları

   • OAuth kapsamlarının ajanınızın gereksinimlerinle eşleştiğini gözden geçirin
   • Yeni kapsamlar ekledikten sonra uygulamayı yeniden yükleyin
   • Bot User OAuth Token'ının doğru yapılandırıldığını doğrulayın

4. Kanal Entegrasyon Sorunları

   • Botun belirli kanala eklendiğinden emin olun
   • Kanal izinlerinin bot etkileşimlerine izin verdiğini doğrulayın
   • Gerekli etkinliklerin (member_joined_channel, message.channels) abone olduğunu kontrol edin

En İyi Uygulamalar

• Kapsam Yönetimi: Yalnızca ajanınızın gerçekten ihtiyaç duyduğu OAuth kapsamlarını talep edin
• Test: Üretim dağıtımından önce geliştirme çalışma alanında kapsamlı test yapın
• Kullanıcı Rehberliği: Takım üyelerinin ajanla nasıl etkileşime girebileceği konusunda açık talimatlar sağlayın
• İzleme: Entegrasyon sorunları için Automind Agentflow günlüklerini düzenli olarak kontrol edin