LinkedIn
Instagram
Telgraf
Gmail
Görünüm
Google Takvim
Slack Topluluğuna Katılın İçindekiler
Bağlantı
Bağlantı Oluştur
Bağlantının Ötesinde
WhatsApp Sohbet Başlatma Bağlantıları
WhatsApp Bağlantı API'si: Nasıl Yapılır wa.me ve api.whatsapp.com Bağlantılar Gerçekten Çalışıyor
Bir WhatsApp bağlantısı bir API değil, bir URL'dir. Bu kılavuz size tam olarak wa.me ve api.whatsapp.com/send biçimler, text parametre, ücretsiz bir üreteç ve bağlantının durduğu ve gerçek bir entegrasyonun başlaması gereken nokta.
7 gün ücretsiz deneme, kredi kartı gerekmez
Sadece bir URL
Kimlik doğrulama yok, kod yok
Merhaba! Ürününüz hakkında bir sorum var.
Sohbeti açar. Bir insanın yine de gönder tuşuna basması gerekir.
Tanım
WhatsApp bağlantı API'si nedir?
WhatsApp bağlantı API'si yok.
https://wa.me/<number> ve https://api.whatsapp.com/send?phone=<number> tıklama-sohbet URL'leridir: bunlardan birine tıklandığında WhatsApp'ta bir sohbet açılır. Şunları gerektirirler kimlik doğrulama yok, geliştirici hesabı yok ve kod yok. WhatsApp API'leri ayrı bir katmandır ve tam olarak bağlantının bittiği yerde başlar.Kriter
Bir WhatsApp bağlantısı
Bir WhatsApp API'si
Biçimlendir
Bağlantıİstediğiniz yere yapıştırabileceğiniz bir URL
APIKimliği doğrulanmış bir HTTP uç noktası
Kurulum
BağlantıHiçbiri. Anında çalışır.
APIHesap bağlama, bir API anahtarı, bir istemci kitaplığı
Tıklandığında / arandığında ne olur
BağlantıBir sohbet açar ve bir metin alanını önceden doldurabilir
APIMesajları programatik olarak gönderir, alır ve listeler
Kim oynuyor
BağlantıBir insan gönder tuşuna basar
APIYazılımınız, bağlı hesap adına hareket eder
Biçimlendir
Tam wa.me bağlantı formatı nedir?
Belgelenen biçim
https://wa.me/<number>, nerede <number> uluslararası formatta tam bir telefon numarasındır. WhatsApp Yardım Merkezi, tüm sıfırları, parantezleri veya tireleri çıkarmanız gerektiğini belirtmektedir.Kullanım: https://wa.me/1XXXXXXXXXX
Kullanmayın: https://wa.me/+001-(XXX)XXXXXXX Nelerin saklanacağı
Ülke kodu artı abone numarası, yalnızca rakamlar. Başında olmasın
+. Neyin soyulması gerekiyor
Baştaki sıfırlar, boşluklar, tireler, parantezler. Hiçbiri yolda yer almaz.
Karşılaştırma
wa.me ve api.whatsapp.com/send arasındaki fark nedir?
İkisi de aynı sohbeti açar.
wa.me/ kısa biçim, yoldaki numara ile birlikte WhatsApp Yardım Merkezi'nde belgelenmiştir. api.whatsapp.com/send?phone= numarayı bir sorgu parametresi olarak taşıyan uzun biçimi hâlâ yaygın olarak kullanılmaktadır.URL anatomisi, segment segment
https://wa.me/1XXXXXXXXXXMerhaba
https://api.whatsapp.comGönder?phone=1XXXXXXXXXXMerhaba
Ev sahibi
Sabit yol
Sayı
Mesaj
Kriter
wa.me
api.whatsapp.com/send
Numaranın yaşadığı yer
wa.meURL yolunda
api.whatsapp.comİçinde
telefon sorgu parametresiWhatsApp Yardım Merkezi'nde belgelenmiştir
wa.meEvet, tam olarak bu formatta
api.whatsapp.comMevcut yardım sayfasında bulamadık
Gözlemlenen davranış
wa.meSohbeti açar
api.whatsapp.comAynı sohbeti açar
Bir kaldırma (kullanımdan kaldırma) değil, bir belgelendirme eksikliği. Bunu belgeleyen güncel, resmi bir WhatsApp veya Meta sayfası bulamadık
api.whatsapp.com/send. Bu, çalışmayı durdurduğu anlamına gelmez: her iki format da bugün aynı sohbete yönlendirir. Bu, WhatsApp'ın kendi Yardım Merkezi'nin yalnızca şunu kapsadığı anlamına gelir: wa.me. Belgelenen biçimde yeni bağlantılar kurun.Metin parametresi
WhatsApp bağlantısına önceden doldurulmuş bir mesajı nasıl eklersiniz?
Ekle
?metin= ardından URL kodlu mesaj gelir: https://wa.me/<number>?text=<urlencodedtext>. Metin, sohbet metin giriş alanına önceden doldurulmuş ve düzenlenebilir olarak düşer.https://wa.me/1XXXXXXXXXX?text=Satılık arabanızla ilgileniyorum// numara yoksa: bunun yerine bir kişi seçici açarhttps://wa.me/?text=I'minquiringabouttheapartmentlisting Numara olmadan, WhatsApp belirli bir sohbet yerine gönderenin kişi listesini açar.
Kodlama, belirli eşlemeler text Bir kişi seçildikten sonra hâlâ önceden dolduruluyor. Karakter
Uzay
Yeni satır
&
#
Kodlanmış
%20
%0A
%26
%23
Şunu da bilmekte fayda var:
Bağlantıyı kodla oluştur + kodlaruna çevirir %2B. Diğer her şey için, emojiler dahil, tablonu kendin oluşturma: çağır encodeURIComponent() JavaScript'te veya urllib.parse.quote() Python'da. // JavaScriptconst number = "1XXXXXXXXXX";
const text = "Hi! I have a question.";
const link = `https://wa.me/${number}?text=${encodeURIComponent(text)}`;# Pythonfrom urllib.parse import quote
number, text = "1XXXXXXXXXX", "Merhaba! Bir sorum var."
link = f"https://wa.me/{number}?text={quote(text)}"Ücretsiz araç
WhatsApp bağlantınızı oluşturun
Bir sayı ve bir mesaj girin. Alın wa.me bağlantı api.whatsapp.com eşdeğer, kodlanmış metin, bir HTML kod parçacığı ve resmi düğüm, hepsi aynı anda.
Tamamen tarayıcınızda çalışır. Hiçbir numara asla bir sunucuya gönderilmez.
Tam uluslararası numara. +, 0, boşluk veya tire yok.
İsteğe bağlı. Sohbet giriş alanına düşer, gönderen tarafından hâlâ düzenlenebilir.
wa.me bağlantısı
https://wa.me/15550123456?text=Hi!%20I%20have%20a%20question%20about%20your%20product.
t.me
https://api.whatsapp.com/send?phone=15550123456&text=Hi!%20I%20have%20a%20question%20about%20your%20product.
metin parametresi, kodlanmış
Merhaba! 20Ürününüzle ilgili bir sorum var.
Yapıştırılmaya hazır HTML kod parçacığı
<a href="https://wa.me/15550123456?text=Hi!%20I%20have%20a%20question%20about%20your%20product." target="_blank" rel="noopener" aria-label="WhatsApp'ta sohbet et">WhatsApp'ta sohbet et</a>
Resmi "WhatsApp'ta Sohbet Et" düğmesi
WhatsApp'ta sohbet et <a href="https://wa.me/15550123456?text=Hi!%20I%20have%20a%20question%20about%20your%20product." target="_blank" rel="noopener"><img src="whatsapp-icon.svg" alt=""> WhatsApp'ta sohbet et</a>
Bu bağlantı bir sohbet açar. Mesajı göndermez ve ürününüz yanıtı görmez.
Bir WhatsApp bağlantısı mesajı gönderir mi?
Hayır. Bir sohbet et bağlantısı, sohbeti açar ve metin alanını önceden doldurur. Telefonu tutan kişi gönder düğmesine basana kadar hiçbir şey iletilmez.
Dürüst olan kısım
Bir WhatsApp bağlantısı ne yapamaz?
Sohbet başlatma bağlantısı durumsuzdur. Ürününüz, bağlantının tıklandığını, mesajın gönderildiğini veya alıcının yanıt verip vermediğini asla öğrenmez.
Bağlantının durduğu yer
Bağlantıya tıklandı
Sohbet açılıyor
Mesaj önceden doldurulmuş
Manuel gönderim
BağlantıduraklarBurada
Yanıt alındı
Sohbet geçmişi
Webhook olayı
Kullanıcı bazlı atıf
Teslim veya okundu bilgisi yok
Uygulamanıza geri yönlendirilen yanıt yok
Konuşma geçmişi yok
Ek yok
Sunucu tarafında tetikleyici yok. Bir insan ve bir tık gerektiriyor
Çok kiracılı (multi-tenant) bir üründe kullanıcı bazında atıf (attribution) yok
Numaranın aktif bir WhatsApp hesabı yoksa sessiz hata oluşur
Masaüstü, WhatsApp Web ve mobil cihazlarda farklı davranış
Grup oluşturma veya yönetimi yok. Bir bağlantı yalnızca bire bir sohbet açar, şuraya bakın: WhatsApp Grup API'si her tür grup ile ilgili sınırlar
Bir bağlantı tıklamaları, yanıtları veya geçmişi raporlayamaz. Bir API bunu yapabilir. Gerçek bir WhatsApp entegrasyonu oluşturun
Bağlantıyı yapıştır
Yanıtı uygulamanıza nasıl geri alırsınız?
WhatsApp oturumu tutan bir API'ye ihtiyacınız var. İki rota mevcuttur: Meta'nın Bulut API'si, doğrulanmış bir İşletme hesabı gerektirir veya bağlı hesap API'si Unipile gibi, son kullanıcının kimliği doğrulanmış kullanıcı adına kendi WhatsApp hesabını QR kod veya eşleştirme koduyla bağladığı durumlar.
Meta Bulut API'siDoğrulanmış işletme
Doğrulanmış bir WhatsApp Business hesabı gerektirir
1 Temmuz 2025'ten itibaren mesaj başına ücretlendirilir, bkz. WhatsApp Business API fiyatlandırması arıza
24 saatlik müşteri hizmetleri penceresi hala varlığını sürdürüyor, neyin faturalandırılacağını değil, neyin ücretsiz olacağını belirler
Ölçeklenebilir şablonlu bildirimler için tasarlandı
Bağlı hesap, UnipileDoğrulama yok
Her son kullanıcı, kimliği doğrulanmış kullanıcı adına kendi WhatsApp hesabını bağlar
QR kod veya eşleştirme kodu ile, Meta İşletme doğrulaması yok
Yanıtlar dahil olmak üzere, gerçek bağlı gelen kutusundan okur ve gönderir
LinkedIn, Instagram, Telegram, Gmail, Outlook ve IMAP ile aynı bağlantı, gönderme, listeleme, dinleme örüntüsü
// 1. Kimliği doğrulanmış kullanıcı adına hesabı bağlayın
const { qrCodeString } = bekliyor müşteri.hesap.WhatsApp'ı Bağla();// 2. Bağlandıktan sonra bir mesaj gönder
POST /api/v1/chats/{chat_id}/messages{ "metin": "Merhaba! Siparişiniz kargoya verildi." }// 3. Webhook üzerinden yanıtları alın, yoklama (polling) yok{ "olay": "mesaj_alındı", "sohbet_kimliği": "chat_182...", "mesaj": "Bu hâlâ satılık mı?"}Eksiksiz gönderim kılavuzu, yükler ve webhook yönetimi için bkz. API üzerinden WhatsApp mesajları nasıl gönderilir. Uç nokta referansı: developer.unipile.com/docs/whatsapp.
Karar
Link, Cloud API veya bağlı hesap: hangisine ihtiyacınız var?
Kontrol ettiğiniz bir sayfadan bir insan sohbet başlattığında bir bağlantı kullanın. Doğrulanmış bir işletme, şablona dayalı bildirimleri büyük ölçekte gönderdiğinde Cloud API'yi kullanın. Ürününüz, kullanıcının kendi WhatsApp gelen kutusundan okuma ve gönderme yapmak zorunda olduğunda bağlı hesap API'sini (connected-account API) kullanın.
Kriter
Bağlantı
Meta Bulut API'si
Bağlı hesap
Kim başlatır
BağlantıKontrol ettiğiniz bir sayfadan bir insan
Bulut API'siİşletmeniz ilk olarak gönderir, şablonlu
Bağlı hesapHer iki taraf, bağlantılı gelen kutusundan
Yetkilendirme gerekli
BağlantıHiçbiri
Bulut API'siOnaylı Meta İşletme hesabı
Bağlı hesapQR kod veya eşleştirme kodu, İşletme doğrulaması yok
Maliyet
BağlantıÜcretsiz
Bulut API'siMesaj başına, 1 Temmuz 2025'ten beri
Bağlı hesapUnipile plan fiyatlandırması, mesaj başına ücretlendirilmez
Yanıtlar alır
BağlantıHayır
Bulut API'siEvet, webhook aracılığıyla
Bağlı hesapEvet, webhook aracılığıyla
Sohbet geçmişi
BağlantıHayır
Bulut API'siEvet
Bağlı hesapEvet
Çok kiracılı ürünler
BağlantıKesilmeler, sabit kodlanmış bir sayı
Bulut API'siİşletme numarasına göre özel yönlendirme gerektirir
Bağlı hesapYerel, son kullanıcı başına bir bağlı hesap
Kurulum süresi
BağlantıDakika
Bulut API'siGünlerden haftalara, İşletme doğrulaması
Bağlı hesapDakikadan saate
Sadece bir bağlantı gerekiyor
Kullanın yukarıdaki jeneratör. Hesap yok, kurulum yok.
Şablonlu bildirimler gönderme
Şuna bak WhatsApp Cloud API entegrasyonu rehber.
Kullanıcıya göre okunuyor ve gönderiliyor
Başlat Eksiksiz WhatsApp API kılavuzu.
Çoğu ürün bir hafta içinde bağlantının boyutunu aşar. Aslında varacağınız yerden başlayın. İnşa etmeye başla
Uygulama
Bir ürüne WhatsApp bağlantısı nasıl eklenir?
Bağlantıyı sunucu tarafında, her kullanıcı için ayrı ayrı oluşturun ve çok kiracılı (multi-tenant) bir üründe asla sabit bir telefon numarası kodlamayın. Bağlantı yalnızca bir bağlantı etiketidir (anchor), bu nedenle API katmanınızda değil, şablon katmanınızda yer almalıdır.
<a bağlantı="https://wa.me/{{ user.whatsapp_number }}?text={{ prefilled_text | url_encode }}"
hedef="_blank" Gerçekten mi="noopener"
aria-label="WhatsApp'ta Sohbet Et"WhatsApp'ta Sohbet Eta>Resmi düğme
WhatsApp, değişiklik yapılmadan kullanılmak üzere tasarlanmış, yeşil ve beyaz renklerde, birkaç sabit boyutta kullanıma hazır bir "WhatsApp'ta Sohbet Et" rozeti yayınlar.
WhatsApp'ta sohbet et QR kod
URL kabul eden herhangi bir QR kod üreteci şunu dönüştürür:
wa.me bir bağlantıyı baskı, ambalaj veya fiziksel tabelalar için taranabilir bir koda dönüştürün. Mobil Sohbet ve önceden doldurulmuş metin hazır olacak şekilde doğrudan WhatsApp uygulamasını açar.
Masaüstü, yüklü uygulama Tarayıcı yerine WhatsApp masaüstü uygulamasını açar.
Masaüstü, uygulama yok Tarayıcıda WhatsApp Web'i açar ve oturum halihazırda açık değilse QR ile oturum açma isteminde bulunur.
Çok kiracılı ürünlerde bağlantıların neden koptuğu: Tek bir sabit kodlanmış numara, müşterilerinizi birbirinden ayırt edemez. Bağlantıyı her seferinde belirli kullanıcı veya çalışma alanı kaydından oluşturun; böylece bir şablona bir kez yapıştırılmış bir numarayı değil, o kullanıcının gerçekten sahip olduğu numarayı taşır.
Sorun giderme
WhatsApp bağlantım neden çalışmıyor?
En yaygın iki neden, telefon numarasının düz uluslararası biçimde olmaması ve bir
text URL kodlaması yapılmamış parametre.SebepTelefon numarası düz uluslararası formatta değil
DüzeltUluslararası tam numarayı kullanın, yalnızca rakamlar: no
+, önde gelen yok 0, boşluk, tire veya parantez yok.SebepMetin parametresi URL kodlu değildi
DüzeltMesajı çalıştır
encodeURIComponent() JavaScript'te veya urllib.parse.quote() Python'da eklemeden önce.SebepBu numaranın aktif bir WhatsApp hesabı yok
DüzeltBağlantı hâlâ açılıyor, ancak sohbet sessizce başarısız oluyor. Önce numaranın gerçekten WhatsApp'a kayıtlı olup olmadığını doğrulayın.
SebepÜçüncü taraf bir uygulamanın uygulama içi tarayıcısında açıldı
DüzeltSosyal medya veya reklam platformlarındaki uygulama içi tarayıcılar bazen yönlendirmeyi engeller veya hatalı işler. Bağlantıyı bunun yerine sistem tarayıcısında açın.
SebepBir bağlantı ön izleme tarayıcısı URL'yi yeniden yazdı
DüzeltBazı platformlar giden bağlantıları kendi yönlendirmeleriyle sarmalar; bu da sorgu dizesini silebilir. Ham olanı test edin
wa.me Doğrudan URL.WhatsApp Bağlantı API'si - SSS
Geliştiricilerin wa.me, api.whatsapp.com, text parametresi ve bağlantının nerede bittiği hakkında sorduğu her şey.
Tek bir WhatsApp bağlantı API'si yoktur. wa.me ve api.whatsapp.com/send tıkla-sohbet et URL'leridir: bunlardan birini açmak, kimlik doğrulama, geliştirici hesabı veya kod gerektirmeden WhatsApp'ta bir sohbet başlatır. WhatsApp'ın kendi API'leri ise, bir kişinin yanıt vermesi gerektiğinde, tam olarak bağlantının bittiği yerden başlayan ayrı bir katmandır.
Belgelenen biçim https://wa.me/<number>, nerede <number> tam telefon numarası uluslararası biçimdedir. WhatsApp Yardım Merkezi, örneğin baştaki sıfırların, parantezlerin, boşlukların veya tirelerin atılmasını talep eder https://wa.me/1XXXXXXXXXX.
İkisi de aynı sohbeti açar. wa.me/ kısa biçim, URL yolunda numara ile birlikte WhatsApp Yardım Merkezi'nde belgelenmiş mi?. api.whatsapp.com/send?phone= numarayı bir sorgu parametresi olarak taşıyan uzun form, hala yaygın olarak kullanılmaktadır.
Hayır. Sohbet aç bağlantısı sohbeti başlatır ve metin alanını önceden doldurabilir, ancak telefonu tutan kişi gönder tuşuna basana kadar hiçbir şey iletilmez.
Evet. Ekle ?metin= ardından URL kodlu bir mesaj gelir, örneğin https://wa.me/1XXXXXXXXXX?text=Hi%2C%20I%20have%20a%20question. Metin, gönderilmeden önce önceden doldurulmuş ve hâlâ düzenlenebilir durumda sohbet giriş alanına düşer. Şurada deneyin: yukarıdaki jeneratör.
En yaygın iki neden, düz uluslararası biçimde olmayan bir telefon numarası ve bir text URL kodlaması yapılmamış parametre. Ayrıca numaranın aktif bir WhatsApp hesabına sahip olduğunu ve bağlantının üçüncü taraf bir uygulamanın uygulama içi tarayıcısında açılmadığını kontrol edin.
Hayır. A wa.me veya api.whatsapp.com/send bu bağlantı İşletme hesabı, doğrulama ve API erişimi gerektirmez. WhatsApp İşletme Platformu veya Bulut API'si, toplu olarak şablon bildirimleri göndermesi veya programatik olarak yanıtlar alması gereken işletmeler için ayrı doğrulanmış bir üründür. Bkz. Eksiksiz WhatsApp API kılavuzu.
Bir bağlantının kendisi, yanıtları uygulamanıza geri bildiremez; durumsuzdur. Gerçek gelen kutusundan okuma yapmak ve mesaj göndermek için bir WhatsApp oturumu barındıran bir API'ye ihtiyacınız vardır: Ya doğrulanmış bir İşletme hesabına sahip Meta'nın Bulut API'si (Cloud API) ya da her son kullanıcının kimliği doğrulanmış kullanıcı adına kendi WhatsApp hesabını QR kod veya eşleştirme koduyla bağladığı Unipile gibi bağlantılı hesap API'si. Bkz. API üzerinden WhatsApp mesajları nasıl gönderilir.
Hâlâ bir bağlantıya mı yoksa bir API'ye mi ihtiyacınız olduğundan emin değil misiniz? Ekibimiz karar vermenize yardımcı olabilir.
TR 
EN 
FR 
ES 
DE 
IT 
BR 
NL 
PL