Başlarken
WbizTool API'ye başlarken
WbizTool REST API, yazılımınızın bağlı WhatsApp numaranızdan WhatsApp mesajları göndermesini sağlar. Uygulamanızdan, CRM'inizden, web sitenizden veya otomasyon aracınızdan sipariş güncellemeleri, hatırlatmalar ve uyarılar göndermek için kullanın.
Bu sayfa her isteğin neye ihtiyaç duyduğunu anlatır. İlk mesajınızı göndermek için doğrudan Mesaj gönderme sayfasına geçin.
Temel URL#
Tüm endpoint'ler şu adresin altındadır:
https://wbiztool.com/api/v1/
Çoğu endpoint POST isteklerini kabul eder. Gövdeyi JSON (application/json) veya form alanları (application/x-www-form-urlencoded) olarak gönderebilirsiniz. Dosya yüklemek için multipart/form-data kullanın. Birkaç okuma endpoint'i GET kullanır; her endpoint'in sayfasında yöntemi belirtilir.
Başlamadan önce#
- Bir hesap oluşturun: wbiztool.com/signup adresinden kaydolun. Yeni hesaplarda 50 ücretsiz mesaj bulunur.
- Bir WhatsApp numarası bağlayın. WhatsApp numaraları sayfasını açın, Numara ekle'ye tıklayın ve telefonunuzdaki WhatsApp ile QR kodunu tarayın.
- Bir API anahtarı oluşturun. Ayarlar → API anahtarları sayfasına gidin. Anahtarları yalnızca çalışma alanının sahibi oluşturabilir. Her çalışma alanında en fazla 10 anahtar olabilir.
Kimlik doğrulama#
API anahtarınızı her istekte bir Authorization: Bearer başlığında gönderin (önerilir). Anahtar kendi çalışma alanını belirlediği için bu durumda client_id gerekmez. Gövdedeki kimlik bilgileri (JSON veya form alanları olarak client_id ve api_key) her endpoint'te çalışmaya devam eder. İkisi birden gönderilirse başlıktaki geçerli anahtar kullanılır. Bkz. Anahtarı başlıkta gönderin.
Authorization: Bearer YOUR_API_KEY
api_keystringzorunluAyarlar → API anahtarları sayfasındaki API anahtarlarınızdan biri;
Authorization: Bearerbaşlığında veya gövdede. Gizli tutun: anahtara sahip olan herkes numaralarınızdan mesaj gönderebilir.client_idintegerYalnızca anahtar gövdedeyseAPI Client ID'niz; aynı sayfada gösterilir.
whatsapp_clientintegerÇoğu mesajlaşma endpoint'indeGönderimin yapılacağı WhatsApp numarasının ID'si; WhatsApp numaraları sayfasında numaranın kartında ID … ⧉ olarak gösterilir (kopyalamak için üzerine tıklayın). Her endpoint sayfası bunun gerekip gerekmediğini belirtir.
API anahtarı, isteğin hangi çalışma alanında işlem yapacağını belirler. Birden fazla çalışma alanına üyeyseniz, göndermek istediğiniz çalışma alanında oluşturulmuş bir anahtar kullanın.
Bir anahtar sızarsa, API anahtarları sayfasında silin. Silinen anahtarlar hemen çalışmayı durdurur.
İlk isteğiniz#
Bu istek, bağlı numaranızdan bir metin mesajı gönderir. ID'leri, anahtarı ve telefon numarasını kendi değerlerinizle değiştirin.
curl -X POST https://wbiztool.com/api/v1/send_msg/ \
-H "Content-Type: application/json" \
-d '{
"client_id": 12345,
"api_key": "YOUR_API_KEY",
"whatsapp_client": 678,
"msg_type": 0,
"country_code": "91",
"phone": "9876543210",
"msg": "Hi Aman, your order #4821 has shipped and will arrive on Thursday."
}'
msg_id içeren bir "status": 1 yanıtı, mesajın kuyruğa alındığı anlamına gelir. Mesaj gönderme sayfası her parametreyi açıklar ve Python, Node.js ve PHP örnekleri içerir.
Yanıtlar ve hatalar#
Her yanıt, status alanı olan bir JSON nesnesidir ("status": 200 döndüren /api/v1/status/ sağlık kontrolü hariç):
"status": 1isteğin başarılı olduğu anlamına gelir."status": 0isteğin başarısız olduğu anlamına gelir.messagealanı nedenini açıklar.
{ "status": 0, "message": "Auth Error: invalid api key" }
Sık görülen kimlik doğrulama hataları:
| Mesaj | Anlamı |
|---|---|
Auth Error | client_id veya api_key eksik, gövde geçerli JSON veya form verisi değil ya da istek POST değil. |
Auth Error - Please send correct API key and Client id | api_key eksik veya boş. |
Invalid client id. veya Invalid Client Id | client_id bir tam sayı değil (veya bazı endpoint'lerde eksik). Sayı olarak gönderin, örneğin 12345. |
Auth Error: invalid api key | Anahtar mevcut değil, silinmiş veya bu client_id değerine ait değil. |
Demo Account can not access apis | Demo hesaplar API'yi kullanamaz. |
Not enough credits | Çalışma alanı ücretsiz planda ve mesajı kalmadı: ücretli planlar sınırsız mesaj gönderir. Bkz. Mesajlarınız bittiğinde. |
Daily limit reached: … (HTTP 429, "code": "daily_limit_reached") | WhatsApp numarası son 24 saatte 1.000 mesaj aldı (adil kullanım). Kalanını daha sonra veya başka bir numaradan gönderin. |
Mesaj yaşam döngüsü#
API üzerinden gönderdiğiniz mesajlar önce kuyruğa alınır, ardından WhatsApp numaranızdan gönderilir. Her mesaj şu durumlardan birine sahiptir:
| Durum | Ad | Anlamı |
|---|---|---|
0 | Created (Oluşturuldu) | Kuyrukta, gönderilmeyi bekliyor. |
1 | Sent (Gönderildi) | WhatsApp numaranızdan gönderildi. |
2 | Failed (Başarısız) | Gönderilemedi; örneğin numara WhatsApp'ta olmadığı için. |
3 | Cancelled (İptal edildi) | Gönderilmeden önce iptal edildi. |
4 | Expired (Süresi doldu) | expire_after_seconds süresi dolmadan gönderilemedi. |
Kuyruktaki mesajların gönderilebilmesi için WhatsApp numaranızın bağlı kalması gerekir. Gönderim yaptığınız numaranın bağlantısı kesilirse, mesajları numara yeniden bağlanana veya süreleri dolana kadar kuyrukta bekler. Bağlantısı kesik bir numaradaki gönderilmemiş mesajlar 90 gün sonra silinir.
Bir mesajı takip etmek için yanıttaki msg_id değerini kaydedin ve ya gönderirken bir webhook URL'si iletin ya da Mesaj durumu endpoint'ini çağırın.
Resmi istemci kütüphaneleri#
Python ve Node.js sarmalayıcıları kimlik doğrulama ve dosya yüklemeyi sizin için halleder. Henüz her endpoint'i doğru şekilde desteklemiyorlar; bu yüzden bir istemci yöntemine güvenmeden önce ilgili endpoint sayfasını kontrol edin.
pip install wbiztool-clientnpm install wbiztool-client- Python: PyPI'da wbiztool-client
- Node.js: npm'de wbiztool-client
Kodsuz bir kurulum mu tercih edersiniz? Zapier, n8n, Make, Pabbly Connect, Google Sheets, Shopify ve WordPress için Uygulamalar ve entegrasyonlar sayfasına bakın.
Belgelere göz atın#
- Ürün rehberleri: numara bağlamaktan kampanyalara, hatırlatıcılara ve Unibox'a kadar WbizTool panelini kullanın.
- Mesajlaşma API'si: mesaj gönderin, zamanlayın, iptal edin ve takip edin.
- WhatsApp hesapları API'si: numara bağlayın ve durumlarını kontrol edin.
- Numara doğrulama API'si: hangi numaraların WhatsApp'ta olduğunu toplu olarak kontrol edin.
- Hatırlatıcılar API'si: tekrarlanan hatırlatıcılar oluşturun, listeleyin ve iptal edin.
- Medya API'si: dosya yükleyin, ardından listeleyin veya getirin.
- Entegrasyonlar: kodsuz ve eklenti tabanlı kurulumlar.

