WhatsApp Tıkla-Sohbet-Et (Click-to-Chat) Bağlantıları ve URL Şeması Kılavuzu

WhatsApp Tıkla-Sohbet-Et (Click-to-Chat) Bağlantıları ve URL Şeması Kılavuzu

WhatsApp'ın «Tıkla ve Sohbet Et» (Click-to-Chat) özelliği, kullanıcıların bir telefon numarasını rehberlerine kaydetmelerine gerek kalmadan o kişi veya işletmeyle doğrudan mesajlaşma başlatabilmelerini sağlar. Geçerli bir telefon numarası ve aktif bir WhatsApp hesabı olduğu sürece, tek bir linke tıklamak anında sohbet penceresini açar.

Prensip son derece basit görünse de, artı işareti (+), başta sıfır (0), parantezler veya satır sonlarında hatalı karakter kodlaması gibi ufak biçimlendirme hataları her gün milyonlarca bozuk bağlantıya yol açmaktadır.

Bu teknik kılavuzda resmi URL standartlarını, E.164 numara temizleme kurallarını ve en iyi URL kodlama yöntemlerini inceliyoruz.

---

1. Resmi WhatsApp URL Formatları

WhatsApp, sohbet başlatmak için resmi olarak iki farklı URL yapısını destekler:

Modern Standart: https://wa.me/<numara>

Meta/WhatsApp tarafından önerilen ve sektörde standart haline gelen biçim kısa wa.me alan adını kullanır:

https://wa.me/905321234567

Önceden doldurulmuş hazır mesaj ile:

https://wa.me/905321234567?text=Merhaba%20bilgi%20almak%20istiyorum

Eski API Şeması: https://api.whatsapp.com/send

Geriye dönük uyumluluk için halen çalışan eski format:

https://api.whatsapp.com/send?phone=905321234567&text=Merhaba

Tavsiye: Her zaman wa.me formatını tercih edin. Daha kısa ve estetiktir; mobil cihazlardaki uygulama yönlendirmelerini daha kararlı biçimde gerçekleştirir.

---

2. E.164 Telefon Numarası Formatlama Kuralları

Bağlantının tüm dünyada sorunsuz çalışması için numaranın uluslararası E.164 standardına uyması zorunludur:

• Yalnızca rakamlar: Artı işareti (+), boşluk, tire veya parantez kesinlikle kullanılmamalıdır.
• Ülke kodunu ekleyin: Başında 00 olmadan (Örn: Türkiye için 90).
• Ulusal çıkış sıfırını kaldırın: Türkiye'deki 0532 123 45 67 numarası 905321234567 haline gelmelidir (baştaki sıfır atılır).

Karşılaştırmalı Tablo

Orijinal Numara	Geçerli E.164 Formatı	Doğru URL
Türkiye: 0532 123 45 67	905321234567	https://wa.me/905321234567
Almanya: 0170 1234567	491701234567	https://wa.me/491701234567
İngiltere: 07911 123456	447911123456	https://wa.me/447911123456

---

3. Hazır Mesajlar İçin URL Kodlama (URL Encoding)

Metin parametresini (?text=) URL içerisinde iletirken RFC 3986 standartlarına göre kodlama yapmak gerekir:

• Boşluklar %20 olarak yazılmalıdır.
• Satır başları (Enter) için %0A kullanılmalıdır.
• Özel işaretler (&, #, ?) mutlaka kodlanmalıdır (%26, %23, %3F).

JavaScript ile dinamik bağlantı oluşturma örneği:

const phone = "905321234567";
const message = "Merhaba!\nSitenizdeki teklif hakkında bilgi almak istiyorum.";
const url = `https://wa.me/${phone}?text=${encodeURIComponent(message)}`;

---

4. Fiziksel Materyaller İçin QR Kodlar

Click-to-Chat bağlantılarınızı afiş, ambalaj, broşür veya kartvizitler için taranabilir QR kodlara dönüştürebilirsiniz. Kullanıcı kamerayla tarattığında numara tuşlamaya gerek kalmadan doğrudan sohbet başlar.

Kendi bağlantınızı ve QR kodunuzu hemen oluşturmak için WhatsApp Link Oluşturucu sayfamızı ziyaret edin.