WhatsApp Tıkla-Konuş (Click to Chat) API Protokolü, E.164 Numara Standardı ve URL Kodlama
Dijital pazarlama, e-ticaret müşteri hizmetleri ve sosyal medya satış dönüşümlerinde (Conversion Rate Optimization - CRO) potansiyel müşterinin satın alma kararından vazgeçmesinin en büyük nedeni, telefon numarasını rehbere manuel kaydetme zorunluluğudur. Meta (WhatsApp) tarafından resmi olarak sunulan wa.me Kısa Bağlantı Protokolü ve api.whatsapp.com/send Evrensel API yapısı; kullanıcının numarayı telefon rehberine kaydetmesine gerek kalmadan tek tıkla hem mobil uygulamada (iOS/Android) hem de WhatsApp Web / Masaüstü istemcisinde önceden doldurulmuş (pre-filled) mesajla doğrudan sohbet başlatmasını sağlar.
WhatsApp bağlantı mimarisi, Uluslararası Telekomünikasyon Birliği'nin ITU-T E.164 telefon numarası biçimlendirme standardını zorunlu kılar. Bu standarda göre telefon numarasının başında artı (+) işareti, çift sıfır (00), parantez, tire veya boşluk kesinlikle bulunmamalı; doğrudan ülke kodu ve 10 haneli abone numarası (Türkiye için 905XXXXXXXXX) bitişik olarak yazılmalıdır.
WhatsApp Resmi Bağlantı Türleri ve Teknik Parametre Tablosu
| Bağlantı Formatı / Yöntem | Teknik URL Yapısı | En Uygun Kullanım Alanı |
|---|---|---|
| Kısa Resmi Link (Sadece Numara) | https://wa.me/905321234567 |
Instagram Biyografi (Bio), SMS kampanyaları ve kartvizitler. |
| Hazır Mesajlı Kısa Link | https://wa.me/905321234567?text=Merhaba%20fiyat%20bilgisi... |
Ürün detay sayfaları, Google/Meta reklam yönlendirmeleri (CTA). |
| Tam API Endpoint | https://api.whatsapp.com/send?phone=905321234567&text=... |
Web sitesi sabit (floating) destek butonları ve CRM entegrasyonları. |
| Mobil Uygulama Deep Link | whatsapp://send?phone=905321234567&text=... |
Mobil uygulama içi yönlendirmeler (WhatsApp yüklü cihazlar). |
RFC 3986 Yüzde Kodlaması (URL Encoding) Neden Zorunludur?
Hazır mesaj metni (?text= parametresi) içinde yer alan boşluklar, Türkçe karakterler (ç, ğ, ı, ö, ş, ü) ve soru işareti/ve işareti gibi özel semboller ham haliyle URL içine yazılamaz; aksi takdirde tarayıcı bağlantıyı ilk boşlukta keser. Bu nedenle metin RFC 3986 Percent-Encoding (UTF-8) algoritmasıyla kodlanır:
- Boşluk (Space):
%20| Yeni Satır (Alt Satır / Enter):%0A - Soru İşareti (
?):%3F| Ve İşareti (&):%26 - Türkçe Karakterler:
ş = %C5%9F,ı = %C4%B1,ğ = %C4%9F,ü = %C3%BC,ö = %C3%B6,ç = %C3%A7.
Somut Örnek Uygulama Senaryosu ve Dönüşüm Oranı Etkisi
Telefon numarası 0 (532) 555 44 33 olan bir diş kliniğinin, web sitesindeki randevu butonuna "Merhaba, muayene randevusu için bilgi alabilir miyim?" hazır mesajını eklemek istediğini varsayalım:
- 1. Adım (E.164 Numara Temizliği): Baştaki yerel
0kaldırılır, Türkiye uluslararası ülke kodu90eklenir ve aradaki tüm boşluklar silinir $\rightarrow$905325554433. - 2. Adım (URL Encoding): Mesaj metni UTF-8 yüzde kodlamasına çevrilir $\rightarrow$
Merhaba%2C%20muayene%20randevusu%20i%C3%A7in%20bilgi%20alabilir%20miyim%3F. - 3. Adım (Nihai Tıklanabilir Link):
https://wa.me/905325554433?text=Merhaba%2C%20muayene%20randevusu%20i%C3%A7in%20bilgi%20alabilir%20miyim%3F - 4. Adım (QR Kod Üretimi): Aynı bağlantı yüksek hata düzeltme seviyeli (Error Correction Level M/Q) karekoda dönüştürülerek broşür, vitrin camı ve masaüstü standlarına basılır; müşteri telefon kamerasını tuttuğu anda mesaj hazır şekilde WhatsApp sohbet ekranı açılır.
Sık Yapılan Hatalar ve Sabit (0212 / 0850) Hatlarla Kullanım
En sık yapılan teknik hata ülke kodundan sonra yerel sıfırı unutmaktır (Örn: wa.me/900532... veya wa.me/+90532...). Bu iki yazım da WhatsApp sunucularında "Telefon numarası geçersiz" hatası döndürür. Ayrıca WhatsApp Business uygulaması yalnızca 05XX cep numaralarıyla değil, sesli arama doğrulaması (IVR) kullanılarak 0212, 0216, 0312 gibi sabit coğrafi hatlarla ve 0850 kurumsal numaralarla da (örneğin https://wa.me/908501234567) sorunsuz biçimde çalıştırılabilir. E-ticaret sitelerinde her ürün sayfasına o ürünün adını veya stok kodunu içeren dinamik hazır mesajlar eklemek, müşteri temsilcisinin hangi ürün için yazıldığını sorma süresini ortadan kaldırarak satış kapatma hızını %40 artırır.