TL;DR: 2026 yılının sonlarına doğru Meta, birincil WhatsApp sohbet tanımlayıcısı olarak doğrudan telefon numaralarını kullanmayı tamamen sonlandıracaktır. CRM veritabanı tekrarlarını ve hatalı reklam ilişkilendirmelerini önlemek için, anonimleştirilmiş Bağlı Cihaz Tanımlayıcılarını (@lid) E.164 telefon numaralarına çözümlemeniz gerekir. Bu kılavuz, LID'leri 200 milisaniyenin altında eşleştirmek için Whapi.Cloud'un tek bir GET uç noktasını nasıl kullanacağınızı göstermektedir. Üretim ortamına geçmeden önce bunu Whapi.Cloud Sandbox'ta güvenle test edebilirsiniz.
WhatsApp @lid Sorunu ve Meta'nın Telefon Numaralarını Maskeleme Nedeni
WhatsApp LID, çoklu cihaz oturumları sırasında istemci tarafı veritabanlarındaki gerçek telefon numaralarını maskelemek amacıyla Meta tarafından sunulan, gizliliği koruyan bir Bağlı Cihaz Tanımlayıcısıdır (Linked Device Identifier).
Deneyimlerimize göre, çoklu cihaz kurulumlarına geçen ekipler bu tanımlayıcıların aniden ortaya çıkmasıyla genellikle hazırlıksız yakalanmaktadır. Meta, bireysel fiziksel cihazları tek bir telefon numarasından ayırmak amacıyla WhatsApp Çoklu Cihaz Güncellemesi'nin bir parçası olarak bu mimari değişikliği tanıttı. Kullanıcılar WhatsApp Web veya bağlı yardımcı uygulamalar aracılığıyla işletmelerle etkileşime girdiğinde, Meta'nın istemci tarafındaki veritabanı, özellikle de tarayıcının IndexedDB katmanı, gönderenin E.164 telefon numarasını rastgele bir `@lid` dizesiyle değiştirir. Tarayıcı düzeyindeki bu depolama, yardımcı oturum belirteçlerini ve şifreleme eşleme anahtarlarını barındırarak, yerel istemcinin birincil telefon numarasını veri kazıma (scraping) betiklerine maruz bırakmadan mesajları doğru cihaza yönlendirebilmesini sağlar.
Pratikte, arka uç geliştiricileri LID'lerle ilk olarak web kancaları (webhooks) geleneksel telefon numaraları yerine aniden `1234567890@lid` gibi dizeler döndürmeye başladığında karşılaşırlar. Bu geçiş geçici bir durum değildir; kalıcı bir gizlilik standardıdır. Anonimleştirilmiş WhatsApp LID'lerini E.164 telefon numaralarına çözümlemezseniz, CRM veritabanınız veri tekrarlarıyla karşı karşıya kalacak ve Meta Dönüşümler API'si (Meta Conversions API) ilişkilendirmeniz sıfıra düşecektir -- soket düzeyinde arka plan çözümlemesi en kritik karardır, geri kalan her şey sadece teferruattır. Meta'nın 2026 Sonu Kullanımdan Kaldırma Zaman Çizelgesi'ne göre, doğrudan telefon tabanlı yönlendirme sistematik olarak aşamalı bir şekilde kaldırılmaktadır. Uygulamanız kullanıcı kimlik doğrulaması, mesaj yönlendirme veya veritabanı indeksleme için ham telefon numaralarına güveniyorsa, gelen `@lid` kişileri mükerrer CRM profillerine neden olacak ve mevcut iletişim akışlarınızı bozacaktır. Bu geçişi göz ardı etmek, telefon tabanlı JID'ler Meta'nın sinyal sunucuları tarafından tamamen kullanımdan kaldırıldığında, uzun vadede tam bir yönlendirme hatası riski taşır.
Yerel Ayrıştırma ve Düzenli İfadelerin (Regex) Telefon Numaralarını Çıkarmada Neden Başarısız Olduğu
Rakipler LID'den telefona dönüşümın imkansız olduğunu iddia ederken; Whapi.Cloud, yerel regex ayrıştırmasının rastgele dahili veritabanı anahtarlarını çözememesi nedeniyle doğrudan soket düzeyinde çözümleme sunar.
`1234567890@lid` gibi anonimleştirilmiş bir dizeyle karşılaşıldığında, birçok geliştiricinin ilk dürtüsü, `@` sembolünden önceki rakamları çıkarmak için bir düzenli ifade (regex) veya dize işleme yardımcısı yazmaktır. Bu yaklaşım, üretim ortamında anında çöken kritik bir entegrasyon hatasıdır. Bir WhatsApp LID'sinin içindeki sayılar, telefon numarasının statik bir karması (hash) veya kodlanmış bir versiyonu değil, yardımcı cihaz eşlemesi sırasında Meta'nın sinyal sunucuları tarafından oluşturulan tamamen rastgele, 64 bitlik dinamik kimliklerdir. Kendi sunucunuzda bir LID'yi çözebilecek hiçbir matematiksel formül, karma algoritması veya yerel şifre çözme yöntemi yoktur. LID'yi yerel olarak ayrıştırmaya çalışmak geçersiz veriler üreterek veritabanı bozulmasına ve mesaj teslimatlarının başarısız olmasına yol açar.
Whapi.Cloud, rakip API'lerin çözümlemenin imkansız olduğunu iddia ettiği durumlarda son derece kararlı bir alternatif sunarak, Meta sunucularını gerçek zamanlı olarak sorgulamak için soket düzeyinde arka plan çözümlemesi kullanır. Whapi.Cloud, resmi WhatsApp Web istemcisiyle aynı web oturumu soketlerini kullanarak, kişinin gerçek kimliğini almak için Meta sunucularını gerçek zamanlı olarak sorgular. Bu yetenek, temel iletişim protokolünü detaylandıran Whapi.Cloud API dokümantasyonu içinde tamamen belgelenmiştir. Bu soket düzeyindeki mimari, Whapi.Cloud'un diğer sağlayıcıları kısıtlayan tarayıcı kazıma (browser-scraping) sınırlamalarını aşmasını sağlayarak üretim ortamlarında son derece kararlı ve güvenilir bir çözümleme sunar.
LID'leri 200 Milisaniyenin Altında Programlı Olarak Çözümleme
GET /contacts/ids/{ContactLID} uç noktası, anonimleştirilmiş WhatsApp LID dizelerinden orijinal E.164 telefon numaralarını 200 milisaniyenin altında alır.
Bu uç noktayı çağırırken geliştiriciler sıklıkla kritik bir yönlendirme hatası yaparlar: ham `@lid` dizesini doğrudan URL yolunda iletirler. Kodlanmamış '@' sembolleri 404 hatalarını tetikler; `@` sembolünün `%40` olarak URL kodlaması (URL-encoding) yapılması başarılı API yönlendirmesini garanti eder. `@` sembolü HTTP URI sözdiziminde ayrılmış bir karakter olduğundan, kodlanmaması Whapi.Cloud'un yönlendirme katmanının istek yolunu yanlış yorumlamasına neden olarak anında bir HTTP 404 Yönlendirme Hatası ile sonuçlanır. İstekte bulunmadan önce arka ucunuzun parametreyi dinamik olarak kodladığından her zaman emin olun.
curl --request GET \
--url "https://gate.whapi.cloud/contacts/ids/1234567890%40lid" \
--header "Authorization: Bearer YOUR_API_TOKEN" \
--header "accept: application/json"Başarılı bir çözümleme, orijinal E.164 telefon numarasını içeren bir JSON yanıtı döndürür. Aşağıda, entegrasyon hattınızda ayrıştırmanız gereken standart yanıt yapısı yer almaktadır:
{
"id": "1234567890@lid",
"phone": "15550190010"
}Bunu bir üretim ortamında uygulamak için geliştiriciler **soket düzeyinde çözümleme geçidi (socket-level resolution gate)** modelini benimsemelidir. Bu sağlam arka uç entegrasyon iş akışı, maksimum performans sağlar ve harici API gecikmesini en aza indirir: Web kancası alındı -> Göndereni ayrıştır -> Yerel Redis önbelleğini kontrol et (TTL 7 gün) -> Whapi GET /contacts/ids/{ContactLID} çağır (önbellekte yoksa) -> Redis'i güncelle -> İş mantığını yürüt. Adım adım ayrıntılı bir API referansı için, WhatsApp LID'lerinden telefon numaralarını alma hakkındaki kılavuzumuzu okuyabilirsiniz. Veritabanı yazma işlemlerinizi bu yerel önbellekle sınırlandırarak, gelen mesajların %99'unun Whapi.Cloud sunucularına gereksiz HTTP istekleri yapmadan anında eşleşmesini sağlarsınız.
İşte bu modeli gösteren eksiksiz bir Node.js uygulaması. Kodun URL kodlamasını dinamik olarak nasıl yönettiğine ve sağlam hata işleme mantığı içerdiğine dikkat edin:
// Node.js fetch example for LID resolution
// CRITICAL: You must URL-encode the '@' symbol as '%40' in the URL path.
// If you pass the raw '@' symbol, the routing layer will fail to parse the path and throw a 404 error.
const contactLid = "1234567890@lid";
const encodedLid = encodeURIComponent(contactLid); // Produces "1234567890%40lid"
const response = await fetch(`https://gate.whapi.cloud/contacts/ids/${encodedLid}`, {
method: 'GET',
headers: {
'Authorization': `Bearer ${process.env.WHAPI_TOKEN}`,
'Accept': 'application/json'
}
});
if (response.status === 404) {
// This block is triggered if the routing fails or the endpoint is misconfigured
throw new Error("LID resolution failed with 404. Verify that the '@' symbol is fully URL-encoded.");
}
const data = await response.json();
console.log(`Resolved phone number: ${data.phone}`); // Returns E.164 phone number, e.g., "15550190010"Burada Express.js web kancası ara yazılımı (webhook middleware) kurulumunu veya Postgres veritabanı şema tasarımlarını ele almayacağız -- bu mimari modeller özel veritabanı senkronizasyon kılavuzumuzda ayrıntılı olarak açıklanmıştır. Bunun yerine, yalnızca tek bir GET API çözümlemesine ve bunun anında hata yönetimine odaklanıyoruz.
Teknik Sınırlamalar: Hata 463'ü ve Senkronizasyon Gecikmelerini Yönetme
Çözümlenmemiş taşınmış numaralara mesaj göndermek WhatsApp Hatası 463'ü tetikler; geliştiriciler, teslimat kesintilerini önlemek için uygun LID eşlemesini uygulamalıdır.
Uygun LID çözümlemesini atlayan projelerin, yüksek hacimli kampanyalar sırasında yüksek mesaj başarısızlık oranları yaşadığını gördük. Meta bir kullanıcı hesabını çoklu cihaz mimarisine taşıdığında, kişinin cihaz anahtarları WhatsApp oturumunuzla senkronize edilmelidir. Bu durum, bir oturumdaki her cihazın benzersiz genel anahtarlar değiş tokuş etmesini gerektiren WhatsApp'ın uçtan uca şifrelemesinin (E2EE) kriptografik yapısından kaynaklanır. Taşınmış ancak henüz senkronize edilmemiş ham bir telefon numarasına doğrudan mesaj göndermeye çalışırsanız, WhatsApp sunucuları isteği WhatsApp Hatası 463 (missing tctoken) ile reddedecektir. Bu hata, oturumunuzun mesajı kullanıcının aktif bağlı cihazlarına yönlendirmek için gereken şifreleme belirteçlerinden yoksun olduğunu gösterir. LID'yi birincil telefon numarasına çözümlemek ve mesajı eşlenen tanımlayıcıya göndermek bu teslimat engelini ortadan kaldırır.
Ayrıca, geliştiriciler belirli koşullar altında nadir de olsa çözümleme hataları beklemelidir:
-
Yeni Oluşturulan Hesaplar: Bir kişi son birkaç dakika içinde WhatsApp'a kaydolduysa, Meta'nın dizin sunucularında, LID-telefon eşlemesi küresel olarak kullanılabilir hale gelmeden önce 60 saniyeye kadar bir yayılma gecikmesi (propagation delay) yaşanabilir.
-
Senkronize Edilmemiş Oturumlar: Whapi.Cloud kanalınız QR kodu aracılığıyla yeni bağlandıysa, arka plan soketinin geçmiş kişi listelerini senkronize etmesi ve yerel çözümleme önbelleğini oluşturması 30 saniyeye kadar sürebilir.
-
Geçersiz LID'ler: Hatalı biçimlendirilmiş veya engellenmiş bir hesaba ait bir LID dizesi iletmek HTTP 400 hatasına neden olur. Uç noktayı çağırmadan önce arka ucunuzda LID biçimini her zaman doğrulayın.
Yüksek hacimli testler sırasında beklenmedik davranışlarla veya kalıcı çözümleme hatalarıyla karşılaşırsanız, whapi.cloud adresindeki sohbet penceresi aracılığıyla Whapi.Cloud destek ekibine ulaşın ve oturumunuzu aktif tutmak için hesap engellemelerini önleme konusundaki önerilerimizi takip edin--ekip, müşterilerin üretim sorunlarını çözmelerine aktif olarak yardımcı olmaktadır.
İş Kullanım Durumları: CRM Lider Senkronizasyonu ve Click-to-WhatsApp Reklam İlişkilendirmesi
LID'leri çözümlemek, CRM veri bütünlüğünü korumak ve ücretli müşteri edinme kampanyalarınızda doğru pazarlama ilişkilendirmesi sağlamak için kritik bir gerekliliktir.
En sık karşılaştığımız durum, işletmelerin gelen LID'leri birincil CRM kişileriyle eşleştiremedikleri için pazarlama ilişkilendirme verilerinin %15'ine kadarını kaybetmeleridir. Anonimleştirilmiş LID'ler iş akışlarınıza girdiğinde, veritabanı siloları oluşturarak ve dönüşüm takibini bozarak doğrudan kârlılığınızı etkiler.
CRM Lider Senkronizasyonu ve Zenginleştirme
Gelen @lid kişileri mükerrer CRM profillerine neden olur; soket düzeyinde çözümleme HubSpot veri bütünlüğünü geri kazandırır. Bir müşteri bir sohbet başlattığında, web kancanız gönderen tanımlayıcısı olarak müşterinin `@lid` değerini alır. HubSpot ve Salesforce gibi CRM sistemleriniz kişileri E.164 telefon numaralarına göre eşleştirecek şekilde yapılandırılmışsa, bir eşleşme bulamazlar. Bu senkronizasyon mekanizması, mükerrer müşteri kayıtlarını önlemeye yönelik WhatsApp CRM entegrasyonu karar çerçevemizle uyumludur. CRM, mevcut müşteri profilini güncellemek yerine mükerrer, sahipsiz bir lider kaydı oluşturarak satış süreçlerini bozar ve satış temsilcilerinizin kafasını karıştırır.
Whapi.Cloud'un çözümleme uç noktasını uygulayarak, entegrasyon hattınız gelen web kancasını yakalayabilir, LID'yi 200 milisaniyenin altında gerçek telefon numarasına çözümleyebilir ve temiz bir Lider Senkronizasyonu ve Zenginleştirme (Lead Sync & Enrichment) iş akışı gerçekleştirebilir. Bu, tüm sohbet günlüklerinin, notların ve fırsatların manuel müdahale veya lider sürtüşmesi olmaksızın doğru, birleştirilmiş müşteri profiliyle eşleşmesini sağlar.
Click-to-WhatsApp Reklam İlişkilendirmesi
Anonimleştirilmiş LID'ler dönüşüm takibini bozar; Whapi.Cloud, Meta Dönüşümler API'si ilişkilendirmesi için numaraları çözümler. Click-to-WhatsApp reklamları çalıştırırken Meta, web kancanıza benzersiz bir tıklama tanımlayıcısı (`ctwa_clid`) içeren bir yönlendirme yükü iletir. Bu olayların takibi hakkında daha fazla bilgi edinmek için, Click-to-WhatsApp reklam kampanyalarını nasıl takip edeceğiniz hakkındaki eksiksiz kılavuzumuzu inceleyebilirsiniz. Dönüşümü ilişkilendirmek ve reklam harcamalarınızı optimize etmek için bu etkileşimi Meta Dönüşümler API'sine (CAPI) geri göndermeniz gerekir.
Ancak Meta CAPI, çevrimdışı olayı Facebook kullanıcısıyla eşleştirmek için genellikle SHA-256 Karma (Hashing) işlemiyle işlenmiş, doğrulanmış bir E.164 telefon numarası gerektirir. Meta, ilk sohbet web kancasında anonimleştirilmiş bir `@lid` ilettiği için tanımlayıcıyı doğrudan karma haline getiremezsiniz. Çözümlenmemiş LID'ler, SHA-256 karması alınabilir telefon numaralarının eksikliği nedeniyle Meta Dönüşümler API'si Olay Eşleşme Kalitesini (EMQ) sıfıra düşürerek reklam optimizasyonunuzu işe yaramaz hale getirir. LID'yi orijinal telefon numarasına geri çözümlemek, SHA-256 dönüşümünü gerçekleştirmenize ve doğru ilişkilendirme verileri sunmanıza olanak tanıyarak müşteri edinme maliyetlerinizi doğrudan düşürür.
Yüksek hacimlerde, Whapi.Cloud'un sabit abonelik fiyatlandırması bütçenizi tamamen öngörülebilir tutar. Her sohbet veya mesajda ek ücret talep eden resmi API'lerin aksine, Whapi.Cloud'un bağlı numara başına sabit ücreti, ayda ister 500 ister 50.000 lider işleyin, lider zenginleştirme ve ilişkilendirme iş akışlarınızın maliyetinin aynı kalması anlamına gelir. Bu sabit ücretli abonelik fiyatlandırması, mesaj başına ek ücret olmaksızın yüksek mesaj ve lider hacmini öngörülebilir bir şekilde yöneterek, işletmenizin pazarlama operasyonlarını finansal sürprizlerle karşılaşmadan ölçeklendirmesine olanak tanır.
