WhatsApp Kurulum Rehberi

Kendi WhatsApp Business numaranızı SatışDM paneline elle bağlamanın adımları. Bu yol Meta onayı beklemeden bugün çalışır.

B. Kendi numaranızı bağlama

B1. Hazırlık

• Meta Business hesabı (Business portfolio): business.facebook.com adresinden oluşturun.
• Bir telefon numarası: SMS ya da arama alabilen bir numara olmalı.
  • Numara şu an telefondaki WhatsApp ya da WhatsApp Business uygulamasında kayıtlıysa, Cloud API'ye bağlamak için genellikle önce uygulamadan silinmesi gerekir.
  • Meta'nın "birlikte kullanım" (coexistence) seçeneği bazı durumlarda uygulamayla birlikte kullanmaya izin verir. Numaranız için geçerli olup olmadığını kurulum sırasında Meta gösterir.
• Ödeme yöntemi: Meta, işletmenin gönderdiği mesajları ücretlendirir. Güncel fiyatlar için Meta'nın fiyat sayfasına bakın; bazı kaynaklar 1 Ekim 2026'dan itibaren müşteri hizmetleri yanıtlarının da ücretlendirileceğini bildiriyor.

B2. Meta'da uygulama oluşturun

1. developers.facebook.com → Uygulamalarım (My Apps) → Uygulama oluştur (Create app).
2. Uygulamaya bir ad verin (ör. işletmenizin adı) ve iletişim e-postanızı yazın → İleri (Next).
3. Kullanım örnekleri (Use cases) ekranında WhatsApp ile müşterilerle bağlantı kurun (Connect with customers through WhatsApp) seçeneğini seçin → İleri.
4. Uygulamayı B1'deki Business hesabınıza (Business portfolio) bağlayın ve oluşturmayı bitirin.
5. Sol menüde WhatsApp başlığı görünür; altındaki API Kurulumu (API Setup) sayfası B3'te kullanılır.

B3. Numaranızı ekleyin ve "Telefon numarası kimliği"ni alın

1. WhatsApp → API Kurulumu (API Setup) sayfasına gidin.
2. Telefon numarası ekle (Add phone number) ile numaranızı ekleyin. Görünen ad (display name) girip SMS ya da aramayla doğrulayın.
3. Numaranızı seçin ve altındaki Telefon numarası kimliği (Phone number ID) değerini kopyalayın.
   • Bu değer yalnızca rakamlardan oluşan uzun bir sayıdır (ör. 106540352242922). Telefon numaranızın kendisi değildir.

B4. Kalıcı erişim anahtarı oluşturun

1. business.facebook.com → Ayarlar (Settings) → Kullanıcılar → Sistem kullanıcıları (Users → System users).
2. Ekle (Add) ile yeni bir sistem kullanıcısı oluşturun (rol: Yönetici / Admin).
3. Varlık ata (Assign assets):
   • B2'deki uygulamanızı seçin ve tam kontrol verin.
   • WhatsApp hesabınızı seçin ve tam kontrol verin.
4. Yeni anahtar oluştur (Generate new token):
   • Uygulamanızı seçin.
   • Süre olarak Hiçbir zaman (Never) seçin.
   • Şu izinleri işaretleyin: whatsapp_business_messaging, whatsapp_business_management, business_management
5. Çıkan anahtarı kopyalayın. Meta bunu yalnızca bir kez gösterir.

B5. Uygulama gizli anahtarını alın

1. developers.facebook.com → uygulamanız → sol menüde Uygulama ayarları → Temel (App settings → Basic).
2. Sayfanın üstünde, Uygulama Kimliği'nin sağındaki Uygulama sırrı (App secret) kutusunun yanındaki Göstermek (Show) düğmesine basın. Meta Facebook şifrenizi isteyebilir; şifreyi Meta'nın penceresine yazın.
3. Kutuda 32 karakterlik harf-rakam dizisi görünür. Üzerine çift tıklayıp seçin ve Ctrl+C ile kopyalayın.

B6. Bilgileri SatışDM paneline girin

1. Panele giriş yapın → sağ üstteki WhatsApp düğmesi.
2. Açılan pencerenin altındaki İleri düzey: bilgileri elle gir yazısına tıklayın; bölüm açılır.
3. 1. Numaranızın bilgilerini kaydedin bölümüne şunları yapıştırın:
   • Telefon numarası kimliği (B3)
   • Kalıcı erişim anahtarı (B4)
   • Uygulama gizli anahtarı (B5)
