🔌 Entegrasyon Kurulum Rehberi

📱 WhatsApp Business API Kurulumu

1. 1 WhatsApp Business Hesabı Oluşturun

   WhatsApp Business API'ye erişim için Meta Business Suite'e kaydolun:

   • business.facebook.com adresine gidin
   • "WhatsApp" sekmesine tıklayın
   • "Başlayın" butonuna basın
   • İşletme bilgilerinizi doldurun
2. 2 Telefon Numaranızı Doğrulayın

   WhatsApp Business için kullanacağınız telefon numarasını doğrulayın:

   ⚠️ Önemli: Bu numara daha önce WhatsApp'ta kullanılmamış olmalıdır.

   • SMS veya telefon araması ile doğrulama yapın
   • 6 haneli kodu girin
   • İşletme profilinizi oluşturun
3. 3 API Anahtarlarını Alın

   Meta Business Suite'ten API anahtarlarınızı alın:

   • WhatsApp Manager → API Setup
   • "Access Token" kopyalayın
   • "Phone Number ID" not edin
   • "WhatsApp Business Account ID" kaydedin

   Access Token: EAAxxxxxxxxxxxxxxxxxxxxxxx
   Phone Number ID: 123456789012345
   Business Account ID: 987654321098765
4. 4 Synaptix'e Entegre Edin

   Aldığınız bilgileri Synaptix entegrasyon paneline girin:

   • Entegrasyonlar sayfasına gidin
   • WhatsApp kartına tıklayın
   • API bilgilerinizi yapıştırın
   • "Kaydet ve Aktif Et" butonuna basın

   Kanal kullanıma açıldığında bu adım tamamlanır ve WhatsApp mesajları otomatik yanıtlanır. O zamana kadar kayıt panelde bekler.

✈️ Telegram Bot Kurulumu

1. 1 BotFather ile Bot Oluşturun

   Telegram'da @BotFather'ı bulun ve yeni bot oluşturun:

   • Telegram'da @BotFather arayın
   • /newbot komutunu gönderin
   • Botunuza bir isim verin (örn: "Synaptix Destek")
   • Benzersiz bir kullanıcı adı seçin (örn: "synaptix_support_bot")

   /newbot
   Bot adı: Synaptix Destek
   Kullanıcı adı: synaptix_support_bot
2. 2 Bot Token'ını Alın

   BotFather size bir token verecek:

   Token: 123456789:ABCdefGHIjklMNOpqrsTUVwxyz

   ⚠️ Güvenlik: Bu token'ı kimseyle paylaşmayın!
3. 3 Bot Ayarlarını Yapılandırın

   BotFather'da bot ayarlarınızı özelleştirin:

   • /setdescription - Bot açıklaması ekleyin
   • /setabouttext - Hakkında metni yazın
   • /setuserpic - Profil fotoğrafı yükleyin
   • /setcommands - Komutları tanımlayın
4. 4 Synaptix'e Bağlayın

   Token'ı Synaptix'e ekleyin:

   • Entegrasyonlar sayfasına gidin
   • Telegram kartına tıklayın
   • Bot Token'ınızı yapıştırın
   • "Bağlan" butonuna basın

   Bu adımlar kanal yayına alındığında geçerli olacaktır.

📸 Instagram Direct Kurulumu

1. 1 Instagram Business Hesabına Geçin

   Instagram hesabınızı Business hesabına dönüştürün:

   • Instagram uygulamasını açın
   • Ayarlar → Hesap → Profesyonel hesaba geç
   • "İşletme" seçeneğini seçin
   • Kategori ve iletişim bilgilerini doldurun
2. 2 Facebook Sayfasına Bağlayın

   Instagram hesabınızı Facebook sayfanıza bağlayın:

   • Instagram Ayarlar → Hesap → Bağlı hesaplar
   • Facebook'u seçin ve giriş yapın
   • Bağlamak istediğiniz Facebook sayfasını seçin

   ⚠️ Instagram Business API için Facebook sayfası gereklidir.
