Mesajlaşma Entegrasyonları Kurulum Rehberi

Otomatik İletişim Hatları

Mesajlaşma uygulamalarını Orbitus'a bağlamak, ekibinize gerçek zamanlı uyarılar veya müşterilerinize doğrudan otomatik işlemsel bildirimler göndermenizi sağlar. Her bir sağlayıcıyı yapılandırmak için aşağıdaki ayrıntılı kılavuzları izleyin.

---

1. Slack Entegrasyonu

Belirli kanallarda (ör. #satis, #devops-uyarilari) anında bildirim almak için kurumsal Slack çalışma alanınızı (workspace) bağlayın.

Gerekli Kimlik Bilgileri

• Webhook URL: Slack tarafından oluşturulan ve belirli bir kanalı hedefleyen benzersiz uç nokta URL'si.

Adım Adım Kurulum

1. Slack Uygulaması Oluşturun: Slack API Apps adresine gidin ve "Create New App" (Yeni Uygulama Oluştur) düğmesine tıklayın. "From scratch" (Sıfırdan) seçeneğini seçin.
2. Webhook'ları Etkinleştirin: Uygulama ayarları kenar çubuğunda Incoming Webhooks (Gelen Webhook'lar) seçeneğine tıklayın ve anahtarı "On" (Açık) konumuna getirin.
3. Çalışma Alanına Ekle: "Add New Webhook to Workspace" (Çalışma Alanına Yeni Webhook Ekle) düğmesine tıklayın. Bildirim göndermek istediğiniz kanalı seçin.
4. URL'yi Kopyalayın: Slack, https://hooks.slack.com/services/T0000/B000/XXXX şeklinde bir URL oluşturacaktır. Bunu kopyalayın.
5. Orbitus'u Yapılandırın: Orbitus > Entegrasyonlar > Slack adresine gidin. Webhook URL'nizi alana yapıştırın.
6. Test Et ve Kaydet: İsteğe bağlı bir test mesajı girin. Bağlantıyı Test Et'e tıklayın. Başarılı olursa Slack'ten mesaj alırsınız; ardından Entegrasyonu Kaydet'e tıklayın.

---

2. Telegram Entegrasyonu

Doğrudan mobil cihazınıza veya bir Telegram Grubuna uyarı göndermek için bir Telegram Botu bağlayın.

Gerekli Kimlik Bilgileri

• Bot Token: BotFather tarafından sağlanır.
• Chat ID: Botun mesaj göndereceği belirli kullanıcı veya grup kimliği.

Adım Adım Kurulum

1. Bot Oluşturun: Telegram'ı açın ve @BotFather'ı arayın. /newbot mesajını gönderin.
2. Token'ı Alın: BotFather size bir HTTP API token'ı verecektir (ör. 123456789:ABCDefgh...). Bunu kopyalayın.
3. Chat ID'yi Alın: Botunuzla bir sohbet başlatın ve "Merhaba" deyin. Ardından bunu @userinfobot'a ileterek Chat ID'nizi öğrenebilirsiniz (ör. 123456789).
4. Orbitus'u Yapılandırın: Orbitus > Entegrasyonlar > Telegram bölümüne girin. Hem Bot API Token'ı hem de Chat ID'yi yapıştırın.
5. Test Et ve Kaydet: Bağlantıyı Test Et'e tıklayın ve çalışıyorsa Entegrasyonu Kaydedin.

---

3. WhatsApp Business API

Müşterilerinize şablon mesajlar göndermek için Meta'nın resmi WhatsApp Business API'sini bağlayın.

Gerekli Kimlik Bilgileri

• Access Token (Erişim Belirteci): Meta Developer Portal'dan Sistem Kullanıcısı belirteci.
• Phone Number ID (Telefon Numarası Kimliği): Numaranızla ilişkili benzersiz ID.

Adım Adım Kurulum

1. Meta Business Suite: Meta Business Suite'e giriş yapın ve onaylı bir ticari hesabınız olduğundan emin olun.
2. Geliştirici Portalı: Meta for Developers'a gidin. Bir "Uygulama" (App) oluşturun ve WhatsApp ürününü ekleyin.
3. Kalıcı Token Oluşturun: Geçici token hızla sona erer. Kalıcı bir token için İşletme Ayarları > Sistem Kullanıcıları'na (System Users) gidin. Bir nesne oluşturun ve whatsapp_business_messaging izinlerine sahip bir token oluşturun.
4. Orbitus'u Yapılandırın: Orbitus > Entegrasyonlar > WhatsApp adresinde token'ı ve Phone Number ID'yi yapıştırın, ardından test edip kaydedin.