Slack Entegrasyonu
Slack botunuzu NatureCo platformuna entegre edin ve ekibinizle Slack üzerinden etkileşime geçin.
Başlamadan Önce: Slack workspace'inize admin erişiminiz olmalı. Ayrıca
api.slack.com adresinde bir hesap oluşturmanız gerekiyor.
1. Slack App Oluşturma
İlk adım olarak Slack API'de yeni bir uygulama oluşturmanız gerekiyor.
- Slack API Apps sayfasına gidin
- "Create New App" butonuna tıklayın
- "From scratch" seçeneğini seçin
- Uygulamanıza bir isim verin (örn: "NatureCo Bot")
- Workspace'inizi seçin
- "Create App" butonuna tıklayın
İpucu: App isminizi workspace'inizdeki kullanıcıların kolayca tanıyabileceği şekilde seçin.
2. OAuth İzinleri Ayarlama
Botunuzun Slack'te çalışması için gerekli izinleri vermeniz gerekiyor.
- Sol menüden "OAuth & Permissions" sekmesine tıklayın
- "Scopes" bölümüne inin
- "Bot Token Scopes" altına şu izinleri ekleyin:
chat:write - Mesaj gönderme
chat:write.public - Public kanallara mesaj gönderme
channels:read - Kanal listesini okuma
channels:history - Kanal mesajlarını okuma
app_mentions:read - Mention'ları okuma
Önemli: İzinleri ekledikten sonra botu workspace'e yeniden yüklemeniz gerekebilir.
3. Bot Token Alma
Bot token'ı, botunuzun Slack API'sine erişmesi için gereken gizli anahtardır.
- "OAuth & Permissions" sayfasında yukarı kaydırın
- "Install to Workspace" butonuna tıklayın
- İzin ekranında "Allow" butonuna tıklayın
- "Bot User OAuth Token" kısmında token'ı kopyalayın (xoxb- ile başlar)
xoxb-<SLACK_BOT_TOKENINIZ>
Önemli Güvenlik Uyarısı: Bot token'ınızı asla kimseyle paylaşmayın! Token'ınız ele geçirilirse, botunuz kötü amaçlı kullanılabilir.
4. Event Subscriptions Ayarlama
Botunuzun mesajları alabilmesi için event subscription'ları aktif etmeniz gerekiyor.
- Sol menüden "Event Subscriptions" sekmesine tıklayın
- "Enable Events" toggle'ını açın
- "Request URL" alanına webhook URL'inizi girin:
https://api.natureco.me/api/agent/slack/webhook
- "Subscribe to bot events" bölümüne şu event'leri ekleyin:
message.channels - Kanal mesajları
message.im - Direct mesajlar
app_mention - Bot mention'ları
- "Save Changes" butonuna tıklayın
İpucu: Request URL doğrulandıktan sonra yeşil onay işareti görünecektir.
5. NatureCo'da Slack Bağlantısı
Artık botunuzu NatureCo platformuna bağlayabilirsiniz.
- NatureCo Developers Portal'a gidin
- Sol menüden "Botlarım" sekmesine tıklayın
- Bir bot seçin veya yeni bot oluşturun
- "Slack Bağla" butonuna tıklayın
- Slack bot token'ınızı yapıştırın (xoxb- ile başlayan)
- "Bağlantıyı Kaydet" butonuna tıklayın
Başarılı! Botunuz artık NatureCo platformuna bağlı. Slack workspace'inizde botu mention ederek test edebilirsiniz.
6. Bot'u Test Etme
Botunuzun düzgün çalıştığını doğrulamak için test edin.
- Slack workspace'inizde herhangi bir kanala gidin
- Botunuzu mention edin:
@NatureCo Bot Merhaba!
- Veya bota direct mesaj gönderin
- Botun yanıt vermesini bekleyin
@NatureCo Bot Türkiye'nin başkenti neresidir?
Not: İlk yanıt 2-3 saniye sürebilir. Eğer bot yanıt vermiyorsa, Event Subscriptions ayarlarınızı kontrol edin.
Sorun Giderme
❌ Bot yanıt vermiyor
Çözüm: Token'ınızın doğru olduğundan ve "xoxb-" ile başladığından emin olun. Event Subscriptions'ın aktif olduğunu kontrol edin. NatureCo Developers Portal'da botunuzun aktif olduğunu doğrulayın.
❌ "not_in_channel" hatası alıyorum
Çözüm: Botu kanala davet edin: /invite @NatureCo Bot komutunu kullanın. Veya bot'un "chat:write.public" iznine sahip olduğunu kontrol edin.
❌ Event Subscriptions URL doğrulanmıyor
Çözüm: URL'nin doğru olduğundan emin olun: https://api.natureco.me/api/agent/slack/webhook. NatureCo sunucularının çalıştığını kontrol edin. Birkaç dakika bekleyip tekrar deneyin.
❌ "invalid_auth" hatası alıyorum
Çözüm: Bot token'ınızı yeniden kopyalayın. Token'ın başında/sonunda boşluk olmadığından emin olun. Gerekirse botu workspace'e yeniden yükleyin.
❌ Bot sadece mention'larda çalışıyor
Çözüm: Bu normal davranıştır. Slack botları varsayılan olarak sadece mention edildiğinde veya DM'de yanıt verir. Tüm mesajları dinlemek için "messages.channels" event'ini ekleyin.