Başla
TR
WhatsApp click-to-chat

WhatsApp Bağlantı API'si: wa.me ve api.whatsapp.com Açıklandı

WhatsApp bağlantısı bir API değil, bir URL'dir. Tam formatlar, text parametresi, ücretsiz bir oluşturucu ve bağlantının sınırları burada.

Hemen başlayın
Nasıl çalışır

WhatsApp Bağlantı API'si: wa.me ve api.whatsapp.com bağlantıları aslında nasıl çalışır?

İkisi de bir sohbet açar, gerisini bir insan üstlenir.

  1. 1Biri URL'yi açar
  2. 2WhatsApp sohbeti açar
  3. 3Bir kişi gönder'e basar
Tanım

WhatsApp bağlantı API'si nedir?

WhatsApp bağlantı API'si diye bir şey yoktur. https://wa.me/<number> ve https://api.whatsapp.com/send?phone=<number> birer click-to-chat URL'sidir. API'ler, bağlantının bittiği yerde başlar.

Bir WhatsApp bağlantısı
Kurulum
Yok
Tıklayınca
Sohbet açar, metni önceden doldurur
Kim işlem yapar
Bir insan gönder'e basar
Bir WhatsApp API'si
Kurulum
Hesap bağlama ve bir API anahtarı
Çağrıda
Mesaj gönderir, alır ve listeler
Kim işlem yapar
Yazılımınız, bağlı hesap adına
Format

Tam wa.me bağlantı formatı nedir?

Belgelenmiş format https://wa.me/<number> şeklindedir; telefon numarası uluslararası formatta ve eksiksiz yazılır.

URL'nin yapısı
https://wa.me/1XXXXXXXXXX
Host. Her zaman aynıdır.
Numara. Önce ülke kodu, yalnızca rakam.
Kullanınhttps://wa.me/1XXXXXXXXXX
Kullanmayınhttps://wa.me/+001-(XXX)XXXXXXX
Oluşturmadan önce kaldırın+Baştaki 0BoşluklarTirelerParantezler

Kaynak: WhatsApp Yardım Merkezi, "How to use click to chat"

Karşılaştırma

wa.me ile api.whatsapp.com/send arasındaki fark nedir?

İkisi de aynı sohbeti açar. Yalnızca numaranın yeri değişir.

wa.meBelgelenmiş
https://wa.me/1XXXXXXXXXX?text=Hi

Numara yolun içinde. WhatsApp tarafından belgelenmiş.

api.whatsapp.com/sendHâlâ yaygın
https://api.whatsapp.com/send?phone=1XXXXXXXXXX&text=Hi

Numara phone parametresinde. Bulabildiğimiz güncel yardım sayfasında yer almıyor.

Bu bir belgeleme eksikliği, kullanımdan kaldırma değil. Yeni bağlantıları wa.me ile oluşturun.

text parametresi

WhatsApp bağlantısına önceden doldurulmuş mesaj nasıl eklenir?

Sonuna ?text= ve URL kodlu mesajı ekleyin: https://wa.me/<number>?text=<urlencodedtext>. Metin düzenlenebilir kalır.

Kodlanması gereken karakterler
Boşluk%20
Yeni satır%0A
&%26
#%23
+%2B

Emoji ve diğerleri: encodeURIComponent().

Numara yok mu? https://wa.me/?text=... kişi seçiciyi açar.

build-link.js
const number = "1XXXXXXXXXX";
const text = "Hi! I have a question.";
const link = `https://wa.me/${number}` +
  `?text=${encodeURIComponent(text)}`;
https://wa.me/1XXXXXXXXXX?text=Hi!%20I%20have%20a%20question.
Ücretsiz araç

WhatsApp bağlantınızı oluşturun

Bir numara ve mesaj yazın, ihtiyacınız olanı kopyalayın.

Yalnızca rakam, önce ülke kodu.
İsteğe bağlı, düzenlenebilir.

Tarayıcınızda çalışır. Hiçbir numara sunucuya gönderilmez.

