Slack Uygulama Yapılandırması - Quick BI - Alibaba Cloud Dokümantasyon Merkezi

Genel Bakış

Quick BI'den Slack'e veri raporları göndermek için Slack platformunda özel bir uygulama oluşturmanız gerekir. Bu uygulama, Quick BI ile Slack arasında köprü görevi görerek kimlik doğrulama, yetkilendirme ve mesaj teslimini yönetir.

Yapılandırmadan sonra mimari aşağıdaki üç iletişim yolunu içerir:

Yön	Kimlik Bilgileri	Amaç
Quick BI → Slack (OAuth)	client ID + client secret	Bir yetkilendirme kodunu belirteç ile değiştirir.
Quick BI → Slack (API)	bot token / user token	Mesajları göndermek için `chat.postMessage` gibi API'leri çağırır.

2. Slack uygulaması oluşturma

2,1 Geliştirici konsoluna gidin

https://api.slack.com/apps adresine gidin, Workspace yöneticisi olarak oturum açın ve Create New App seçeneğine tıklayın.

2,2 Oluşturma yöntemini seçin

Slack üç farklı oluşturma yöntemi sunar. From scratch yöntemi, uygulamayı manuel olarak yapılandırmanıza olanak tanır.

Yöntem	Açıklama	Önerilen
From scratch	Tam kontrol sağlamak için tüm özellikleri manuel olarak yapılandırın.
From a manifest	Bir JSON veya YAML şablonundan hızla bir uygulama oluşturun. Tekrarlanabilir dağıtımlar için idealdir.	✅ Önerilir
From an app template	Sınırlı işlevselliğe sahip resmi bir Slack şablonu kullanın.	Önerilmez

Uygulamayı bir manifest dosyasından oluşturuyorsanız aşağıdaki örnek yapılandırmayı kullanın:

{
    "display_information": {
        "name": "QuickBI"
    },
    "features": {
        "bot_user": {
            "display_name": "QuickBI",
            "always_online": false
        }
    },
    "oauth_config": {
        "redirect_urls": [
            "https://bi-cn-hongkong.alibabacloud.com/api/v2/slack/oauth/callback",
            "https://bi.aliyun.com/api/v2/slack/oauth/callback",
            "https://bi-cn-hangzhou.alibabacloud.com/api/v2/slack/oauth/callback",
            "https://bi-ap-southeast-1.alibabacloud.com/api/v2/slack/oauth/callback",
            "https://bi-ap-southeast-3.alibabacloud.com/api/v2/slack/oauth/callback",
            "https://bi-ap-southeast-5.alibabacloud.com/api/v2/slack/oauth/callback",
            "https://bi-eu-central-1.alibabacloud.com/api/v2/slack/oauth/callback",
            "https://bi-ap-northeast-1.alibabacloud.com/api/v2/slack/oauth/callback",
            "https://bi-us-east-1.alibabacloud.com/api/v2/slack/oauth/callback",
            "https://bi-me-central-1.data.aliyun.com/api/v2/slack/oauth/callback"
        ],
        "scopes": {
            "user": [
                "users:read",
                "chat:write",
                "files:write",
                "files:read",
                "im:write"
            ],
            "bot": [
                "chat:write",
                "files:write",
                "files:read",
                "users:read",
                "im:write"
            ]
        },
        "pkce_enabled": false
    },
    "settings": {
        "org_deploy_enabled": false,
        "socket_mode_enabled": false,
        "token_rotation_enabled": false,
        "is_mcp_enabled": false
    }
}

2,3 Uygulama bilgileri

Alan	Açıklama	Örnek
App name	Slack Workspace'unuzda görüntülenen uygulama adı.	Quick BI
Pick a workspace	Geliştirme ve test için Workspace'u seçin.	Mevcut Workspace'unuz

Önemli

Uygulama adı, Workspace'unuz içinde benzersiz olmalıdır. Quick BI veya Quick BI Notifications kullanmanızı öneririz.

3. OAuth ve izinleri yapılandırma

OAuth bu entegrasyonun temelidir. Yapılandırıldıktan sonra kullanıcılar uygulamayı Slack üzerinden yetkilendirebilir ve Quick BI'nin mesaj göndermesine izin verebilir.

3,1 Yönlendirme URL'leri

Sol gezinme bölmesinde Settings > OAuth & Permissions yolunu izleyin. Redirect URLs bölümünde Add New Redirect URL seçeneğine tıklayın.

Yapılandırma Kuralları:

OAuth yönlendirme URL'sini şu biçimde girin: https://{domain-name}/api/v2/slack/oauth/callback
Etki alanı adı, Quick BI ortamınızın etki alanıyla eşleşmelidir.

Bölgeye göre Quick BI site etki alanı adları:

