# WhatsApp kullanıcı adları ve BSUID'ler: OTP, CRM ve webhook'lar için neler değişiyor? > WhatsApp kullanıcı adları, bir işletmenin artık bir müşterinin telefon numarasını göremeyebileceği anlamına gelir. Meta'nın sunduğu çözüm, işletme kapsamlı kullanıcı kimliğidir (BSUID). İşte bu kimliğin ne olduğu, hangi işlemlerin hâlâ telefon numarasına ihtiyaç duyduğu ve webhook, CRM ile OTP akışlarının nasıl taşınacağı. - Kanonik URL: https://www.broadnet.me/tr/blog/whatsapp-usernames-bsuid-developer-guide - Dil: tr - Son güncelleme: 2026-09-26 - Yayıncı: BroadNet (https://www.broadnet.me) - Yayın tarihi: 2026-09-26 - Yazar: BroadNet Engineering İşletme kapsamlı kullanıcı kimliği (BSUID), Meta'nın artık her WhatsApp webhook'una eklediği ve bir işletmenin kullanıcının telefon numarasını bilmeden ona mesaj göndermesini sağlayan tanımlayıcıdır. Bu kimliğin varlık sebebi WhatsApp'in kullanıcı adlarını kullanıma sunmasıdır: Bir kullanıcı kullanıcı adını etkinleştirdiğinde, yakın zamanda iletişim kurmamış bir işletme artık numarayı alamayabilir. BroadNet mühendislik ekibi tarafından hazırlanan bu kılavuz; formatı, zaman çizelgesini, hâlâ telefon numarası gerektiren durumları ve webhook, CRM kayıtları ile OTP akışlarının nasıl taşınacağını açıklamaktadır. ## Önemli çıkarımlar - Kullanıcı adı kullansalar da kullanmasalar da, tüm kullanıcılar için Nisan 2026 başından itibaren WhatsApp webhook'larında BSUID'ler görülmeye başlanmıştır. - Bir BSUID şu şekildedir: US.13491208655302741918; yani bir ISO 3166 alfa-2 ülke kodu, bir nokta ve ardından en fazla 128 alfanümerik karakter. - Bu kimlik, her bir işletme portföyü ve kullanıcı çifti için benzersizdir; kullanıcı telefon numarasını değiştirirse yeniden oluşturulur. - Tek dokunuşlu (one-tap), sıfır dokunuşlu (zero-tap) ve kod kopyalamalı doğrulama şablonları hariç olmak üzere, Temmuz 2026'dan itibaren bir BSUID'ye mesaj gönderebilirsiniz. - Meta, iş ortaklarının ve doğrudan entegre edilmiş işletmelerin, kullanıcı adıyla mesaj gönderen kullanıcılardan gelen mesajları işleme yeteneğini kaybetmemek için BSUID'leri desteklemesi gerektiğini belirtmektedir. - Doğrulanmış E.164 telefon numarasını OTP, SMS yedeklemesi ve dolandırıcılık kontrolleri için kimlik çapası olarak tutun. BSUID'yi bir WhatsApp kanalı anahtarı olarak değerlendirin. ## İşletme kapsamlı kullanıcı kimliği (BSUID) nedir? Meta, BSUID'yi "telefon numaralarını bilmediğinizde bir WhatsApp kullanıcısına mesaj göndermek için kullanılabilecek benzersiz bir kullanıcı tanımlayıcısı" ([Meta, işletme kapsamlı kullanıcı kimlikleri](https://developers.facebook.com/documentation/business-messaging/whatsapp/business-scoped-user-ids/)) olarak tanımlar. Format; kullanıcının ülkesinin ISO 3166 alpha-2 kodu, bir nokta ve en fazla 128 alfanümerik karakterden oluşur; örneğin US.13491208655302741918. Sistem tasarımı için üç özellik önem taşır: - Kapsam. Bir BSUID, tek bir işletme portföyüne ve tek bir kullanıcıya özeldir. Aynı kişi, iletişim kurduğu her işletme portföyü için farklı bir BSUID'ye sahiptir, bu nedenle alakasız portföyler arasında müşterileri eşleştirmek için kullanılamaz. - Kararlılık. Kullanıcı telefon numarasını değiştirdiğinde yeniden oluşturulur. Bu durum gerçekleştiğinde Meta, user_changed_user_id tipinde bir sistem mesajı webhook'u ve ayrı bir user_id_update webhook'u gönderir. - Üst BSUID'ler. Birkaç portföye sahip yönetilen işletmeler, Meta irtibat kişilerinden, ENT (örneğin US.ENT.11815799212886844830) içeren ve kayıtlı tüm portföylerde çalışan üst BSUID'lere kaydolmalarını isteyebilirler. ## WhatsApp neden kullanıcı adlarını getiriyor? Gizlilik için. Meta, 29 Haziran 2026 tarihinde kullanıcıların "bu yılın ilerleyen dönemlerinde" kullanmak üzere bir kullanıcı adı rezerve edebileceklerini ve bir kullanıcı bir kullanıcı adını etkinleştirdiğinde, ilk kez mesajlaştıkları kişinin veya işletmenin artık telefon numaralarını görmeyeceğini duyurdu ([Meta Hakkında](https://about.fb.com/news/2026/06/its-time-to-reserve-your-whatsapp-username/)). Meta'nın geliştirici dokümantasyonu, kullanıcı adlarının 2026 yılında kademeli olarak kullanıma sunulacağını belirtiyor. İşletmeler de kullanıcı adlarına sahip olabilir. 29 Haziran 2026'dan itibaren bir işletme, WhatsApp Manager, Meta Business Suite veya Kullanıcı Adı API aracılığıyla WhatsApp tarafından kendisi için ayrılmış bir kullanıcı adını talep edebilir ve onaylanan kullanıcı adları özellik kullanıma sunulduğunda aktif hale gelir. İşletme kullanıcı adı, işletmenin telefon numarasını gizlemez. ## Zaman çizelgesi nedir? | Tarih | Ne oldu veya ne oluyor | Geliştiriciler ne yapmalı | |---|---|---| | 2026 Nisan başı | BSUID'ler mesaj webhook'larında (user_id) görünmeye başlıyor | Her gelen olayda BSUID değerini telefon numarasıyla birlikte saklayın | | 29 Haziran 2026 | Kullanıcılar ve işletmeler için kullanıcı adı rezervasyonu başlıyor | İşletme kullanıcı adınızı rezerve edin; numarasız kullanıcılar için plan yapın | | Temmuz 2026 | API içerisinde bir BSUID adresine mesaj gönderme desteği mevcuttur | Gönderim yolunuza alıcı parametresini ekleyin | | 2026 yılı boyunca (kademeli olarak) | Kullanıcı adları kullanıcılara sunuluyor | BSUID içeren ve telefon numarası bulunmayan gelen webhook'lar beklenmelidir | ## Müşterinin telefon numarasını kaybedecek misiniz? Bazen. BSUID tüm mesaj webhook'larında görünür. Telefon numarası (wa_id ve gelen mesajlardaki numara), Meta uyarınca aşağıdaki durumlardan en az biri gerçekleştiğinde dahil edilir: - webhook tetiklenmeden önceki 30 gün içinde kullanıcının telefon numarasına mesaj gönderdiyseniz veya arama yaptıysanız; - bu 30 gün içinde kullanıcının telefon numarasından bir mesaj veya arama aldıysanız; veya - kullanıcı sizin rehberinizde kayıtlıysa. 30 günlük geriye dönük inceleme her bir işletme telefon numarası için ayrı ayrı değerlendirilir; bu nedenle satış hattınızda tanınan bir müşteri, destek hattınız için tanınmıyor olabilir. Kişi defteri, ilk etkileşimden sonra telefon numaralarını ve BSUID'leri saklayan Meta tarafından barındırılan bir özelliktir; böylece daha sonraki webhook'lar, kullanıcı bir kullanıcı adı seçse bile numarayı taşımaya devam edebilir. Bu özellik varsayılan olarak açıktır ve Meta Business Suite içerisinde İşletme ayarları > İşletme bilgisi kısmından kapatılabilir. Bir nedeniniz yoksa açık bırakın. ## Hangi işlemler hâlâ telefon numarasına ihtiyaç duyuyor? Meta konusunda açıkça belirtilmiştir: BSUID'ler "kullanıcı telefon numarası gerektiren tek dokunuşlu, sıfır dokunuşlu ve kodu kopyala doğrulama şablonları hariç her türlü mesajı göndermek için kullanılabilir". WhatsApp dışında, mobil ağ üzerinde çalışan her şeyin de numaraya ihtiyacı vardır. | Görev | Sadece BSUID ile mi çalışır? | İhtiyacınız olanlar | |---|---|---| | Serbest biçimli yanıtlar, medya, etkileşimli mesajlar | Evet | Alıcı parametresinde BSUID | | Pazarlama ve utility şablonları | Evet | Alıcı parametresinde BSUID | | Tek dokunuşlu, dokunmasız ve kod kopyalamalı kimlik doğrulama şablonları (OTP) | Hayır | Kullanıcının telefon numarası | | WhatsApp başarısız olduğunda SMS veya RCS yedekleme yöntemi | Hayır | E.164 telefon numarası | | HLR sorgulama, SIM değişim kontrolü, numara doğrulama | Hayır | E.164 telefon numarası | | Müşterinin başka bir iş portföyündeki aynı kişiyle eşleştirilmesi | Hayır | Kendi müşteri kimliğiniz veya telefon numaranız | ## Webhook öncesi ve sonrası nasıl görünür? BSUID'lerden önce, mesaj webhook'undaki kişiler bloğu telefon numarasını wa_id içinde taşıyordu ve çoğu entegrasyon bunu müşteri anahtarı olarak kullanıyordu. Meta'nın yeni kişiler nesnesi örneği kullanıcı adını, BSUID'yi ve etkinleştirilmişse üst BSUID'yi ekler; wa_id yalnızca numara paylaşılabildiğinde mevcuttur: ``` "contacts": [ { "profile": { "name": "", "username": "" }, "wa_id": "", "user_id": "", "parent_user_id": "" } ] ``` Gelen mesajlar ayrıca from_user_id (ve etkinleştirilmişse from_parent_user_id) taşır; durum webhook'ları ise Meta'nın kullanıcının BSUID'sine her zaman atandığını belirttiği recipient_user_id'yi taşır. Göndermek için yeni alıcı parametresine BSUID'yi yerleştirin. 'to' parametresini (telefon numarası), alıcı parametresini (BSUID) veya her ikisini birden ayarlayabilirsiniz; her ikisi de mevcut olduğunda telefon numarası önceliklidir: ``` { "messaging_product": "whatsapp", "recipient_type": "individual", "recipient": "", "type": "text", "text": { "body": "" } } ``` Gönderim yanıtı daha sonra kişiler dizisinde user_id içerir ve wa_id isteğe bağlı hale gelir. Eğer ayrıştırıcınız (parser) wa_id'nin her zaman mevcut olduğunu varsayıyorsa, ilk kullanıcı adlı kullanıcıda hata verecektir. Entegrasyonunuzun gerçekte hangi alanları aldığını kontrol etmek için gerçek veri yüklerini (payload) [webhook veri yükü denetleyicimize](https://www.broadnet.me/tools/webhook-payload-inspector) yapıştırabilirsiniz. ## OTP süreçlerinde neler aksar? Tek dokunuşlu, sıfır dokunuşlu veya kod kopyalama butonlu kimlik doğrulama şablonları bir BSUID'ye gönderilemez. Eğer bir kullanıcı adıyla size WhatsApp üzerinden ulaşırsanız ve onlara ait bir telefon numaranız yoksa, bu türde bir WhatsApp OTP gönderemezsiniz. Bu durum doğrulama akışları için iki sonuç doğurur: - Kayıt sırasında telefon numarasını E.164 formatında toplayın ve doğrulama adresi olarak kaydedin. Numarayı daha sonra size iletmesi için WhatsApp webhook'una güvenmeyin. [E.164'ün ne olduğuna](https://www.broadnet.me/answers/what-is-e164) bakın. - Doğrudan numaranın üzerinde çalışan bir kanal bulundurun. SMS OTP, sesli OTP ve sessiz ağ kontrollerinin tamamı telefon numarası üzerinden çalışır; bu nedenle otomatik geri dönüşlü (fallback) çok kanallı bir tasarım bu değişiklikten etkilenmeden aynı kalır. [Çok kanallı OTP kılavuzumuz](https://www.broadnet.me/blog/multichannel-otp-verification-api-2026) ve [BroadNet OTP ürünü](https://www.broadnet.me/products/otp) bu yöntemi kapsamaktadır. ## CRM ve müşteri tekilleştirme süreçlerinde ne aksar? Çoğu CRM, WhatsApp kontağını telefon numarası üzerinden anahtarlar; çünkü eskiden SMS, ses ve WhatsApp'ın tamamı bu numarayı paylaşırdı. Kullanıcı adlarından sonra, yeni bir gelen kontak sadece bir BSUID ile ulaşabilir. Eğer bunun için yeni bir CRM kaydı oluşturursanız, zamanla müşterileri mükerrer hale getirirsiniz. Verileri temiz tutmak için dört kural şunlardır: 1. BSUID'yi müşteri kimliği olarak değil, bir kanal kimliği olarak modelleyin. Bir müşteri birden fazla BSUID'ye (her bir iş portföyü için bir tane) ve numara değişikliğinden sonra yeni bir tanesine sahip olabilir. 2. BSUID, portföy, biliniyorsa telefon numarası, ilk görülme ve son görülme bilgilerini içeren bir eşleştirme tablosu tutun ve bunu user_id_update dahil her webhook olayında güncelleyin. 3. Tahminlerle değil, kanıtlara dayanarak birleştirme yapın: doğrulanmış bir telefon numarası, bir oturum açma veya müşterinin sohbette verdiği bir sipariş referansı. 4. wa_id'nin eksikliğini asla yeni bir müşteri olarak değerlendirmeyin. Bu, sadece o olayda numaranın paylaşılamayacağı anlamına gelir. ## Nasıl geçiş yaparsınız? Adım adım kontrol listesi 1. Webhook ayrıştırıcılarını user_id, from_user_id, recipient_user_id ve username alanlarını okuyacak; wa_id ve from alanlarını ise isteğe bağlı (optional) olarak değerlendirecek şekilde güncelleyin. 2. WhatsApp kişilerini sakladığınız her yere bir BSUID sütunu (ve yönetilen bir işletmeyseniz üst BSUID) ekleyin. 3. Geriye dönük veri doldurma: Nisan 2026 başından itibaren gelen her olay için BSUID'yi halihazırda sahip olduğunuz telefon numarasıyla ilişkilendirin. 4. Yeni BSUID'yi müşteriyle yeniden ilişkilendirerek user_changed_user_id sistem mesajını ve user_id_update webhook'unu işleyin. 5. Gönderim yolunuza alıcı parametresini ekleyin ve telefon numarası bulunmadığında bu parametreyi yedek olarak kullanın. 6. OTP'yi telefon numarasına yönlendirin, asla bir BSUID'ye yönlendirmeyin ve yedek kanal olarak SMS veya sesi kullanın. 7. İşletme kullanıcı adınızı WhatsApp Manager, Meta Business Suite veya Kullanıcı Adı API üzerinden rezerve edin. 8. Kullanıcı adları müşterilerinize ulaşmadan önce kullanıcı adı etkinleştirilmiş bir hesapla test edin. Eğer BroadNet sizin WhatsApp sağlayıcınız ise, üretim kodunu değiştirmeden önce test erişimi talep edin ve BSUID alanlarının hesabınız için webhook'larda nasıl göründüğünü onaylayın. [Geliştirici merkezimiz](https://www.broadnet.me/developers) ve [WhatsApp Business API sayfası](https://www.broadnet.me/products/whatsapp-business-api) ayrıntıları içermektedir; ayrıca [omnichannel yönlendirme](https://www.broadnet.me/products/omnichannel), kimlik doğrulama akışlarının artık bağımlı olduğu SMS yedekleme işlemini yönetir. ## Sıkça sorulan sorular ### WhatsApp BSUID nedir? İşletme kapsamlı bir kullanıcı kimliği: Meta'nın her bir işletme portföyü için her bir WhatsApp kullanıcısına atadığı bir tanımlayıcıdır; böylece işletme, kullanıcının telefon numarasını bilmesine gerek kalmadan kullanıcıya mesaj gönderebilir. Webhook'larda user_id olarak görünür. ### BSUID nasıl görünür? Bir ISO 3166 alpha-2 ülke kodu, bir nokta ve ardından en fazla 128 alfanümerik karakterden oluşur; örneğin US.13491208655302741918. Yönetilen işletmeler için üst BSUID'ler ENT içerir, örneğin US.ENT.11815799212886844830. ### Kullanıcı bir kullanıcı adı seçtiğinde müşterinin telefon numarasını kaybeder miyim? Sadece bazı webhook'larda. Eğer son 30 gün içinde o numara ile bir mesaj veya arama gerçekleştirdiyseniz ya da kullanıcı rehberinizde kayıtlıysa numara hâlâ dahil edilir. Aksi takdirde wa_id çıkarılır ve yalnızca BSUID'yi alırsınız. ### Bir BSUID'ye mesaj gönderebilir miyim? Evet, Temmuz 2026'dan itibaren send API'sinin alıcı parametresi kullanılarak bu mümkündür. Kullanıcının telefon numarasını gerektiren tek tıkla (one-tap), sıfır tıkla (zero-tap) ve kodu kopyala (copy-code) doğrulama şablonları hariç tüm mesaj türleri çalışmaktadır. ### Bir BSUID'ye doğrulama (OTP) şablonları gönderebilir miyim? Hayır. Tek tıkla, sıfır tıkla ve kodu kopyala doğrulama şablonları telefon numarası gerektirir. Her hesap için doğrulanmış bir telefon numarası bulundurun ve yedek yöntem olarak SMS veya sesli OTP kullanın. ### BSUID'ler işletme portföyleri arasında çalışır mı? Hayır. Bir BSUID, tek bir işletme portföyü ve kullanıcı çiftine özeldir. Yönetilen işletmeler, birlikte kayıtlı olan portföyler genelinde çalışan üst BSUID'ler hakkında Meta'ya danışabilir. ### Bir BSUID hiç değişir mi? Evet. Kullanıcı telefon numarasını değiştirdiğinde yeniden oluşturulur ve Meta bunu bir user_changed_user_id sistem mesajı ve bir user_id_update webhook'u ile bildirir. ### İşletme kullanıcı adımı nasıl rezerve edebilirim? 29 Haziran 2026 tarihinden itibaren; WhatsApp Manager, Meta Business Suite veya Username API aracılığıyla. Onaylanmış bir kullanıcı adı, kullanıcı adı özelliği kullanıma sunulduğunda aktif hale gelir ve işletme telefon numaranızı gizlemez. ## Kaynaklar - Geliştiriciler için Meta, [İşletme kapsamlı kullanıcı kimlikleri](https://developers.facebook.com/documentation/business-messaging/whatsapp/business-scoped-user-ids/) (format, zaman çizelgesi, webhook alanları, rehber, gönderim parametresi, kimlik doğrulama şablonu istisnası), 26 Eylül 2026 tarihinde erişildi. - Meta hakkında, [WhatsApp kullanıcı adınızı rezerve etme zamanı geldi](https://about.fb.com/news/2026/06/its-time-to-reserve-your-whatsapp-username/), 29 Haziran 2026, 26 Eylül 2026 tarihinde erişildi.