wa.me bağlantısı
https://wa.me/15550123456?text=Merhaba!%20%C3%9Cr%C3%BCn%C3%BCn%C3%BCzle%20ilgili%20bir%20sorum%20var.
api.whatsapp.com karşılığı
https://api.whatsapp.com/send?phone=15550123456&text=Merhaba!%20%C3%9Cr%C3%BCn%C3%BCn%C3%BCzle%20ilgili%20bir%20sorum%20var.
text parametresi, kodlanmış
Merhaba!%20%C3%9Cr%C3%BCn%C3%BCn%C3%BCzle%20ilgili%20bir%20sorum%20var.
HTML kod parçası
<a href="https://wa.me/15550123456?text=Merhaba!%20%C3%9Cr%C3%BCn%C3%BCn%C3%BCzle%20ilgili%20bir%20sorum%20var." target="_blank" rel="noopener" aria-label="Chat on WhatsApp with 15550123456">Chat on WhatsApp</a>
"Chat on WhatsApp" butonu
<a href="https://wa.me/15550123456?text=Merhaba!%20%C3%9Cr%C3%BCn%C3%BCn%C3%BCzle%20ilgili%20bir%20sorum%20var." target="_blank" rel="noopener"><img src="whatsapp-icon.svg" alt=""> Chat on WhatsApp</a>

Bağlantı bir sohbet açar. Mesaj göndermez ve ürününüz yanıtı hiçbir zaman görmez.

Bağlantının yapamadığını inşa edin
Kısa cevap

WhatsApp bağlantısı mesajı gönderir mi?

Hayır. Telefonu elinde tutan kişi gönder'e basana kadar hiçbir şey iletilmez.

Sohbet açıldı
Metin önceden dolduruldu
Yalnızca gönder'e dokunulunca iletilir
Bağlantının bittiği yer

WhatsApp bağlantısı neleri yapamaz?

Click-to-chat bağlantısı durumsuzdur: uygulamanız sonrasında ne olduğunu hiçbir zaman öğrenmez.

Bağlantının yaptıkları
  • Bağlantıya tıklandı
  • Sohbet açılır
  • Mesaj önceden doldurulur
  • Elle gönderim
Bağlantı burada biter
API gerektirenler
  • Gelen yanıt
  • Sohbet geçmişi
  • Webhook olayı
  • Kullanıcı bazında atıf
İletim veya okundu durumu yok
Ek dosya yok
Sunucu tarafı tetikleyici yok
WhatsApp kullanmayan numarada sessizce başarısız olur
Cihaza göre farklı davranış
Grup yok, bkz. WhatsApp Group API sınırları
Gerçek bir WhatsApp entegrasyonu kurun
Bağlantının ötesinde

Yanıtı uygulamanıza nasıl alırsınız?

Bir WhatsApp oturumunu tutan bir API gerekir. İki yol var.

Meta Cloud APIDoğrulanmış işletme
  • Doğrulanmış bir WhatsApp Business hesabı gerektirir
  • 1 Temmuz 2025'ten beri mesaj başına faturalandırılır, bkz. WhatsApp Business API fiyatlandırması
  • 24 saatlik penceredeki yanıtlar: 1 Ekim 2026'dan beri numara başına ayda 1.000 ücretsiz
Bağlı hesap, UnipileBusiness doğrulaması yok
  • Her son kullanıcı kendi WhatsApp hesabını bağlar
  • Uygulamanız kimliği doğrulanmış kullanıcı adına işlem yapar
  • Yanıtlar dahil, gerçek inbox'tan okur ve gönderir
  • LinkedIn, Telegram, Gmail ve fazlası için aynı API
Unipile ile
  1. 1Hesabı QR kod veya eşleştirme koduyla bağlayın
  2. 2Uygulamanızdan gönderin
  3. 3Yanıtları webhook ile alın: message_received

Bkz. Unipile WhatsApp API ve API ile WhatsApp mesajı gönderme. Referans: developer.unipile.com/v1.0/docs/whatsapp.

Unipile ile oluşturun
Karar

Bağlantı, Cloud API veya bağlı hesap: hangisine ihtiyacınız var?

İlk kimin yazdığına göre seçin.

Bağlantı

Sohbeti sayfanızdan bir insan başlatır.

Kimlik doğrulama
Yok
Maliyet
Ücretsiz
Yanıtlar
Uygulamanız göremez
Yukarıdaki oluşturucuyu kullanın
Meta Cloud API

Doğrulanmış bir işletme şablon gönderir.

Kimlik doğrulama
Doğrulanmış Meta Business hesabı
Maliyet
1 Temmuz 2025'ten beri mesaj başına
Yanıtlar
Evet, webhook ile
WhatsApp Cloud API entegrasyon rehberi
Bağlı hesap

Ürününüz her kullanıcının kendi inbox'ında çalışır.

