WhatsApp Business Platform ile başlayın
WhatsApp Business Platform, Meta’nın WhatsApp mesajlarını ölçekli biçimde gönderip almak için sunduğu resmi API’dir — sipariş güncellemelerinin, randevu hatırlatmalarının ve zaten mesajlaştığınız işletmelerin destek sohbetlerinin arkasındaki platformun kendisi. Orbit üzerinden, Meta’nın Cloud API’sini doğrudan entegre etmeden, tek bir REST çağrısı ve tek bir API anahtarıyla kullanırsınız. Bu kılavuz sizi sıfırdan ilk teslim edilen mesajınıza götürür. Zaten bağlı bir WhatsApp Business Account (WABA) varsa, 3. Adım bölümüne atlayın.Platform nasıl çalışır
Göndereceğiniz her şeyi iki kural şekillendirir. Önce bunları anlayın; API’nin geri kalanı anlaşılırdır.- Bir görüşmeyi başlatmak için onaylı bir şablon gerekir. Sizin önce gönderdiği her mesaj — sipariş onayı, tek kullanımlık şifre, kargo güncellemesi — Meta’nın inceleyip onayladığı bir şablon kullanmalıdır. Şablonlar dört kategoridedir: authentication, utility, marketing ve service. Kategori, ne ödeyeceğinizi belirler.
- Bir yanıt 24 saatlik pencere açar. Bir müşteri size yazdığında 24 saatlik bir hizmet penceresi açılır. Pencere içinde serbest biçimli (şablonsuz) mesaj gönderebilirsiniz — düz metin, medya, etkileşimli butonlar. Pencere kapanınca yeniden yalnızca şablonlara dönersiniz. Tam model için The 24-hour window sayfasına bakın.
Başlamadan önce
Gerekenler:- Bir Orbit hesabı ve canlı bir API anahtarı (Settings → API Keys). Canlı anahtarlar
dv_live_sk_öneki taşır; yalnızca sunucu tarafında tutun. - Orbit’e bağlı bir WhatsApp Business Account (WABA). Henüz yoksa 1. Adım bölümünü izleyin — hesabın, numaranın ve doğrulamanın tamamı WABA setup guide sayfasındadır.
1
Connect a WhatsApp Business Account
Orbit panelinde Settings → Channels → WhatsApp → Connect yoluna gidin ve Meta’nın gömülü kayıt akışını tamamlayın: Business Manager’ınızı seçin, bir WABA oluşturun veya seçin, telefon numaranızı SMS veya sesli kodla doğrulayın.Numara doğrulandığı anda göndermeye başlayabilirsiniz — Meta’nın işletme doğrulamasının bitmesini beklemeniz gerekmez. Doğrulama tamamlanana dek yeni bir WABA 24 saatte 250 benzersiz alıcı ile sınırlıdır.Bağlantı sihirbazı sırasında Meta, işletme belgelerinizin yanı sıra WABA görünen adınızı (display name) de inceler. Görünen ad, müşterilerinizin sizi tanıdığı gerçek işletme adınızla aynı olmalıdır; yanıltıcı veya jenerik adlar reddedilir. Bu adımın derinliği — Meta’nın istediği belgeler, numara seçme veya taşıma ve görünen ad onayı — WABA setup guide sayfasındadır. Görünen ad ve işletme doğrulaması birer Meta kararıdır; Orbit sonucu veya süreyi garanti edemez.
2
Create and approve a template
Channels → WhatsApp → Templates → New Template yoluna gidin ve bir şablon gönderin:
- Kategori seçin — authentication, utility, marketing veya service.
- Dil seçin (her yerel ayar ayrı bir gönderimdir).
- Gövdeyi numaralı değişkenlerle yazın, örn.
Hi {{1}}, your order {{2}} shipped. - Gönderin. Çoğu şablon dakikalar içinde onaylanır; en fazla 24 saat tanıyın.
utility olarak gönderilmesi en sık ret sebebidir. Meta’nın neleri reddettiğini content policy sayfasında görün. Şablon incelemesi bir Meta kararıdır; Orbit onay sonucunu veya zamanlamasını garanti edemez.3
Send your first template message
Şablon onaylandığında tek bir POST ile gönderin. Şablonu Yanıt, delivery webhooks (
name ve language ile referanslayın, değişkenleri components ile doldurun:message.sent, message.delivered, message.read) üzerinden izleyebileceğiniz bir mesaj kimliği döndürür.4
Reply inside the 24-hour window
Bir müşteri yanıtladığında 24 saatlik hizmet penceresi açılır ve serbest biçimli mesaj gönderebilirsiniz — şablon gerekmez:
5
Check the window before you send
Bir kişi hâlâ pencere içinde mi, emin değil misiniz? Serbest biçimli bir mesaj yazmadan önce kontrol edin. Pencere kapandıysa şablona geri dönün.Gönderim hattı aynı kuralı zorunlu kılar; pencere dışındaki serbest biçimli gönderim sessizce atılmak yerine reddedilir — ama ön kontrol, arayüzünüzü şablon zorunlu moda almanızı ve boşa harcanan bir denemeden kaçınmanızı sağlar.
6
Scale beyond the starter limit
Yeni WABA’lar 24 saatte 250 benzersiz alıcıyla başlar. Kalite puanınızı Medium veya Green tutarak daha fazla alıcıya düzenli gönderim yaptıkça Meta kademenizi otomatik olarak yükseltir — 1.000, sonra 10.000, sonra 100.000, sonra sınırsız. Low kalite puanı kademe artışlarını dondurur; bu yüzden şablonlarınızı ilgili tutun ve vazgeçme (opt-out) taleplerine uyun. Kalite puanı bir Meta değerlendirmesidir; Orbit puanı veya kademe hareketlerini garanti edemez. WABA setup guide kademe tablosunu tamamıyla kapsar.
Sık sorulan sorular
WhatsApp Business Platform için kendi Meta Cloud API erişimime ihtiyacım var mı?
Hayır. Orbit, Meta Cloud API’sine sizin adınıza bağlanır. WhatsApp Business Account’unuzu panel üzerinden bir kez bağlarsınız, ardından Orbit’in REST API’sine tek birX-API-Key başlığıyla gönderirsiniz — Meta erişim token’larını veya webhook tesisatını asla kendiniz yönetmezsiniz.
Bir müşteriye ilk mesajı neden şablonla göndermek zorundayım?
WhatsApp Business Platform, bir işletmenin görüşmeyi yalnızca Meta’nın önceden onayladığı bir mesajla başlatmasına izin verir. Bu, istenmeyen mesajlaşmayı kontrol altında tutar. Müşteri yanıtladığında, şablonsuz serbest biçimli mesaj gönderebileceğiniz 24 saatlik bir pencere açılır.Şablon onayı ne kadar sürer?
Çoğu şablon dakikalar içinde onaylanır; Meta en fazla 24 saate kadar süre tanır. En sık ret sebebi kategori uyuşmazlığıdır — örneğin promosyon metnininutility şablonu olarak gönderilmesi. Bkz. WhatsApp content policy.
24 saatlik pencere nedir?
Bir müşteri size mesaj gönderdiğinde 24 saatlik bir hizmet penceresi açılır. Pencere içinde serbest biçimli metin, medya ve etkileşimli mesajlarla yanıtlayabilirsiniz. Pencere kapanınca yeniden yalnızca onaylı bir şablonla iletişime geçebilirsiniz. Göndermeden önce bir kişinin hâlâ pencere içinde olup olmadığınıwindow-status uç noktasıyla kontrol edebilirsiniz. Bkz. The 24-hour window.
Bir WhatsApp mesajının maliyeti nedir?
Fiyatlandırma şablon kategorisine (authentication, utility, marketing veya service) ve hedef ülkeye bağlıdır. Model ve tarifeler için WhatsApp pricing guide sayfasına bakın.WhatsApp üzerinden sesli veya görüntülü arama yapabilir miyim?
Evet — WhatsApp Business Platform işletme aramalarını destekler. Bkz. WhatsApp Business Calling.Sonraki adımlar
- WABA setup guide — hesabın, numaranın ve doğrulamanın tamamı.
- The 24-hour window — hizmet pencereleri ve yeniden etkileşimin işleyişi.
- WhatsApp channel reference — medya ve etkileşimli mesajlar dahil tüm WhatsApp API alanları.
- WhatsApp pricing — görüşmelerin fiyatlandırılması.
- Content policy — Meta’nın onayladıkları ve reddettikleri.