3. 3 Meta Business Suite'te Yapılandırın

   Meta Business Suite'te Instagram API'yi aktif edin:

   • business.facebook.com → Instagram
   • "Mesajlaşma" sekmesine gidin
   • "API Erişimi" bölümünü bulun
   • Access Token oluşturun
4. 4 Synaptix'e Entegre Edin

   API bilgilerinizi Synaptix'e ekleyin:

   • Entegrasyonlar sayfasına gidin
   • Instagram kartına tıklayın
   • Access Token ve Instagram Business Account ID'yi girin
   • "Kaydet" butonuna basın

   Kanal kullanıma açıldığında Instagram DM’leriniz otomatik yanıtlanır. O zamana kadar kayıt panelde bekler.

🌐 Web Widget Kurulumu

1. 1 Widget Kodunu Alın

   Synaptix'ten widget kodunuzu kopyalayın:

   • Entegrasyonlar → Web Widget
   • "Widget Kodu Al" butonuna tıklayın
   • Kodu kopyalayın

   <script src="/widget.js" data-bot-id="YOUR_BOT_ID" data-widget-token="YOUR_WIDGET_TOKEN"></script>
2. 2 Websitenize Ekleyin

   Widget kodunu websitenizin </body> etiketinden hemen önce yapıştırın:

   • HTML dosyanızı açın
   • </body> etiketini bulun
   • Widget kodunu hemen üstüne yapıştırın
   • Dosyayı kaydedin

   💡 İpucu: WordPress kullanıyorsanız, Tema Ayarları → Footer Scripts bölümüne ekleyin.
3. 3 Widget'ı Özelleştirin

   Widget görünümünü markanıza göre ayarlayın:

   • Renk teması (light/dark)
   • Konum (sağ alt/sol alt)
   • Karşılama mesajı
   • Avatar ve logo
4. 4 Test Edin

   Widget'ın çalıştığından emin olun:

   • Websitenizi yenileyin
   • Sağ alt köşede chat ikonu görünmeli
   • İkona tıklayın ve test mesajı gönderin
   • Bot yanıt veriyorsa kurulum başarılı!

   ✓ Widget aktif! Ziyaretçileriniz artık botunuzla konuşabilir.

📧 Email Destek Kurulumu

1. 1 Destek Email Adresi Belirleyin

   Müşteri desteği için kullanacağınız email adresini seçin:

   • Örnek: support@sirketiniz.com
   • Örnek: destek@sirketiniz.com
   • Örnek: info@sirketiniz.com

   ⚠️ Bu email adresine gelen tüm mesajlar bot tarafından yanıtlanacak.
2. 2 Email Yönlendirme Ayarlayın

   Email sağlayıcınızda yönlendirme kuralı oluşturun:

   • Gmail: Ayarlar → Yönlendirme ve POP/IMAP
   • Outlook: Ayarlar → Kurallar → Yeni kural
   • cPanel: Email Forwarders

   Gelen emailları şu adrese yönlendirin:

   bot-[YOUR_BOT_ID]@mail.synaptix.com
3. 3 Synaptix'te Yapılandırın

   Email entegrasyonunu aktif edin:

   • Entegrasyonlar → Email Support
   • Destek email adresinizi girin
   • Yanıt şablonunu özelleştirin
   • "Aktif Et" butonuna basın
4. 4 Test Emaili Gönderin

   Kurulumu test edin:

   • Destek email adresinize test mesajı gönderin
   • Bot otomatik yanıt vermeli (1-2 dakika içinde)
   • Yanıt gelmediyse yönlendirme ayarlarını kontrol edin

   ✓ Email desteği aktif! Gelen emailler otomatik yanıtlanacak.

💼 Slack Workspace Kurulumu

1. 1 Uygulamayı Manifestten Oluşturun

   Uygulamayı sıfırdan değil, hazır manifestten oluşturun:

   • api.slack.com/apps adresine gidin
   • “Create New App” → “From an app manifest” deyin; “From scratch” değil
   • Botun çalışacağı Slack çalışma alanını seçin
