🔌 Entegrasyon Kurulum Rehberi
Adım adım entegrasyon kurulum talimatları
WhatsApp Business API Kurulumu
-
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 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 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 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
✓ Entegrasyon tamamlandı! WhatsApp üzerinden mesajlar otomatik yanıtlanacak.
Telegram Bot Kurulumu
Panelde alanları doldurabilirsiniz, ancak gelen mesajları işleyen servis henüz yayında değil; bu adımları tamamlasanız da bot bu kanaldan yanıt vermez. Bugün canlı olan kanallar: web widget, WhatsApp, Instagram ve Facebook Messenger.
-
1 BotFather ile Bot Oluşturun
Telegram'da @BotFather'ı bulun ve yeni bot oluşturun:
- Telegram'da
@BotFatherarayın /newbotkomutunu 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 - Telegram'da
-
2 Bot Token'ını Alın
BotFather size bir token verecek:
Token: 123456789:ABCdefGHIjklMNOpqrsTUVwxyz⚠️ Güvenlik: Bu token'ı kimseyle paylaşmayın! -
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 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 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 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 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 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
✓ Instagram DM'leriniz artık otomatik yanıtlanacak!
Web Widget Kurulumu
-
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 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 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 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
Synaptix gelen e-postaları okumaz ve otomatik yanıtlamaz. E-posta yalnızca yeni talep geldiğinde size bildirim göndermek için kullanılır.
-
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 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 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 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
Panelde alanları doldurabilirsiniz, ancak gelen mesajları işleyen servis henüz yayında değil; bu adımları tamamlasanız da bot bu kanaldan yanıt vermez. Bugün canlı olan kanallar: web widget, WhatsApp, Instagram ve Facebook Messenger.
-
1 Slack App Oluşturun
Slack API'de yeni bir uygulama oluşturun:
- api.slack.com/apps adresine gidin
- "Create New App" butonuna tıklayın
- "From scratch" seçeneğini seçin
- App adı ve workspace seçin
App Name: Synaptix AI Bot
Workspace: Your Workspace Name -
2 Bot Permissions Ayarlayın
Gerekli izinleri ekleyin:
- OAuth & Permissions → Scopes
chat:write- Mesaj göndermechannels:read- Kanal okumachannels:history- Mesaj geçmişiim:read- DM okumaim:write- DM yazma
-
3 Bot Token ve Webhook Alın
OAuth token ve webhook URL'ini kopyalayın:
- OAuth & Permissions → Bot User OAuth Token
- Incoming Webhooks → Webhook URL
Bot Token: xoxb-1234567890-1234567890-abcdefghijklmnop
Webhook URL: https://hooks.slack.com/services/T00/B00/XXXX⚠️ Güvenlik: Token'ları güvenli bir yerde saklayın! -
4 Workspace'e Yükleyin
Uygulamayı workspace'inize yükleyin:
- Install App → Install to Workspace
- İzinleri onaylayın
- Botunuzu kanallara davet edin:
/invite @Synaptix
-
5 Synaptix'e Bağlayın
Token'ları Synaptix'e ekleyin:
- Entegrasyonlar → Slack
- Bot Token'ı yapıştırın
- Webhook URL'ini girin
- "Bağlan" butonuna basın
Bu adımlar kanal yayına alındığında geçerli olacaktır.
❓ Sık Sorulan Sorular
Entegrasyon türüne göre değişir:
- Web Widget: 5-10 dakika
- Email: 10-15 dakika
- Telegram: 5-10 dakika
- WhatsApp: 30-60 dakika (onay süreci dahil)
- Instagram: 20-30 dakika
API güvenliği için önerilerimiz:
- API anahtarlarınızı asla herkese açık yerlerde paylaşmayın
- Düzenli olarak token'larınızı yenileyin
- Sadece gerekli izinleri verin
- Synaptix tüm API anahtarlarını şifreli olarak saklar
- İki faktörlü kimlik doğrulama kullanın
Evet! Paketinize göre:
- Starter: Web Widget + Email (2 entegrasyon)
- Pro: Tüm entegrasyonlar (Slack hariç)
- Enterprise: Tüm entegrasyonlar + özel entegrasyonlar
Tüm entegrasyonlar aynı bot tarafından yönetilir ve tutarlı yanıtlar verir.
Sorun giderme adımları:
- API anahtarlarının doğru girildiğinden emin olun
- Entegrasyonun "Aktif" durumda olduğunu kontrol edin
- Webhook URL'lerinin doğru yapılandırıldığını kontrol edin
- Firewall veya güvenlik ayarlarını kontrol edin
- Synaptix destek ekibiyle iletişime geçin: info@synaptixai.services
WhatsApp Business API fiyatlandırması:
- İlk 1.000 konuşma/ay ücretsiz (Meta tarafından)
- Sonraki konuşmalar için ücretlendirme yapılır
- Fiyatlar ülkeye göre değişir
- Synaptix entegrasyon ücreti almaz, sadece Meta'nın ücretleri geçerlidir
Detaylı fiyatlandırma için: Meta WhatsApp Pricing
Evet, istediğiniz zaman:
- Entegrasyonlar sayfasına gidin
- Durdurmak istediğiniz entegrasyona tıklayın
- "Duraklat" veya "Devre Dışı Bırak" butonuna basın
- Entegrasyon anında durdurulur
- İstediğiniz zaman tekrar aktif edebilirsiniz
Synaptix 100+ dilde destek verir:
- Otomatik dil algılama aktif
- Müşteri hangi dilde yazarsa o dilde yanıt verilir
- Türkçe, İngilizce, Almanca, Fransızca, İspanyolca, Arapça, Çince, Japonca ve daha fazlası
- Tüm entegrasyonlarda çok dilli destek mevcuttur
💬 Yardıma mı İhtiyacınız Var?
Entegrasyon kurulumunda sorun yaşıyorsanız, destek ekibimiz size yardımcı olmaktan mutluluk duyar.