WhatsApp API Kurulum Rehberi: HesaplaSat'a Bağlama (2026)
HesaplaSat WhatsApp Pazarlama modülü, kendi WhatsApp Business numaranızı Meta Cloud API ile bağlayarak onaylı şablonlarla toplu mesaj göndermenizi, gelen mesajları tek panelden yönetmenizi sağlar. Mesaj ücretleri doğrudan sizin Meta hesabınıza yansır; HesaplaSat yalnızca gönderimi yönetir.
Bu rehberde Meta uygulaması oluşturmaktan kalıcı token üretmeye, App ID bulmaktan webhook kurulumuna kadar tüm adımları sırayla anlatıyoruz. Kurulum ortalama 15 dakika sürer ve bir kereye mahsustur.
1. Meta for Developers uygulaması oluşturun
developers.facebook.com/apps adresine gidin ve 'Uygulama Oluştur' deyin. Uygulama türü olarak 'İşletme' (Business) seçin ve uygulamanıza bir ad verin.
Uygulama panelinde 'Ürün Ekle' bölümünden WhatsApp ürününü ekleyin. Bu adım, size bir test numarası ve API erişimi tanımlar.
WhatsApp > API Kurulumu (API Setup) ekranında 'Phone Number ID' (Telefon Numarası ID) ve 'WhatsApp Business Account ID' (WABA ID) değerlerini görürsünüz. Bu iki değeri kopyalayıp not alın; HesaplaSat Bağlantı ekranına gireceksiniz.
2. Kalıcı (System User) token üretin
API Kurulumu ekranındaki geçici token yalnızca 24 saat geçerlidir. Sürekli kullanım için kalıcı bir System User token'ı üretmelisiniz.
business.facebook.com > İşletme Ayarları > Kullanıcılar > Sistem Kullanıcıları bölümüne gidin. Yeni bir sistem kullanıcısı oluşturun (rol: Yönetici).
Oluşturduğunuz sistem kullanıcısına 'Varlık Ekle' ile WhatsApp hesabınızı (WABA) atayın ve tam erişim verin. Ardından 'Token Oluştur' deyin.
Token izinleri olarak whatsapp_business_messaging ve whatsapp_business_management izinlerini seçin. Üretilen 'EAA...' ile başlayan token'ı kopyalayın — bu token'ı yalnızca bir kez görürsünüz, güvenli bir yere kaydedin.
3. App ID'yi bulun (profil fotoğrafı ve medyalı şablon için)
Profil fotoğrafı yükleme ve fotoğraf/belge başlıklı şablon oluşturma özellikleri Meta'nın App ID değerini gerektirir.
App ID'yi Meta uygulamanızın panelinde Uygulama Ayarları > Temel (Basic) bölümünde 'Uygulama Kimliği' olarak bulabilirsiniz (örn. 1033097342637860).
Bu değeri HesaplaSat Bağlantı ekranındaki opsiyonel 'App ID' alanına girin. App ID girmeden metin tabanlı şablon ve mesaj gönderimi çalışır; yalnızca profil fotoğrafı ve medyalı başlık için gereklidir.
4. HesaplaSat paneline bağlanın
HesaplaSat panelinde WhatsApp Pazarlama > Bağlantı ekranını açın. Phone Number ID, WABA ID ve kalıcı Token alanlarını doldurun; App ID ve App Secret opsiyoneldir.
'Bağlan ve Doğrula' butonuna basın. Bilgiler doğruysa numaranızın doğrulanmış adı ve kalite puanı ekranda görünür.
Daha sonra token'ınız değişirse 'Token Güncelle' ile yalnızca token'ı yenileyebilir, App ID'yi ekleyebilirsiniz; Telefon/WABA ID aynı kalır.
5. Webhook kurun (gelen mesajlar için)
Gelen mesajların panelde görünmesi için Meta uygulamanızda webhook tanımlamalısınız. Bağlantı ekranındaki 'Callback URL' ve 'Verify Token' değerlerini kopyalayın.
Meta uygulamanızda WhatsApp > Configuration bölümüne bu Callback URL ve Verify Token'ı girin, ardından 'messages' alanına abone olun (subscribe).
Kurulum tamamlandığında müşterilerinizin gönderdiği mesajlar, fotoğraflar ve belgeler HesaplaSat Gelen Kutusu'nda gerçek zamanlı görünür; buradan 24 saatlik pencere içinde ücretsiz yanıt verebilirsiniz.
Sıkça sorulan sorular
WhatsApp API kullanmak ücretli mi?
Meta, konuşma başına ücret alır (ilk müşteri kaynaklı 1000 konuşma/ay bazı durumlarda ücretsizdir). Ücretler doğrudan sizin Meta hesabınıza yansır; HesaplaSat ek mesaj ücreti almaz, yalnızca gönderim ve şablon yönetimini sağlar.
Numaramı hem telefonda hem API'de kullanabilir miyim?
Hayır. Bir numara Cloud API'ye bağlandığında normal WhatsApp/WhatsApp Business uygulamasında aynı anda kullanılamaz. API'ye bağlamadan önce numarayı uygulamadan çıkarmanız gerekir. Bu yüzden pazarlama için ayrı bir numara önerilir.
Token neden 24 saat sonra çalışmıyor?
API Kurulumu ekranındaki geçici token 24 saatliktir. Sürekli çalışması için System User ile kalıcı token üretip HesaplaSat'a girmelisiniz (rehberin 2. adımı).
App ID zorunlu mu?
Metin şablonları ve mesaj gönderimi için hayır. Yalnızca işletme profil fotoğrafı yüklemek ve fotoğraf/belge başlıklı şablon oluşturmak için gereklidir. Bağlantı ekranından sonradan da ekleyebilirsiniz.
Toplu mesaj göndermek için şablon şart mı?
Evet. 24 saatlik pencere dışındaki ilk temas için Meta tarafından onaylanmış şablon kullanmanız gerekir. HesaplaSat Şablonlar ekranından şablon oluşturup Meta onayına gönderebilir, onaylananları kampanyalarda kullanabilirsiniz.