2. 2 Hazır Manifesti Yapıştırın

   Manifesti sihirbazın Slack panelindeki “Manifesti kopyala” düğmesiyle alın ve Slack’in açtığı YAML kutusuna yapıştırın. Manifest yalnızca üç izin ister:

   • im:history — bota özelden yazılan mesajları okur
   • app_mentions:read — kanalda yalnızca bota @bahsedilen mesajları okur
   • chat:write — bot yanıtını yazar

   Manifest ayrıca features.app_home bloğunu taşır: bota özelden yazılabilmesi için gereken mesaj sekmesini açan blok budur.

   Bu ilk manifestte event_subscriptions bilerek yoktur. Sebebi 5. adımda anlatılıyor: Slack, Request URL’i girdiğiniz anda adresi sınar ve o sınamayı ancak imzalama sırrı bizde kayıtlıysa yanıtlayabiliriz.
3. 3 Uygulamayı Kurun ve Bot Jetonunu Alın

   Uygulamayı çalışma alanınıza kurun ve bot jetonunu kopyalayın:

   • “Install to Workspace” deyin ve izinleri onaylayın
   • “OAuth & Permissions” sayfasını açın
   • “Bot User OAuth Token” değerini kopyalayın; xoxb- ile başlar

   Bot User OAuth Token: xoxb-1234567890-1234567890-abcdefghijklmnop

   ⚠️ Güvenlik: Bu jeton botun tam denetimidir. Kimseyle paylaşmayın.
4. 4 Signing Secret Değerini Kopyalayın

   İkinci değer, Slack’ten gelen isteklerin gerçekten Slack’ten geldiğini doğrulamamızı sağlayan imzalama sırrıdır:

   • “Basic Information” sayfasını açın
   • “App Credentials” bölümünde “Signing Secret” satırını bulun
   • “Show” deyip değeri kopyalayın

   ⚠️ Hemen üstündeki “Client Secret” değil. İki değer aynı bölümde alt alta durur. Doğru olan, altında “Slack signs the requests we send you using this secret” yazan satırdır.
5. 5 Sihirbazda İki Alanı Doldurup Bağlanın

   Synaptix tarafına dönün:

   • Bot kurulum sihirbazında botunuzun Slack panelini açın
   • Bot jetonunu (xoxb-) ve imzalama sırrını yapıştırın
   • “Bağlan” düğmesine basın

   ⚠️ Bu adım atlanamaz ve sırası önemlidir. İmzalama sırrı sunucumuzda kayıtlı değilken Slack’in doğrulama isteğini reddediyoruz (HTTP 503). Yani Request URL’i Slack’e önce yapıştırırsanız Slack adresi doğrulayamaz.
6. 6 Request URL’i Event Subscriptions’a Yapıştırın

   Sihirbazı bitirin: son adım ekranı, Slack’e yapıştıracağınız Request URL’i verir. Adresi kopyalayın ve Slack’e dönün:

   • “Event Subscriptions” sayfasını açın
   • “Enable Events” anahtarını açın
   • Request URL’i yapıştırın ve yeşil “Verified” yazısını bekleyin
7. 7 İki Olaya Abone Olun

   Aynı sayfada “Subscribe to bot events” bölümünü açın ve “Add Bot User Event” ile iki olay ekleyin:

   • message.im — bota gelen özel mesaj
   • app_mention — kanalda bota @bahsedilmesi

   “Save Changes” düğmesiyle kaydedin.

8. 8 App Home’da Mesaj Sekmesini Açın

   “App Home” sayfasını açın ve “Show Tabs” altında iki şeyi birden yapın:

   • “Messages Tab” anahtarını açın
   • “Allow users to send Slash commands and messages from the messages tab” kutusunu işaretleyin

   ⚠️ İkisi birden gerekir. Yalnızca sekmeyi açmak yazmayı açmaz; kutu işaretlenmezse Slack mesaj kutusunu kapalı tutar ve bota özelden yazılamaz.
9. 9 Slack’ten Yazın ve Yanıtı Görün

   Slack’te bota özelden bir mesaj yazın.

   ✓ Bot tek bir yanıt vermeli. Yanıt geldiyse kanal çalışıyor demektir.

💬 Yardıma mı İhtiyacınız Var?

Entegrasyon kurulumunda sorun yaşıyorsanız, destek ekibimiz size yardımcı olmaktan mutluluk duyar.