4. Bu bölümün altındaki Bağla düğmesine basın (pencerenin üstündeki mor WhatsApp'ı bağla düğmesi değil). Bilgiler kaydedilmeden önce Meta'da denenir.
   • Başarılı olursa düğmenin yanındaki nokta yeşile döner.
   • Meta kabul etmezse sebebi pencerede yazar.

B6.1. Numarayı Cloud API'ye kaydedin (PIN)

Numaranın WhatsApp'tan mesaj alıp gönderebilmesi için Cloud API'ye kayıtlı olması gerekir.

1. Panelde WhatsApp penceresindeki Bağlantı durumu bölümüne bakın. Cloud API kaydı satırı numaranın kayıtlı olup olmadığını gösterir. Bilgi Meta'dan en geç dakikada bir güncellenir.
   • Kayıtlı (yeşil): Bu adımı atlayın.
   • Kayıtlı değil (sarı): Pencerenin üstündeki kutu da sarı olur ve numaranın henüz Cloud API'ye kayıtlı olmadığını yazar.
   • Kayıt durumu Meta'dan alınamadı: Meta bu bilgiyi vermemiştir. Mesajlaşma çalışıyorsa numara kayıtlıdır; çalışmıyorsa kaydı deneyin.
   • Meta bazı numaralarda ayrıca bir Numara durumu (ör. Bağlı / CONNECTED) bildirir. Bildirmezse bu satır görünmez.
2. Numara kayıtlı değilse kayıt bölümüne 6 haneli PIN'i yazıp Kaydet'e basın.
   • Numarada iki adımlı doğrulama açıksa mevcut PIN'i girin.
   • Açık değilse girdiğiniz PIN, numaranın PIN'i olur.
3. Kayıt başarılı olunca Cloud API kaydı satırında Kayıtlı yazar.

B7. Meta'da webhook'u kurun

Webhook, müşteri mesajlarının Meta'dan SatışDM'ye gelmesini sağlar.

1. Paneldeki WhatsApp penceresinin 2. Meta'da webhook'u kurun bölümünden iki değeri kopyalayın:
   • Geri arama URL'si
   • Doğrulama belirteci
   • Adres http://localhost ile başlıyorsa uyarı çıkar: site henüz yayında değildir, Meta bu adresi kabul etmez. Site yöneticisine bildirin.
2. developers.facebook.com → uygulamanız → WhatsApp → Yapılandırma (Configuration) → Webhook → Düzenle (Edit).
3. İki değeri ilgili alanlara yapıştırın → Doğrula ve kaydet (Verify and save).
4. Aynı sayfadaki Webhook alanları (Webhook fields) listesinde messages satırına abone olun (Subscribe).

B8. Uygulamayı canlıya alın

• Uygulama Geliştirme (Development) modundayken genellikle yalnızca test olarak eklenmiş numaralarla yazışılabilir.
• Gerçek müşterilerle çalışmak için uygulamayı Canlı (Live) moda alın: sol menüde Yayın (Publish) → eksikleri tamamlayıp yayınlayın. Meta bunun için şunları isteyebilir:
  • Gizlilik politikası adresi (Uygulama ayarları → Temel → Gizlilik politikası URL'si)
  • Uygulama simgesi ve kategori
  • Bazı hesaplarda işletme doğrulaması
• Bu adımlar hesaba göre değişir; Meta Yayın sayfasında eksikleri gösterir.
• Ödeme yöntemi: WhatsApp Yöneticisi (WhatsApp Manager) → Ödeme ayarları (Payment settings) bölümünden ekleyin. Ödeme yöntemi yoksa ücretli mesajlar gönderilmez.

B9. Deneyin

1. Başka bir telefondan numaranıza WhatsApp mesajı gönderin.
2. Temsilciniz birkaç saniye içinde yanıt vermeli.
3. Konuşma panelde Konuşmalar sekmesinde görünmeli.

C. Panelden müşteriye elle yazma

• Yalnızca WhatsApp konuşmalarında: Konuşmayı açın ve alttaki kutudan yazın. Enter gönderir, Shift+Enter alt satıra geçer.
• Elle yazınca temsilci durur: Siz yazınca temsilci o müşteriye yanıt vermeyi bırakır.
  • Temsilciyi başlat ile istediğiniz an geri açabilirsiniz.
  • Başlatmazsanız 24 saat sonra kendiliğinden devreye girer. Süre, temsilcinin durduğu andan ya da son elle mesajınızdan (hangisi daha geçse) başlar; yani müşteriyle yazıştıkça süre uzar.
  • Panelde konuşmanın üstünde temsilcinin hangi saatte döneceği yazar.
• Müşteri ekibe aktarılınca da durur: Müşteri yetkiliyle görüşmek isteyip size aktarılırsa temsilci yine durur ve aynı 24 saat kuralı geçerlidir. Listede Size aktarıldı rozeti çıkar.
• 24 saat kuralı: WhatsApp, müşterinin son mesajının üzerinden 24 saat geçtiyse serbest mesaj gönderilmesine izin vermez. Bu durumda panel uyarı gösterir. Müşteri yeniden yazınca pencere tekrar açılır.

D. Sorun giderme

Kaynaklar

• Meta — WhatsApp Cloud API: Başlarken
• Meta — WhatsApp Business Platform fiyatlandırması
• Meta — Webhook'lar