WhatsApp API Kontrolleri için E.164 Formatı: Yerel Formatlar Aramaları Nasıl Bozar?

E.164 formatını tanımlar, yanlış WhatsApp kontrol sonuçlarına yol açan yerel format hatalarını gösterir ve API ile dosya iş akışları için bir normalleştirme rutini sunar.

E.164, ITU uluslararası numaralandırma formatıdır: bir ülke kodu ve ardından ulusal numara, en fazla 15 basamak, başında artı işareti olan ve boşluk, tire veya hat öneki içermeyen standart formdur. WhatsApp API kontrolleri, numaraların bu uluslararası formda olmasını bekler; çünkü 07700 900123 gibi yerel bir format, numaranın hangi ülkeye ait olduğunu belirtmez. Her numarayı kontrol etmeden önce E.164 formatına normalleştirmek, sonucun gerçekten hedeflediğiniz numarayla eşleşmesini sağlar.

E.164 formatı nedir?

ITU-T Recommendation E.164, uluslararası kamu telekomünikasyon numaralandırma planını tanımlar. Pratik veri çalışmaları için bir E.164 numarasının üç özelliği vardır:

• 1, 44, 55 veya 971 gibi bir ila üç basamaklı bir ülke arama koduyla başlar.
• Ulusal anlamlı numara ile devam eder, ancak yerel hat öneki (genellikle baştaki 0) içermez.
• Toplamda 15 basamaktan uzun değildir ve standart yazım biçimi, yalnızca rakamların takip ettiği bir artı işaretidir; örneğin +447700900123.

E.164'ün dışarıda bıraktıkları, dahil ettikleri kadar önemlidir: 00 veya 011 gibi uluslararası arama önekleri, parantezler, boşluklar veya dahili numaralar içermez.

Yerel formatlar WhatsApp API kontrollerini nasıl bozar?

Bu konuyla ilgili üst sıralarda yer alan çoğu sayfa, tanım aşamasında kalır. Pratik sorun, sıradan CRM verilerinin nasıl yanlış bir aramaya dönüştüğüdür. Buna neden olan kalıplar şunlardır:

Meta'nın WhatsApp user phone number format guidance belgesi, gönderim tarafındaki riski açıkça göstermektedir: artı işareti ve ülke kodu olmadan, işletme numarasının kendi ülke kodu başa eklenebilir; bu nedenle Hindistan'daki bir işletme numarasından gönderilen "(631) 555-1234", hedeflenen ABD numarası yerine +916315551234 olarak çözümlenebilir. Aynı belirsizlik her kontrol için geçerlidir. Kontrol yanlış numara üzerinde çalışırsa, sonucu başkasına ait bir durumu tanımlar.

Numara kontrolü öncesi normalleştirme rutini

Numaralar ister API üzerinden ister bir dosya aracılığıyla gönderilsin, her WhatsApp kontrolünden önce şu adımları uygulayın:

1. Numaraları metin olarak saklayın. Elektronik tablo sayı hücreleri artı işaretini ve baştaki sıfırları kaldırır, ayrıca uzun değerler bilimsel gösterime dönüşebilir.
2. Ülkeyi kayıtla birlikte tutun. Normalleştirme, yerel formatta girilen numaralar için varsayılan bir bölgeye ihtiyaç duyar; bunu satış ekibinin konumundan değil, kişinin ülke alanından alın.
3. Bakımı yapılan bir kütüphane ile ayrıştırın. Google'ın libphonenumber kütüphanesi, ham bir dizgiyi ve bölgeyi ülke kodu ve ulusal numaraya ayrıştırır ve E.164 formatına getirir. isPossibleNumber işlevi yalnızca uzunluk kontrolü yaparken, isValidNumber işlevi bölge için önek bilgilerini de kullanır.
4. Hataları karantinaya alın. Ayrıştırılamayan veya doğrulamadan geçemeyen değerleri kontrol ediciye göndermek yerine bir inceleme kuyruğuna alın.
5. Normalleştirmeden sonra tekilleştirin. "07700 900123" ve "+44 7700 900123" ancak bu adımdan sonra aynı numara haline gelir.

Bu adımlar dar bir soruyu yanıtlar: dizgi, bölgesi için makul bir uluslararası numara mı? Numaranın bir WhatsApp hesabı olup olmadığı ise yalnızca WhatsApp Kayıt Kontrolü ile yanıtlanan ayrı bir sorudur.

