Wow! Emoji of happy man Geliştiriciler için tam özellikli bir sandbox — tamamen ücretsiz! Şimdi Kaydol
Geliştirici dokümanları · HTTP API

WhatsApp API Dokümantasyonu

Basit HTTP istekleri kullanarak WhatsApp mesajları gönderip almak, grupları otomatikleştirmek ve entegrasyonlar oluşturmak için ihtiyacınız olan her şey.
API; mesajları, medyayı, dosyaları, durumları, grupları, toplulukları ve kanalları destekler. Gelen sohbetleri alabilir, ürün gönderebilir, siparişleri işleyebilir, numaraları doğrulayabilir ve özel otomasyonlar oluşturabilirsiniz.

API token’ı alın ve başlayın API referansını inceleyin
Dakikalar içinde WhatsApp mesajları göndermeye başlayın

3 basit adımda başlayın

Icon

Hesap oluşturun ve bir numara eşleştirin

Bir Whapi.Cloud hesabı oluşturun ve WhatsApp numaranızı QR kod ile bağlayın.

Icon

API token’ınızı alın

Kontrol panelinden API token’ınızı kopyalayın ve isteklerinizi yetkilendirin.

Icon

İlk mesajınızı gönderin

İlk API çağrınızı yapın ve mesajları webhook’lar üzerinden alın.

Hesap oluşturun ve API token’ı alın Başlangıç rehberini okuyun
Geliştirici odaklı deneyim

API’yi favori araçlarınızla test edin

Bir API token’ınız olduğunda, Swagger veya Postman kullanarak tüm uç noktaları keşfedebilir ve test edebilirsiniz. API token’ını Bearer yetkilendirme başlığı olarak kullanın.

Swagger’da deneyin

/

API’yi <span>favori araçlarınızla</span> test edin
API’yi <span>favori araçlarınızla</span> test edin
Decorartive bubble
<span>GitHub</span> üzerindeki hazır projelerle <span>daha hızlı</span> başlayın
Açık kaynak örnekler

GitHub üzerindeki hazır projelerle daha hızlı başlayın

Whapi.Cloud API üzerine inşa edilmiş gerçek dünya örneklerini ve başlangıç projelerini keşfedin. GitHub depolarımız; çalışan botlar, yardımcı araçlar ve çoklu dillerde otomasyon betikleri içerir — API’yi daha hızlı anlamanıza ve güvenle yayına almanıza yardımcı olmak için tasarlanmıştır.

  • Node.js WhatsApp botu: JavaScript kullanarak botlar ve otomasyonlar oluşturmak için üretime hazır bir örnek.
  • PHP botları (2 seviye): Yeni başlayanlar için uygun örnek (minimal kurulum, net yapı) ve gelişmiş bot — daha zengin mantık, mesaj işleme, gruplar ve webhook’lar.
  • Python botları (2 seviye): Hızlı denemeler için basit bir başlangıç botu ve genişletilmiş özellikler ile olay işleme sunan gelişmiş bir uygulama.
  • Java botu: Hızlı geliştirme başlangıcı için basit ve anlaşılır bir chatbot uygulaması.
  • WhatsApp Numara Kontrol Aracı: Güvenli hızlandırma ve gruplama ile WhatsApp numara kullanılabilirliğini kontrol etmeye yönelik pratik bir örnek.
GitHub depolarını görüntüleyin
Decorartive bubble
Yaygın operasyonel sorular

Sıkça sorulan sorular

