Slack

Bu rehberde: Slack çalışma alanınızı bağlarsınız. İki kullanım vardır: ekip bildirimleri ve şirket içi yapay zekâ asistanı. Bot izinlerini ve olay aboneliğini kurarsınız.

⏱ 25 dakika

Kimlik kartı#

Ne işe yarar?#

• Ekip bildirimleri: iş akışlarındaki Ekibe bildir kutusu (kanal: Slack) mesajını entegrasyonda seçtiğiniz bildirim kanalına yazar.
• Slack asistanı: bot etiketlendiğinde veya DM aldığında AI Chatbot bilgi bankanızdan yanıt verir.

Slack toplu mesaj kanalı değildir.

Ön koşullar#

• Slack çalışma alanında uygulama yükleme yetkisi.
• OrqLabs'ta Sahip veya Yönetici rolü.
• Platform yöneticisinin SLACK_CLIENT_ID, SLACK_CLIENT_SECRET, SLACK_SIGNING_SECRET tanımlamış olması.
• Herkese açık HTTPS adres (Slack olay adresini kayıt sırasında doğrular).

Adım adım kurulum#

A) Slack API (platform yöneticisi)#

1. api.slack.com/apps → Create New App → From scratch. ① App Name, ② çalışma alanı, ③ Create App.

2. OAuth & Permissions → Scopes → Bot Token Scopes → ① sırayla ekleyin: chat:write, channels:read, channels:history, app_mentions:read, im:history, im:write. ② User Token Scopes boş kalsın.

3. OAuth & Permissions → Redirect URLs → ① Add New Redirect URL: https://api.orqlabs.com/api/v1/integrations/oauth/slack/callback → Save URLs. Slack yalnızca HTTPS kabul eder.
4. Event Subscriptions → Enable Events. ② Request URL alanını şimdilik boş bırakın; bağlantıdan sonra dolduracaksınız. ③ Subscribe to bot events: app_mention, message.im, message.channels → Save Changes.
5. App Home: görünen ad ve kullanıcı adı; Show Tabs → Messages Tab açık ve "Allow users to send messages" işaretli. Bu olmadan kullanıcılar bota DM yazamaz.

6. Basic Information → App Credentials: ① Client ID, ② Client Secret, ③ Signing Secret değerlerini yöneticiye iletin; SLACK_CLIENT_ID, SLACK_CLIENT_SECRET, SLACK_SIGNING_SECRET olarak tanımlanır.
7. Birden fazla çalışma alanı için Manage Distribution → Activate Public Distribution.

B) OrqLabs'ta bağlama#

1. Entegrasyonlar → Slack → Bağla. Organizasyon geneli; proje seçilmez. İsterseniz Notification channel alanına bildirim kanalını yazın (#pazarlama veya C0123ABCD); boş bırakıp 4. adımda listeden de seçebilirsiniz.
2. Slack izin ekranında doğru çalışma alanını seçin → Allow.
3. Kart Bağlı olur; çalışma alanı adı ve bot kullanıcı adı görünür.
4. Slack kartını açın → Bildirim kanalı bölümünde kanalı listeden seçin (liste çalışma alanının herkese açık kanallarıdır; botun üye olmadıkları "(bot üye değil)" diye işaretlenir) → Kaydet. Özel kanallar listede görünmez; kanal kimliğini Kimlik (elle) alanına yazın. Kanal seçilmeden Ekibe bildir kutusunun Slack mesajları gönderilmez: çalıştırma günlüğünde "slack notification not delivered" uyarısı çıkar ve kartta son hata olarak görünür.
5. Seçtiğiniz kanala botu davet edin: /invite @bot. Bot üye olmadığı kanala yazamaz (not_in_channel).
6. Aşağıdaki webhook adımını tamamlayın; tamamlamazsanız bildirimler çalışır ama gelen mesajlar ulaşmaz.

Webhook kurulumu#

1. Slack kartını açın; ③ Webhook URL değerini kopyalayın: https://api.orqlabs.com/api/v1/webhooks/slack/<hesap kimliği>. Slack için ayrı doğrulama token'ı yoktur; istekler Signing Secret ile doğrulanır.
2. Slack API → Event Subscriptions → Request URL → yapıştırın. Slack anında bir doğrulama isteği gönderir; alanın yanında Verified yazısı görünür.
3. Bot olaylarını doğrulayın → Save Changes.
4. Slack sarı "reinstall your app" uyarısı gösterirse OrqLabs'ta Yeniden yetkilendir.
5. Test: bota DM yazın veya kanalda @bot merhaba yazın. Gelen Kutusu'nda konuşma görünmeli.

message.channels yalnızca botun üyesi olduğu herkese açık kanalları getirir. Özel kanallar desteklenmez. Botun her mesaja yanıt vermemesi için Mesaj geldi kutusunda Anahtar kelime filtresi kullanın ya da yalnızca etiket ve DM'lere yanıt veren akış kurun.

İzinler ve kapsamlar#

Bu liste Slack uygulamanızdaki Bot Token Scopes ile birebir aynı olmalıdır; aksi hâlde OAuth invalid_scope ile kesilir.

Limitler#

Bağlantıyı test etme#

② Bağlantıyı test et çalışma alanı adını ve bot kullanıcı adını gösterir. Ardından: bildirim kanalını seçip botu o kanala davet edin; Manuel → Ekibe bildir (kanal Slack) içeren bir iş akışını çalıştırın; bota DM yazın.

Kimlik bilgilerini yenileme#

• Bot izni süresizdir. Uygulama çalışma alanından kaldırılırsa veya yükleyen kullanıcı devre dışı bırakılırsa geçersiz olur → Yeniden yetkilendir.
• Client Secret veya Signing Secret yenilendiyse yönetici .env'i günceller; aksi hâlde webhook'lar 401 döner.

Sık karşılaşılan hatalar#

Sık sorulan sorular#

Slack'i sadece bildirim için kullanabilir miyim? Evet. Webhook adımını atlayın; Bildir kutusu ve devir bildirimleri çalışır.

Bot her kanal mesajına yanıt verir mi? Yalnızca üye olduğu kanallarda ve Mesaj geldi kutusunun filtresine göre. En güvenlisi yalnızca etiket ve DM'lere yanıt vermek.

Özel kanallarda çalışır mı? Bildirim gönderebilir (davet edilirse). Özel kanal mesajlarını okuyamaz.

Sonraki adım#

• Chatbot kurulumu
• Gelen kutusu ve insan devralma
• Yardımcı node'lar