Bölge	Etki alanı adı	Örnek
Çin anakarası	https://bi.aliyun.com https://bi-cn-hangzhou.alibabacloud.com	https://bi.aliyun.com/api/v2/slack/oauth/callback
Singapur	https://bi-ap-southeast-1.alibabacloud.com https://bi-ap-southeast-1.alibabacloud.com	https://bi-ap-southeast-1.alibabacloud.com/api/v2/slack/oauth/callback
Çin (Hong Kong)	https://bi-cn-hongkong.data.aliyun.com https://bi-cn-hongkong.alibabacloud.com	https://bi-cn-hongkong.alibabacloud.com/api/v2/slack/oauth/callback
Malezya (Kuala Lumpur)	https://bi-ap-southeast-3.data.aliyun.com https://bi-ap-southeast-3.alibabacloud.com	https://bi-ap-southeast-3.alibabacloud.com/api/v2/slack/oauth/callback
Endonezya (Cakarta)	https://bi-ap-southeast-5.data.aliyun.com https://bi-ap-southeast-5.alibabacloud.com	https://bi-ap-southeast-5.alibabacloud.com/api/v2/slack/oauth/callback
Almanya (Frankfurt)	https://bi-eu-central-1.alibabacloud.com	https://bi-eu-central-1.alibabacloud.com/api/v2/slack/oauth/callback
Japonya (Tokyo)	https://bi-ap-northeast-1.alibabacloud.com	https://bi-ap-northeast-1.alibabacloud.com/api/v2/slack/oauth/callback
ABD (Virginia)	https://bi-us-east-1.alibabacloud.com	https://bi-us-east-1.alibabacloud.com/api/v2/slack/oauth/callback
BAE (Dubai)	https://bi-me-central-1.data.aliyun.com	https://bi-me-central-1.data.aliyun.com/api/v2/slack/oauth/callback

URL'leri ekledikten sonra Save URLs seçeneğine tıklayın.

3,2 Bot belirteci kapsamları

Aynı sayfada, Bot Token Scopes bölümünde Add an OAuth Scope seçeneğine tıklayın ve aşağıdaki kapsamları ekleyin:

Kapsam	Amaç
chat:write	Uygulamanın üye olduğu kanallara ve konuşmalara mesaj göndermesine olanak tanır.
files:write	Uygulamanın dosya ve ek yüklemesine olanak tanır.
files:read	Uygulamanın Workspace'taki dosyalar hakkındaki bilgileri okumasına olanak tanır.
users:read	Uygulamanın Workspace'taki kullanıcıların temel bilgilerini görüntülemesine olanak tanır.
im:write	Uygulamanın kullanıcılarla doğrudan mesajlaşma konuşmaları başlatmasına olanak tanır.

3,3 Kullanıcı belirteci kapsamları

Mesajları bot yerine kullanıcı olarak göndermek için User Token Scopes bölümüne aşağıdaki kapsamları ekleyin:

Kapsam	Amaç
chat:write	Uygulamanın kullanıcı adına mesaj göndermesine olanak tanır.
files:write	Uygulamanın kullanıcı adına dosya yüklemesine olanak tanır.
files:read	Uygulamanın kullanıcının erişebileceği dosyalar hakkındaki bilgileri okumasına olanak tanır.
users:read	Uygulamanın kullanıcı hakkında temel bilgileri görüntülemesine olanak tanır.
im:write	Uygulamanın kullanıcı adına doğrudan mesajlaşma konuşmaları açmasına olanak tanır.

4. Bot kullanıcı yapılandırması

4,1 Bot temelleri

Parametre	Açıklama	Öneri
Display name	Slack'te görüntülenen ad.	Quick BI
Default username	Mesajlarda görüntülenen kullanıcı adı.	Quick BI-bot
Icon	Botun profil resmi. Quick BI logosunu kullanmanızı öneririz.	512 × 512 boyutunda bir PNG dosyası yükleyin.
Always show my bot as online	Botun her zaman çevrimiçi görünüp görünmeyeceğini belirler.	Etkinleştirildi

Önemli

İlk Bot Token Scope'unuzu eklediğinizde bir bot kullanıcısı otomatik olarak oluşturulur. Bu bölüm görünmüyorsa henüz herhangi bir bot kapsamı yapılandırmamışsınız demektir.

5. Kimlik bilgileri

Sol gezinme bölmesinde Settings > Basic Information yolunu izleyin. Bu sayfada aşağıdaki kimlik bilgilerini kopyalayın, güvenli bir yerde saklayın ve ardından Quick BI'ye girin.

Kimlik Bilgisi	Konum	Amaç
Client ID	Basic Information	OAuth yetkilendirme URL'sini oluşturmak için kullanılır.
Client secret	Basic Information	Bir yetkilendirme kodunu belirteç ile değiştirmek için kullanılır.