--- title: "WhatsApp Business API Nasıl Kurulur: Adım Adım Rehber" description: "WhatsApp Business API adım adım kurulum: işletme portföyü, doğrulama, telefon numarası, görünen ad, Embedded Signup, şablonlar ve yayına alma kontrol listesi." canonical: "https://omnichannels.ai/tr/blog/how-to-set-up-whatsapp-business-api/" language: "tr" updated: "2026-10-09" publisher: "BroadNet Technologies" brand: "OmniChannels.ai" category: "whatsapp" primaryQuery: "how to set up whatsapp business api" keywords: ["whatsapp business api kurulumu", "whatsapp embedded signup", "meta işletme doğrulaması whatsapp", "whatsapp görünen ad onayı", "whatsapp api telefon numarası gereksinimleri", "whatsapp cloud api başvurusu"] published: "2026-10-09" author: "OmniChannels.ai Editorial Team" reviewer: "BroadNet Messaging Solutions Team" readingMinutes: 9 answer: "WhatsApp Business API'yi kurmak için bir Meta işletme portföyü oluşturun veya mevcut olanı kullanın, işletme doğrulamasını tamamlayın, SMS veya sesli arama alabilen ve WhatsApp'ta etkin olmayan bir telefon numarası seçin, markanızla eşleşen bir görünen ad belirleyin, sağlayıcınızın Embedded Signup akışıyla bağlanın, bir ödeme yöntemi ekleyin, numarayı iki adımlı doğrulama PIN'iyle kaydedin ve yayına almadan önce ilk mesaj şablonlarınızı onaya gönderin." takeaways: ["Meta'ya göre API için bir işletme telefon numarası size ait olmalı, ülke ve alan kodu içermeli ve SMS veya sesli arama alabilmelidir; kısa kodlar desteklenmez.", "WhatsApp'ta zaten kullanılan numaralar, uygun Business App numaraları için Meta'nın birlikte çalışma (coexistence) seçeneği kullanılmadıkça, kayıttan önce uygulamadan silinmelidir.", "Embedded Signup, bir sağlayıcının platformu içinde bir işletme portföyü, WhatsApp Business Hesabı ve telefon numarası oluşturmanıza veya seçmenize olanak tanır.", "İşletme doğrulaması kaydedebileceğiniz telefon numarası sayısını artırır ve daha yüksek mesajlaşma limitlerine giden yollardan biridir.", "Şablon onayı, geçerli bir ödeme yöntemi ve iki adımlı doğrulama PIN'i, yayına almadan önceki olağan engellerdir."] faq: - q: "Mevcut WhatsApp numaramı API için kullanabilir miyim?" a: "Evet, koşullarla. Meta, WhatsApp'ta zaten kullanılan numaraların API'ye kaydedilmeden önce uygulamadan silinmesi gerektiğini belirtir. Uygun WhatsApp Business App numaraları için Meta ayrıca Embedded Signup sırasında, uygulamanın aynı numarada çalışmaya devam etmesini sağlayan bir birlikte çalışma (coexistence) seçeneği sunar. Karar vermeden önce pazarınız için uygunluğu kontrol edin." - q: "Meta işletme doğrulaması zorunlu mu?" a: "Doğrulamadan önce göndermeye başlayabilirsiniz ancak daha düşük limitlerle. Meta'ya göre yeni portföyler iki kayıtlı numara ve hizmet penceresi dışında 250 benzersiz kullanıcı mesajlaşma limitiyle başlar; işletmeyi doğrulamak numara sınırını yükseltmenin ve daha yüksek bir mesajlaşma limitine hak kazanmanın bir yoludur. Büyüyen işletmelerin çoğu erken doğrulama yapmalıdır." - q: "İşletme doğrulaması için hangi belgelere ihtiyacım var?" a: "Meta genellikle yasal işletme adını, adresi ve telefon numarasını gösteren belgeleri, örneğin ticaret sicil belgesi, ticari kayıt veya fatura ile birlikte kontrol ettiğiniz bir alan adındaki web sitesini ister. Gereksinimler ülkeye göre değişir ve zamanla farklılaşır; bu nedenle portföyünüz için Meta Business Suite'in Güvenlik Merkezi'ndeki yönlendirmeleri izleyin." - q: "Görünen adım neden reddedildi?" a: "Görünen adlar genellikle işletmeyle açıkça ilişkili olmadığında, yalnızca genel terimler kullandığında, büyük harf veya noktalama işaretlerini yanlış kullandığında veya web sitenize ya da doğrulanmış işletmeye bağlanamadığında reddedilir. Müşterilerin bildiği marka adını kullanın, web sitenizin bunu gösterdiğinden emin olun ve tutarlı markalamayla yeniden gönderin." - q: "WhatsApp Business API'yi kurmak için bir geliştiriciye ihtiyacım var mı?" a: "Bir sağlayıcı Embedded Signup ve gelen kutusu, şablonlar ve kampanyalarla hazır bir platform sunuyorsa gerekmez. API'yi doğrudan çağırmak, kendi sistemlerinizde webhook almak veya WhatsApp'ı CRM'inizle ya da sipariş platformunuzla entegre etmek istiyorsanız bir geliştirici gerekir." sources: - title: "Telefon numaraları — WhatsApp Cloud API, Meta for Developers" url: "https://developers.facebook.com/docs/whatsapp/cloud-api/phone-numbers" - title: "Embedded Signup — Meta for Developers" url: "https://developers.facebook.com/docs/whatsapp/embedded-signup" - title: "İşletme doğrulaması — Meta for Developers" url: "https://developers.facebook.com/docs/development/release/business-verification" - title: "Mesaj şablonları — Meta for Developers" url: "https://developers.facebook.com/docs/whatsapp/business-management-api/message-templates" - title: "Mesajlaşma limitleri — Meta for Developers" url: "https://developers.facebook.com/docs/whatsapp/messaging-limits" - title: "Hata kodları — WhatsApp Cloud API, Meta for Developers" url: "https://developers.facebook.com/docs/whatsapp/cloud-api/support/error-codes" --- # WhatsApp Business API Nasıl Kurulur: Adım Adım Rehber Canonical: https://omnichannels.ai/tr/blog/how-to-set-up-whatsapp-business-api/ Language: tr Publisher: OmniChannels.ai by BroadNet Technologies Bu rehber, bir işletmeyi WhatsApp Business API üzerinde yayına almakla görevli pazarlama, müşteri deneyimi veya BT sorumlusu içindir. Her kurulum adımını sırayla anlatır, Meta'nın her aşamada neyi kontrol ettiğini açıklar ve yayına alma kontrol listesi ile ekiplerin en sık karşılaştığı hatalarla sona erer. ## Başlamadan önce nelere ihtiyacınız var? Dört şeyi hazır bulundurun: şirketinizin Meta işletme portföyüne yönetici erişimi, işletme belgeleriniz, ayrılmış bir telefon numarası ve müşterilerin tanıdığı bir marka adı. Gecikmelerin çoğu bunlardan birinin eksikliğinden kaynaklanır. | Öğe | Gereksinim | Neden önemli | |---|---|---| | Meta işletme portföyü | Yönetici erişimi; yasal işletme adı ve adres doldurulmuş | WhatsApp Business Hesabı'nın (WABA) sahibidir | | İşletme belgeleri | Ticaret sicil belgesi veya ticari kayıt, adres kanıtı | İşletme doğrulaması için gerekli | | Web sitesi | Kontrol ettiğiniz bir alan adında, işletme adınızı gösteren | Doğrulamayı ve görünen ad incelemesini destekler | | Telefon numarası | Size ait, ülke ve alan kodlu, SMS veya sesli arama alabilen | Kayıt için gerekli; kısa kodlar desteklenmez | | Görünen ad | Markanız ve web sitenizle eşleşir | WhatsApp profilinizde gösterilir; Meta tarafından incelenir | | Ödeme yöntemi | Kart veya sağlayıcı kredi limiti | Ücretli şablonları göndermek için gerekli | | Opt-in süreci | Müşterilerin WhatsApp mesajı almak için net izni | WhatsApp politikası gereği zorunlu | ## WhatsApp Business API adım adım nasıl kurulur? Bu adımları sırayla izleyin. Bir sağlayıcı üzerinden devreye alıyorsanız 3. ile 6. adımlar genellikle onun Embedded Signup akışı içinde gerçekleşir. ### 1. Adım: Meta işletme portföyünüzü hazırlayın Şirketin işletme portföyünün yöneticisi olan kişisel bir Facebook hesabıyla Meta Business Suite'e giriş yapın veya bir portföy oluşturun. Belgelerinizde görünen yasal işletme adını ve adresi birebir kullanın. Biri ayrıldığında erişim kaybedilmesin diye en az iki yönetici ekleyin. ### 2. Adım: İşletme doğrulamasını başlatın İşletme portföyünüzün Güvenlik Merkezi'nde işletme doğrulamasını başlatın. Meta, yasal adı, adresi ve telefonu veya e-postayı doğrulayan belgeler ister ve bir kod ya da alan adı kontrolüyle doğrulama yapabilir. Gereksinimler ülkeye göre değişir ve zamanla farklılaşır; bu yüzden ekrandaki yönlendirmeleri izleyin. Doğrulama tamamlanmadan da devreye almaya başlayabilirsiniz; ancak Meta'nın dokümantasyonuna göre o zamana kadar daha düşük limitler uygular: yeni portföyler iki kayıtlı telefon numarası ve müşteri hizmetleri penceresi dışında 250 benzersiz kullanıcı mesajlaşma limitiyle başlar. ### 3. Adım: Telefon numarasını seçin İşletmeyle yıllarca kalacak bir numara seçin; örneğin sabit hat veya ayrılmış bir mobil hat. Meta, numaranın şunları sağlamasını şart koşar: - Size ait olması ve ülke ile alan kodu içermesi; - Doğrulama için SMS veya sesli arama alabilmesi; - Kısa kod olmaması; - Uygun bir WhatsApp Business App numarası için Meta'nın birlikte çalışma (coexistence) seçeneğini kullanmadığınız sürece, şu anda WhatsApp'ta kayıtlı olmaması. Numara WhatsApp veya WhatsApp Business App'te ise ve birlikte çalışma istemiyorsanız, ihtiyacınız olanı yedekleyin ve önce hesabı uygulamadan silin. ### 4. Adım: Görünen adınızı seçin Görünen ad WhatsApp profilinizde görünür. Müşterilerin bildiği marka adını, web sitenizle ve işletme belgelerinizle tutarlı biçimde kullanın. Genel adlardan ("En İyi Fırsatlar"), alışılmadık büyük-küçük harf kullanımından veya slogan eklemekten kaçının. Meta adı inceler; durum, WhatsApp Manager'da beklemede, onaylandı veya reddedildi olarak görünür. ### 5. Adım: Embedded Signup ile bağlanın Embedded Signup, sağlayıcıların kendi platformlarına yerleştirdiği Meta akışıdır. Facebook ile giriş yapar, işletme portföyünü seçer veya oluşturur, bir WhatsApp Business Hesabı oluşturur veya seçer, telefon numarasını ve görünen adı girer ve numarayı SMS ya da sesli arama ile gelen kodla doğrularsınız. Sonunda sağlayıcı, WABA'yı sizin adınıza yönetme izni alır; sahiplik ise portföyünüzde kalır. ### 6. Adım: Numarayı kaydedin ve iki adımlı PIN belirleyin Numaranın Cloud API için altı haneli iki adımlı doğrulama PIN'iyle kaydedilmesi gerekir. Sağlayıcınız bunu genellikle devreye alma sürecinin bir parçası olarak yapar. PIN'i güvenle saklayın: daha sonra PIN'i değiştirmek veya numarayı silmek için gereklidir. ### 7. Adım: Bir ödeme yöntemi ekleyin Meta, iletilen her şablon mesajı için kategori ve alıcı ülkesine göre ücret alır. WhatsApp Manager'da WABA'ya bir kart ekleyin veya sağlayıcınızın kredi limitinin hesabınızı kapsadığını teyit edin. Geçerli faturalandırma olmadan şablon gönderimleri başarısız olur. ### 8. Adım: İlk şablonlarınızı oluşturun 24 saatlik müşteri hizmetleri penceresinin dışında yalnızca onaylı şablonlar gönderebilirsiniz. İlk gün ihtiyaç duyacağınız üç ila beş şablonla başlayın: 1. Sipariş veya rezervasyon onayı için bir bilgilendirme (Utility) şablonu. 2. Teslimat veya hatırlatma gibi bir durum güncellemesi için bir bilgilendirme şablonu. 3. Tek kullanımlık şifre gönderiyorsanız bir authentication şablonu. 4. Opt-in vermiş kişilere yönelik ilk kampanyanız için bir pazarlama şablonu. İsimler ve sipariş numaraları için değişkenler kullanın, bilgilendirme şablonlardan promosyon dilini uzak tutun ve Körfez müşterilerine hizmet veriyorsanız Arapça ve İngilizce sürümleri aynı şablonun ayrı dilleri olarak oluşturun. ## Uygulamalı örnek: Doha'da bir eğitim enstitüsü yayına giriyor "Al Fanar Academy" (kurgusal bir örnek), kurs soruları ve ders hatırlatmaları için WhatsApp'ı istiyor. - **1. Hafta:** Operasyon müdürü işletme portföyüne yönetici erişimini teyit ediyor, ticari kaydı yüklüyor ve doğrulamayı başlatıyor. Akademi, sesli arama alabilen ana sabit hattını seçiyor. - **Devreye alma:** Sağlayıcının Embedded Signup akışıyla bir WABA oluşturuyor, görünen adı "Al Fanar Academy" olarak giriyor ve numarayı sesli arama ile doğruluyor. - **Şablonlar:** Arapça ve İngilizce olarak bir ders hatırlatması (bilgilendirme), bir kayıt onayı (bilgilendirme) ve bir yeni dönem duyurusu (pazarlama) gönderiyor. Pazarlama şablonu belirsiz bir harekete geçirici mesaj nedeniyle reddediliyor ve yeniden yazıldıktan sonra onaylanıyor. - **Yayına alma:** Kayıt formunda opt-in vermiş öğrencilere hatırlatma gönderiyor ve yanıtları kabul ekibinin gelen kutusuna yönlendiriyor. En uzun adım teknik kurulum değil, doğrulamaydı. ## Yayına alma kontrol listesi İlk kampanyanızdan önce her maddeyi işaretleyin. 1. İşletme doğrulaması gönderildi veya onaylandı. 2. Görünen ad onaylandı. 3. Telefon numarası kaydedildi ve iki adımlı PIN güvenle saklandı. 4. Ödeme yöntemi geçerli ve bakiyeli. 5. Gereken şablonlar ihtiyaç duyduğunuz her dilde onaylandı. 6. Mesaj göndereceğiniz her kişi için opt-in kaydedildi. 7. Gelen kutusu kuruldu; gelen mesajlara yanıt vermek üzere temsilciler atandı. 8. Dahili numaralara test mesajları gönderildi ve Android ile iOS'ta kontrol edildi. 9. Test gönderimleri için iletim raporlaması gözden geçirildi. 10. Gönderim hacmi mevcut mesajlaşma limitiniz dahilinde planlandı. ## En yaygın kurulum hataları nelerdir? Hataların çoğu birkaç kalıba girer. Meta'nın hata kodları dokümantasyonu bunları listeler; devreye alma ekiplerinin en sık gördükleri şunlardır. | Hata kodu | Anlamı (Meta'ya göre) | Tipik çözüm | |---|---|---| | 133010 | Telefon numarası kayıtlı değil | Kaydı iki adımlı PIN ile tamamlayın | | 131047 | Müşteri hizmetleri penceresi kapandı | Serbest biçimli metin yerine onaylı bir şablon gönderin | | 132001 | Şablon o dilde mevcut değil veya onaylanmamış | Şablon adını, dil kodunu ve onay durumunu kontrol edin | | 132012 | Değişken değerleri şablon biçimiyle uyuşmuyor | Değişkenlerin sayısını ve biçimini eşleştirin | | 131042 | Ödeme yöntemi sorunu | WABA'daki kartı veya kredi limitini düzeltin | | 131026 | Mesaj iletilemiyor | Alıcı WhatsApp kullanmıyor ya da uygulaması güncel değil olabilir; başka bir kanal kullanın | | 131049 | Mesaj ekosistem sağlığı için tutuldu | Çoğu zaman pazarlama sıklığı; yeniden göndermeden önce bekleyin ve hedeflemeyi gözden geçirin | | 368 | Hesap politika ihlali nedeniyle kısıtlandı | WhatsApp Manager'daki politika bildirimlerini inceleyin ve uygunsa itiraz edin | Diğer sık sorunlar hata kodu değildir: WhatsApp uygulamasında hâlâ etkin olan bir numara, web sitesiyle eşleşmeyen bir görünen ad ve portföy üzerinde tam kontrolü olmayan yöneticiler. ## OmniChannels.ai nasıl yardımcı olur? BroadNet Technologies tarafından desteklenen OmniChannels.ai, WhatsApp Business API numaralarını Meta Embedded Signup ile devreye alır; böylece işletme portföyünüz WABA'nın sahipliğini korur. Değişkenli, medyalı ve butonlu; tek dokunuş, sıfır dokunuş ve kodu kopyala OTP dahil pazarlama, bilgilendirme ve kimlik doğrulama şablonları oluşturabilir, bunları telefon önizlemesinde kontrol edebilir ve onayı takip edebilirsiniz. Yayına girdikten sonra kampanyalar Excel/CSV yükleme, önizleme, zamanlama ve mükerrer kayıt filtrelemesini, her gönderim için iletim raporlarıyla birlikte destekler. Arapça ve İngilizce desteklenir. [WhatsApp Business API](/channels/whatsapp-business-api/) sayfasına ve [kampanyalara](/platform/campaigns/) bakın veya demo talep edin.