E.164 Telefon Numarası Biçimi: Dönüştürme ve Doğrulama

SMS ve WhatsApp API'leri neden E.164 ister?

Çünkü yönlendirme belirsiz olmayan bir numaraya dayanır. Ülke kodu olmayan bir numara birçok ülkeye ait olabilir; bu yüzden platform yanlış pazara gönderebilir, yanlış gönderici kimliği kurallarını uygulayabilir ve yanlış tarifeyi faturalayabilir. Tarifeler, gönderici kimliği kaydı ve tanıtım gönderim saatlerinin hepsi hedef ülke başına uygulanır ve hedefi belirleyen ülke kodudur.

Meta, WhatsApp numaraları hakkında ne diyor?

Meta'nın WhatsApp kullanıcı telefon numarası biçimlerine ilişkin belgeleri, mesaj gönderme isteklerinde artı işareti, tire, parantez ve boşlukların desteklendiğini söyler ve artı işareti ile ülke arama kodunun eklenmesini şiddetle önerir. Artı işareti eksikse numaraya gönderenin ülke arama kodu eklenir; bu da mesajın yanlış bir numaraya gitmesine yol açabilir. Meta'nın örneği: Hindistan'daki (kod 91) bir gönderici için (631) 555-1234, +916315551234 numarasına teslim edilir; +1 (631) 555-1234 ise doğru şekilde teslim edilir. Meta ayrıca Brezilya ve Meksika için Cloud API'nin bazı numaralarda görünen ek öneki değiştirebileceğini belirtir ve bunu standart davranış olarak niteler.

Güvenli yaklaşım: temiz E.164'ü saklayın ve tam olarak onu gönderin.

SMS için durum nedir?

SMS API'leri de tam uluslararası numarayı bekler. Bazıları artı işaretsiz rakamları ister; biçim API'ler ve protokoller arasında farklılaşır, bu yüzden kullandığınız API'nin belgelerine bakın ve kendi numaranızla test edin. Çalışan örnekler için API ile SMS gönderme ve API ile WhatsApp mesajı gönderme yazılarına bakın.

Kodda numaraları nasıl doğrular ve normalleştiririm?

Hızlı biçim kontrolü için regex, gerçek doğrulama için kütüphane kullanın.

Yaygın bir E.164 biçim kontrolü:

// Plus, a non-zero first digit, then 1 to 14 more digits: 15 digits at most
const E164 = /^\+[1-9]\d{1,14}$/;

function looksLikeE164(value) {
  return E164.test(value);
}

looksLikeE164("+971501234567"); // true
looksLikeE164("0501234567");    // false: no plus or country code
looksLikeE164("+0501234567");   // false: country codes do not start with 0

Regex yalnızca uzunluğu ve karakterleri kontrol eder. Böyle bir numara olmamasına rağmen +99999999999 değerini kabul eder. Gerçek doğrulama için, uluslararası telefon numaralarını ayrıştırma, biçimlendirme ve doğrulama kütüphanesi olan, Java, C++ ve JavaScript için bulunan ve diğer dillerde topluluk portları olan Google'ın açık kaynaklı libphonenumber kütüphanesini kullanın. README dosyası isValidNumber işlevini, uzunluk ve önek bilgisini kullanan bir bölge için tam doğrulama olarak tanımlar ve ayrıştırılmış bir numaranın E.164 olarak biçimlendirilmesini gösterir.

# pip install phonenumbers  (a Python port of libphonenumber)
import phonenumbers

def to_e164(raw, default_region):
    try:
        number = phonenumbers.parse(raw, default_region)  # e.g. "AE", "SA", "GB"
    except phonenumbers.NumberParseException:
        return None
    if not phonenumbers.is_valid_number(number):
        return None
    return phonenumbers.format_number(number, phonenumbers.PhoneNumberFormat.E164)

print(to_e164("050 123 4567", "AE"))   # +971501234567 if the number is valid for the UAE
print(to_e164("+44 7700 900123", "GB"))

Portları dış geliştiriciler yazar; bu yüzden seçtiğiniz portun kalitesini kontrol edin. Müşterinizin ülkesinden aldığınız varsayılan bölgeyle ayrıştırın, sonra E.164 sonucunu saklayın. Kurallar değişirse yeniden ayrıştırabilmek için ham girdiyi de saklayın.