WA Lookup API ve dosyaları ile E.164 kullanımı

WA Lookup gerçek zamanlı API'si, POST /api/v1/check için E.164 formatında tek bir telefon numarası kabul eder; buna X-API-Key başlığı ve WhatsApp Kayıt Kontrolü, WhatsApp Profil Fotoğrafı Kontrolü veya WhatsApp Business Hesabı Kontrolü seçeneklerinden birini belirleyen service_type eşlik eder. POST /api/v1/batch-check isteği, istek başına 100 numaraya kadar kabul eder ve aynı normalleştirme içindeki her numaraya uygulanır. Tam istek gövdesi için güncel API belgelerini takip edin.

Toplu dosya görevlerinin kendine özgü biçimlendirme ihtiyaçları vardır:

• Yalnızca TXT veya CSV, satır başına bir ülke kodlu numara.
• Dosya esasen seçilen tek bir ülkeyi içermelidir. Numaraların %10 veya daha fazlası başka ülkelerden geldiğinde, ön kontrol dosyayı reddeder; bu nedenle normalleştirmeden sonra ülke koduna göre ayırın.
• Çin (+86), Hong Kong (+852) ve Makao (+853) numaraları toplu dosyalarda kabul edilmez; sınırlı gerçek zamanlı tekil kontroller bu bölgeleri destekler.

İncelemede yakalanması gereken yaygın E.164 hataları

• Her numaranın yerel olduğunu varsaymak. Varsayılan bölge, yerel formatlı girişler için bir yedekleme yöntemidir, her satır için bir kural değildir.
• Depolama için artı işaretini kaldırmak. CRM içinde standart formu koruyun; yalnızca belirli bir sistem başka bir gösterim gerektiriyorsa dönüştürün.
• Dahili numaraları tutmak. Kontrol etmeden önce "dahili 204" gibi dahili numara metinlerini kaldırın; E.164'te buna yer yoktur.
• Normalleştirmeyi izin olarak değerlendirmek. Doğru biçimlendirilmiş ve kayıtlı bir numara, WhatsApp Business Messaging Policy kapsamında yine de erişim öncesi opt-in gerektirir.
• Formatları tek sütunda karıştırmak. Kontrol ve gönderim için kullanılan tek bir normalleştirilmiş sütun, sonuçların ait oldukları kayıtlardan sapmasını önler.

Sıkça Sorulan Sorular

Ekipler, saklanan bir numaranın zaten E.164 formatında olup olmadığını nasıl anlayabilir?

Değer bir artı işaretiyle başlar, sonrasında sadece rakamlar içerir, ülke kodundan sonra hat öneki sıfır içermez ve 15 basamak veya daha azdır. libphonenumber gibi bir kütüphane ile ayrıştırıp tekrar E.164 formatına getirmek aynı dizgiyi döndürmelidir.

Baştaki artı işareti WhatsApp kontrolleri ve mesajları için önemli mi?

Numarayı uluslararası olarak işaretler. Meta'nın rehberliği, hem artı işaretinin hem de ülke kodunun dahil edilmesini önerir; çünkü bunlar olmadan numara, gönderenin ülke koduyla yorumlanabilir. WA Lookup için, istekte beklenen tam dizgi için güncel API belgelerini takip edin.

Normalleştirmeden geçemeyen numaralara ne olmalı?

Bunları orijinal değer ve kaydın ülkesiyle birlikte bir inceleme kuyruğuna gönderin. Belirsiz veya hatalı biçimlendirilmiş bir dizgiyi kontrol etmek bakiyenizi harcar ve sonucun farklı bir numarayla eşleşmesine neden olabilir.

Toplu dosya neden tek bir ülkeden numaralara ihtiyaç duyar?

Toplu görevler seçilen bir ülke için gönderilir ve ön kontrol, numaraların %10 veya daha fazlasının başka ülkelerden geldiği dosyaları reddeder. Önce E.164 formatına normalleştirmek, karma bir dışa aktarımı ülke koduna göre ayırmayı kolaylaştırır.

Daha Fazla Bilgi

İş akışınızdaki bir sonraki adıma uygun ürün bilgilerini seçin.

• Ürün belgelerini görüntüleyin →
• Ekiple görüşün →