> ## Documentation Index > Fetch the complete documentation index at: https://docs.orbit.devotel.io/llms.txt > Use this file to discover all available pages before exploring further. # WhatsApp Business Platform ile başlayın > İlk WhatsApp Business Platform mesajınızı Orbit üzerinden gönderin: WABA bağlayın, şablon onaylatın, gönderin ve 24 saatlik pencere içinde yanıtlayın. # 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](#step-3-send-your-first-template-message) 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](https://docs.orbit.devotel.io/guides/whatsapp/pricing.md) 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](https://docs.orbit.devotel.io/guides/whatsapp/24h-window.md) sayfasına bakın. Medya, butonlar ve teslimat makbuzları gibi diğer her şey bu iki kuralın üzerine eklenir. ## 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](#step-1-connect-a-whatsapp-business-account) bölümünü izleyin — hesabın, numaranın ve doğrulamanın tamamı [WABA setup guide](https://docs.orbit.devotel.io/guides/whatsapp/waba-setup.md) 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](https://docs.orbit.devotel.io/guides/whatsapp/waba-setup.md) 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: 1. **Kategori** seçin — authentication, utility, marketing veya service. 2. **Dil** seçin (her yerel ayar ayrı bir gönderimdir). 3. Gövdeyi numaralı değişkenlerle yazın, örn. `Hi {{1}}, your order {{2}} shipped.` 4. Gönderin. Çoğu şablon dakikalar içinde onaylanır; en fazla 24 saat tanıyın. Kategoride dürüst olun — promosyon mesajının `utility` olarak gönderilmesi en sık ret sebebidir. Meta'nın neleri reddettiğini [content policy](https://docs.orbit.devotel.io/compliance/whatsapp-content-policy.md) 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 `name` ve `language` ile referanslayın, değişkenleri `components` ile doldurun: ```bash theme={null} curl -X POST https://api.orbit.devotel.io/api/v1/messages/whatsapp \ -H "X-API-Key: dv_live_sk_..." \ -H "Content-Type: application/json" \ -d '{ "to": "+14155552671", "type": "template", "template": { "name": "order_confirmation", "language": { "code": "en" }, "components": [ { "type": "body", "parameters": [ { "type": "text", "text": "Ada" }, { "type": "text", "text": "ORD-12345" } ] } ] } }' ``` Yanıt, [delivery webhooks](https://docs.orbit.devotel.io/webhooks/events.md) (`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: ```bash theme={null} curl -X POST https://api.orbit.devotel.io/api/v1/messages/whatsapp \ -H "X-API-Key: dv_live_sk_..." \ -H "Content-Type: application/json" \ -d '{ "to": "+14155552671", "type": "text", "text": { "body": "Thanks for reaching out! How can we help?" } }' ``` **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. ```bash theme={null} curl "https://api.orbit.devotel.io/api/v1/messages/whatsapp/window-status?to=+14155552671&from=+18005551234" \ -H "X-API-Key: dv_live_sk_..." ``` 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](https://docs.orbit.devotel.io/guides/whatsapp/waba-setup.md#messaging-limits) 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 bir `X-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 metninin `utility` şablonu olarak gönderilmesi. Bkz. [WhatsApp content policy](https://docs.orbit.devotel.io/compliance/whatsapp-content-policy.md). ### 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](https://docs.orbit.devotel.io/guides/whatsapp/24h-window.md). ### 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](https://docs.orbit.devotel.io/guides/whatsapp/pricing.md) 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](https://docs.orbit.devotel.io/guides/whatsapp/business-calling.md). ## Sonraki adımlar * [WABA setup guide](https://docs.orbit.devotel.io/guides/whatsapp/waba-setup.md) — hesabın, numaranın ve doğrulamanın tamamı. * [The 24-hour window](https://docs.orbit.devotel.io/guides/whatsapp/24h-window.md) — hizmet pencereleri ve yeniden etkileşimin işleyişi. * [WhatsApp channel reference](https://docs.orbit.devotel.io/channels/whatsapp.md) — medya ve etkileşimli mesajlar dahil tüm WhatsApp API alanları. * [WhatsApp pricing](https://docs.orbit.devotel.io/guides/whatsapp/pricing.md) — görüşmelerin fiyatlandırılması. * [Content policy](https://docs.orbit.devotel.io/compliance/whatsapp-content-policy.md) — Meta'nın onayladıkları ve reddettikleri. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.