Normalleştirmeyi gönderim anında değil, giriş noktasında yapın: kayıt formunda, CRM içe aktarımında veya API'de. İki farklı yazılmış numara, aynı kampanyayı alan iki kişi olur.

Tabloda telefon numaralarını nasıl düzeltirim?

Numaraları girmeden veya yapıştırmadan önce telefon sütununu Metin olarak biçimlendirin. Yaygın sorunlar şunlardır:

Microsoft, Excel'in baştaki sıfırları sildiğini ve büyük sayıları bilimsel gösterime çevirdiğini, Metin biçimi uygulanmadan önce girilen numaraların yeniden girilmesi gerektiğini belgeler. Bir CSV dosyasını doğrudan açtığınızda Excel her sütuna varsayılan biçimlerini uygular; telefon sütununu metin olarak işaretlemek için Metin İçeri Aktarma Sihirbazı'nı (Text Import Wizard) veya From Text/CSV'yi kullanın.

A sütununda 050 123 4567 olarak saklanan bir BAE mobil listesi için bu formül E.164'ü metin olarak oluşturur:

="+971"&RIGHT(SUBSTITUTE(A2," ",""),9)

Boşluklar kaldırıldıktan sonra son dokuz haneyi tutar; bu yüzden yalnızca bu biçimdeki numaralara uyar. Sonucu kopyalayın ve CSV olarak kaydetmeden önce değer olarak yapıştırın. Telefon numarası biçimlendirici formül olmadan numara dönüştürür; Excel veya CSV'den toplu SMS gönderme rehberimiz ise tam yükleme iş akışını gösterir.

Örnek: bir müşteri listesini temizlemek

Dubai'li bir perakendeci olan "Souq Rafiq" (kurgusal), üç sistemden 0501234567, 971 50 123 4567, +971-50-123-4567 ve 00971501234567 gibi numaralarla 8.000 kişiyi dışa aktarır.

1. Analist, her müşterinin fatura ülkesinden bir ülke sütunu ekler.
2. Bir betik her satırı ülkeyi varsayılan bölge alarak ayrıştırır; böylece dört biçimin hepsi +971501234567 olur.
3. Doğrulamada başarısız olan satırlar gönderilmek yerine bir inceleme sayfasına gider.
4. Mükerrer kayıtlar normalleştirmeden sonra silinir; bu da dört biçimi tek kişiye indirir.
5. Kampanyadan önce bir HLR sorgusu etkin olmayan numaraları işaretler. Bkz. HLR sorgusu açıklaması.
6. Temiz sütun Metin olarak saklanır ve yüklenir.

Mükerrer kontrolünü çalıştıran şey önce normalleştirmektir; ondan önce aynı müşteri dört kişi gibi görünüyordu.

Sık yapılan hatalar nelerdir?

• Baştaki sıfırı her zaman silmek. İtalya gibi bazı ülkelerde trunk öneki yoktur.
• Sıfırı koruyup ülke kodunu eklemek; sonuç +9710501234567 olur.
• WhatsApp'a artı işareti olmadan göndermek; gönderenin ülke kodu eklenir.
• Regex'i doğrulama olarak kullanmak. Geçerliliği değil, biçimi kontrol eder.
• Excel'in telefonları sayı sanmasına izin vermek; sıfırlar kaybolur ya da bilimsel gösterime geçilir.
• Giriş anında değil, gönderim anında normalleştirmek.
• Geçerli bir biçimin ulaşılabilir bir numara olduğunu varsaymak. Taşınmış veya kapatılmış numaralar yine de başarısız olur.
• Statik bir tabloya güvenmek. Numaralandırma planları değişir; bakımı yapılan bir kütüphane kullanın.

OmniChannels.ai nasıl yardımcı olur?

OmniChannels.ai, SMS ve WhatsApp için uluslararası numaraları tek bir REST API üzerinden kabul eder ve kampanyaları önizleme ve mükerrer kayıt filtrelemeyle Excel ve CSV yüklemelerini kabul eder. BroadNet, HLR ve numara sorgusu sunar; böylece iyi biçimlendirilmiş bir numaranın etkin olduğunu kontrol edebilirsiniz. Tam istek alanları için SMS API belgelerini ve WhatsApp API belgelerini okuyun ya da devreye alma için ekibimizle konuşun.