Whapi.Cloud, WhatsApp’a bağlı cihaz (linked-device) oturumu kullanarak bağlanır. WhatsApp hesabınız, WhatsApp Web’e benzer şekilde QR kod veya eşleştirme kodu aracılığıyla bir kanala bağlanır; ancak bağlantı backend socket’leri üzerinden sürekli olarak korunur. API, mesajlar, durumlar ve grup güncellemeleri gibi olayları gerçek zamanlı olarak gönderip alan güvenli bir geçit görevi görür ve bunları HTTP uç noktaları ile webhook’lar üzerinden sunar.
Hayır. Numara bağlandıktan sonra telefonunuzun sürekli çevrimiçi kalması gerekmez. Ancak WhatsApp, bağlı oturumun geçerli kalması için zaman zaman ana cihazda etkinlik gerektirebilir. Pratikte, WhatsApp’ı telefonda birkaç haftada bir açmak genellikle yeterlidir.
Evet. API bağlıyken WhatsApp’ı hem telefonunuzda hem de WhatsApp Web’de normal şekilde kullanmaya devam edebilirsiniz. API, ek bir bağlı cihaz olarak paralel çalışır ve mevcut kullanımınızı engellemez veya onun yerini almaz.
Bazı durumlarda WhatsApp, bağlı cihaz oturumlarını otomatik olarak geçersiz kılabilir. Bu durumda kanalın, yeni bir QR kodu tarayarak veya bir eşleştirme kodu kullanarak yeniden yetkilendirilmesi gerekir. Hiçbir veri kaybolmaz ve yeniden bağlandıktan sonra API normal çalışmasına hemen devam eder.
Evet. API’nin kendisi ücretli planlarda katı gönderim limitleri uygulamasa da WhatsApp hesap davranışlarını aktif olarak izler. Güvenli kullanım, API’den ziyade mesajların nasıl gönderildiğine bağlıdır. Kademeli ısındırma, makul gönderim hızı, ilgili içerik ve alıcı etkileşimi kritik öneme sahiptir. Aşırı veya doğal olmayan gönderim kalıpları, kullanılan araçtan bağımsız olarak kısıtlamalara yol açabilir. Bu nedenle üretim iş akışlarında her zaman gecikmeler, gruplama ve temel hız kontrolü uygulanmalıdır.
Webhook’lar, ilgili olaylar gerçekleştiğinde Whapi.Cloud tarafından sunucunuza gönderilen gerçek zamanlı HTTP geri çağrılarıdır. Mesajlar alındığında, teslim veya okundu durumları değiştiğinde, grup veya kanal olayları gerçekleştiğinde ya da diğer WhatsApp güncellemeleri algılandığında tetiklenirler. Bu yapı, API’yi sürekli sorgulamaya gerek kalmadan sisteminizin anında tepki vermesini sağlar ve webhook’ları olay tabanlı otomasyonlar ve botlar oluşturmak için temel mekanizma haline getirir.
Evet. API; sohbet botları, bildirim servisleri, CRM entegrasyonları ve izleme sistemleri gibi sürekli çalışan ve uzun süreli iş akışlarını destekleyecek şekilde tasarlanmıştır. Bir numara bağlanıp doğru şekilde yetkilendirildiğinde, WhatsApp bağlı cihaz oturumunu sıfırlamadığı sürece API süresiz olarak çalışabilir. Üretim ortamlarında stabil ve kesintisiz kullanım için ücretli bir plan önerilir.
API’yi kullanmak tek başına engellenme riskini otomatik olarak artırmaz. Kısıtlamalar esas olarak WhatsApp hesabının nasıl kullanıldığıyla ilgilidir. Spam benzeri gönderim davranışları, zayıf numara itibarı, düşük alıcı etkileşimi veya olumsuz geri bildirimler, API kullanılsa da kullanılmasa da kısıtlamalara yol açabilir. Kademeli ısındırma, kontrollü gönderim hızı ve anlamlı içerik gibi önerilen uygulamalara uymak riski önemli ölçüde azaltır.
Whapi.Cloud mesaj içeriklerinizi kalıcı olarak saklamaz. Mesajlar; iletim, webhook tetikleme ve teslimat olaylarının oluşturulması için gerçek zamanlı olarak işlenir. Bir kanal aktifken, mesaj verileri yalnızca işleme, yönlendirme ve olay yönetimi amacıyla kısa süreli teknik önbelleklerde geçici olarak tutulabilir. Bir kanal bağlantısı kesildiğinde veya pasif hale geldiğinde, Whapi.Cloud tarafında hiçbir mesaj içeriği saklanmaz. API, bir mesaj depolama sistemi veya arşiv olarak tasarlanmamıştır. Uzun vadeli depolama, analiz veya mesaj geçmişi ihtiyaçları, webhook’lar ve API yanıtları kullanılarak kendi altyapınızda uygulanmalıdır.

WhatsApp REST API uç noktaları

GET sorgularındaki parametreler query string üzerinden iletilir. POST isteklerindeki parametreler ise JSON kodlu istek gövdesi aracılığıyla gönderilir. Token’ı Bearer yetkilendirme başlığı olarak kullanın. WhatsApp API için token alın!