Kimlik doğrulama
QR kod veya eşleştirme kodu
Maliyet
Unipile planı, mesaj başına ücret yok
Yanıtlar
Evet, webhook ile
Eksiksiz WhatsApp API rehberi
Geliştirmeye başlayın
Uygulama

WhatsApp bağlantısı bir ürüne nasıl yerleştirilir?

Şablonlarınızda her kullanıcı için ayrı oluşturun. Çok kiracılı bir üründe tek bir numarayı asla sabit kodlamayın.

Bağlantı şablonu
https://wa.me/{{ user.whatsapp_number }}?text={{ prefilled_text | url_encode }}
Numara. Kullanıcı kaydından.
Metin. Render sırasında URL kodlanır.
Resmi buton

WhatsApp'ın yeşil "Chat on WhatsApp" rozeti, olduğu gibi.

QR kod

Herhangi bir QR oluşturucu, wa.me bağlantısını yazdırılabilir bir koda dönüştürür.

Nerede açılır
Mobil
WhatsApp uygulaması
Masaüstü, uygulama yüklü
Masaüstü uygulaması
Masaüstü, uygulama yok
WhatsApp Web
Sorun giderme

WhatsApp bağlantım neden çalışmıyor?

Çoğunlukla sebep numara formatı veya kodlanmamış metindir.

1 Numara düz uluslararası formatta değil
https://wa.me/+001-(XXX)XXXXXXX
https://wa.me/1XXXXXXXXXX

Çözüm: yalnızca rakam, önce ülke kodu.

2 text parametresi URL kodlanmamış
?text=Hi there & welcome
?text=Hi%20there%20%26%20welcome

Çözüm: encodeURIComponent() veya urllib.parse.quote().

3 Aktif WhatsApp hesabı yok

Sohbet sessizce başarısız olur.

4 Uygulama içi tarayıcıda açıldı

Sistem tarayıcısını kullanın.

5 Bağlantı önizlemesi URL'yi değiştirdi

Sorgu dizesi kayboldu. Ham URL'yi test edin.

Bağlı hesaplarla geliştirin

WhatsApp Bağlantı API'si: SSS

Geliştiriciler için kısa yanıtlar.

Hayır. wa.me ve api.whatsapp.com/send birer click-to-chat URL'sidir: kimlik doğrulama veya kod olmadan bir WhatsApp sohbeti açarlar. WhatsApp API'leri, bağlantının bittiği yerde başlar.

https://wa.me/<number>; burada <number>, baştaki sıfırlar, parantezler, boşluklar veya tireler olmadan uluslararası formattaki tam numaradır. Örneğin: https://wa.me/1XXXXXXXXXX.

İkisi de aynı sohbeti açar. wa.me/<number>, WhatsApp Yardım Merkezi'nde belgelenen kısa biçimdir ve numara yolun içindedir. api.whatsapp.com/send?phone=<number> ise numaranın sorgu parametresi olarak verildiği uzun biçimdir.

Hayır. Bağlantı sohbeti açar ve metin alanını önceden doldurabilir. Telefonu elinde tutan kişi gönder'e basana kadar hiçbir şey iletilmez.

Evet. Sonuna ?text= ve URL kodlu bir mesaj ekleyin, örneğin https://wa.me/1XXXXXXXXXX?text=Hi%2C%20I%20have%20a%20question. Metin, gönderilmeden önce düzenlenebilir kalır. Yukarıdaki oluşturucuyu deneyin.

Genellikle numara düz uluslararası formatta değildir veya metin URL kodlanmamıştır. Ayrıca numaranın WhatsApp'ta olduğunu kontrol edin ve uygulama içi tarayıcılardan kaçının.

Hayır. Bir wa.me veya api.whatsapp.com/send bağlantısı Business hesabı ya da API erişimi gerektirmez. Cloud API, doğrulama isteyen ayrı bir üründür. Eksiksiz WhatsApp API rehberine göz atın.

Bağlantıyla alamazsınız: bağlantı durumsuzdur. Doğrulanmış bir Business hesabıyla Meta'nın Cloud API'sini ya da Unipile'ı kullanın; Unipile'da her son kullanıcı kendi hesabını QR kod veya eşleştirme koduyla bağlar ve uygulamanız kimliği doğrulanmış kullanıcı adına işlem yapar. API ile WhatsApp mesajı göndermeyi inceleyin.

Bağlantı mı, API mi? Ekibimiz karar vermenize yardımcı olabilir.

Bir uzmanla görüşün