Ürün kılavuzları
API anahtarları ve Client ID
API anahtarı, kendi yazılımınızın ve Zapier, n8n, Make ile WordPress eklentisi gibi araçların çalışma alanınızın numaralarından WhatsApp mesajı göndermesini sağlar. Kendi kodunuz anahtarı bir Authorization: Bearer başlığında gönderir; entegrasyonlar ise API anahtarları sayfasındaki iki değeri ister: çalışma alanınızın Client ID'si ve anahtarlarından biri. Aynı sayfada webhook'larımızı imzalayan gizli anahtar da bulunur.
Kimler yapabilir: yalnızca Sahipler – yalnızca çalışma alanını oluşturan kişi değil, çalışma alanının tüm Sahipleri. Sahipler, kimin oluşturduğundan bağımsız olarak çalışma alanının tüm anahtarlarını görür, oluşturur, kopyalar ve siler. Editörler ve Analistler API anahtarları'nı kenar çubuğunda veya Ayarlar sayfasında görmez; bu sayfaya giden bir bağlantı onlar için Profil'i açar (bkz. Roller ve izinler). Anahtarlar ücretsiz deneme dahil her planda çalışır; onlarla gönderdikleriniz çalışma alanının mesajlarını kullanır.
Kenar çubuğunda Entegrasyonlar altındaki API anahtarları'nı açın veya Ayarlar → API anahtarları sayfasına gidin.
Her anahtar adını, Oluşturulma tarihini, anahtarın son dört karakterini (örneğin •••• 7f3a), Anahtarı kopyala ve Sil düğmelerini gösterir. En yeni anahtar en üsttedir.
API anahtarı oluşturun#
Anahtar oluştur'a tıklayın
Ayarlar → API anahtarları sayfasında kartın sağ üstündeki Anahtar oluştur'a tıklayın.
Ad verin (isteğe bağlı)
Ad (isteğe bağlı) altına anahtarı kullanacak uygulamayı yazın, örneğin
n8nveyaWebsite(en fazla 50 karakter). Boş bırakılırsa, alanın altındaki ipucunda belirtildiği gibi "API Key 3" gibi bir ad alır.Oluşturun
Anahtarı kopyalayın
Yeni API anahtarınız penceresi anahtarın tamamını gösterir: "Şimdi kopyalayın – anahtarın tamamını bir daha göremezsiniz. Daha sonra “Anahtarı kopyala” onu göstermeden kopyalar." Kopyala'ya tıklayın ("Anahtar kopyalandı."), anahtarı uygulamanıza veya entegrasyonunuza yapıştırın, ardından Tamam'a tıklayın.

- Çalışma alanı başına en fazla 10 anahtar. 10 anahtar olduğunda Anahtar oluştur gri görünür ve üzerine geldiğinizde "En fazla 10 API anahtarınız olabilir. Yenisini oluşturmak için birini silin." mesajı çıkar.
- Anahtarların süresi dolmaz; yeniden adlandırılamaz veya kapatılamazlar: bir anahtar silinene kadar çalışır.
- Her uygulama için bir anahtar. Her anahtara onu kullanan uygulamanın adını verin; böylece diğerlerini bozmadan birini değiştirebilir veya silebilirsiniz.
- Hangi çalışma alanı: bir anahtar, onu oluşturduğunuzda seçili olan çalışma alanına aittir ve onunla yapılan her istek o çalışma alanı üzerinde işlem yapar: numaraları, mesajları ve planı. Başka bir çalışma alanından göndermek için o çalışma alanına geçin ve orada bir anahtar oluşturun.
Uygulamanıza ne girmelisiniz#
| API alanı | Entegrasyonlardaki adı | Nerede bulunur |
|---|---|---|
client_id | Client ID | API anahtarları kartının üstündeki Client ID satırı. Yanındaki Kopyala onu kopyalar ("Client ID kopyalandı."). Çalışma alanındaki her anahtar için aynıdır. |
api_key | API key | Kopyaladığınız anahtar: rakamlardan ve a ile f arası harflerden oluşan 40 karakter. |
whatsapp_client | WhatsApp Client ID | Numaranın ID'si, örneğin WhatsApp numaraları sayfasında numaranın kartındaki ID 101 ⧉: kopyalamak için üzerine tıklayın ya da tüm numaraları WhatsApp hesapları API'si ile listeleyin. Mesajı hangi numaranın göndereceğini belirler. Bkz. WhatsApp numaraları sayfası. |
Nereye girilirler:
- Kendi kodunuz: her istekte bir
Authorization: Bearer YOUR_API_KEYbaşlığında (önerilir). Anahtar kendi çalışma alanını belirlediği içinclient_idgönderilmeyebilir; gönderirseniz yine bu çalışma alanının Client ID'si olmalıdır. Bkz. Anahtarı başlıkta gönderin; cURL, Python, Node.js ve PHP ile ilk mesaj için de Mesaj gönderme. - Zapier: hesabınızı bağlarken Client ID ve API anahtarı.
- n8n: WbizTool kimlik bilgisinin Client ID, API Key ve WhatsApp Client ID alanları.
- Make, Pabbly Connect ve diğer araçlar: bir HTTP isteğinin gövdesi.
- WordPress: WbizTool → Settings sayfasında, API Configuration altında.
Google Sheets ve Shopify panelde kurulur ve anahtar gerektirmez.
Anahtarı başlıkta gönderin#
Her /api/v1/ endpoint'i anahtarı, yakında gelecek API v2'nin de yapacağı gibi, bir Authorization başlığında kabul eder:
Authorization: Bearer YOUR_API_KEY
- Başlıkla
client_idisteğe bağlıdır: çalışma alanını anahtar belirler.client_idde gönderirseniz, önceden olduğu gibi bu çalışma alanının Client ID'si olmalıdır. - Anahtarı tek bir yerde gönderin. Başlığı kullanıyorsanız
api_keyalanını gövdeye koymayın ya da aynı anahtarı gönderin. İkisi farklıysa ve başlıktaki geçerli bir anahtarsa başlıktaki kullanılır; başlıkta başka bir şey varsa (örneğin başka bir aracın token'ı) gövdedekiapi_keykullanılır. - Gövdedeki anahtarlar çalışmaya devam eder (JSON veya form alanları olarak
client_idveapi_key), dolayısıyla bunları gönderen uygulamalar ve entegrasyonlar için hiçbir şey değişmez. Başlık daha iyidir, çünkü istek gövdeleri günlüklere, proxy'lere ve form oluşturucu geçmişlerine başlıklardan daha sık düşer. - Form alanları, multipart yüklemeler ve JSON gövdeleri başlıkla birlikte çalışır.
curl -X POST https://wbiztool.com/api/v1/send_msg/ \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"whatsapp_client": 101, "phone": "919876543210", "msg": "Hello from WbizTool"}'
Anahtarınızı test edin#
Anahtarınız ve isterseniz bir whatsapp_client ile Kimlik bilgilerini kontrol etme (POST /api/v1/me/) endpoint'ini çağırın. "status": 1 ile birlikte "message": "Okay", bu değerlerin birlikte çalıştığı anlamına gelir. Hiçbir şey göndermez ve mesaj kullanmaz, ancak mesajınızın kalıp kalmadığını veya numaranın bağlı olup olmadığını kontrol etmez.
curl -X POST https://wbiztool.com/api/v1/me/ -H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" -d '{"whatsapp_client": 101}'
Çalışan bir anahtar {"status": 1, "message": "Okay", "name": "…"} yanıtını verir.
Bir anahtarı yeniden kopyalayın#
Anahtarın yanındaki Anahtarı kopyala'ya tıklayın. Anahtarın tamamı sayfada gösterilmeden panonuza kopyalanır; örneğin "“Zapier” kopyalandı." mesajını görürsünüz ve düğme kısa bir süre Kopyalandı ✓ gösterir. Eski anahtarı kaybettiğiniz için yeni bir anahtara ihtiyacınız yoktur.
Bir uygulamanın hangi anahtarı kullandığını bulmak için o uygulamadaki anahtarın son dört karakterini listeyle karşılaştırın.
Bir anahtarı silin#
Sil'e tıklayın
Anahtarın yanındaki Sil'e tıklayın.
Onaylayın
"“…” silinsin mi?" penceresi şu uyarıyı verir: "Bu anahtarı kullanan her şey hemen çalışmayı durdurur: Zapier’daki Zap’ler, n8n ve Make senaryoları, WordPress eklentisi ve kendi API çağrılarınız. Önce onlara başka bir anahtar verin. Bu işlem geri alınamaz." Anahtarı sil'e tıklayın. "“…” silindi." mesajını görürsünüz.
Bundan sonra o anahtarla yapılan istekler Auth Error: invalid api key alır. Anahtarın daha önce yaptıkları geçerli kalır: sıraya aldığı mesajlar yine gönderilir (gerekirse Raporlar sayfasında iptal edin) ve oluşturduğu hatırlatıcılar çalışmaya devam eder. Onunla kurulan bir Zapier Incoming WhatsApp Message tetikleyicisi de mesaj almaya devam eder, çünkü webhook'u zaten numaraya bağlıdır: durdurmak için Zap'i Zapier'da kapatın.
Bir anahtarı yenisiyle değiştirin#
Bir anahtar sızmış olabilirse, onu kopyalayabilen biri ayrıldığında veya zaman zaman anahtarı yenisiyle değiştirin. Bunun için ayrı bir düğme yoktur: arada hiçbir şey durmasın diye önce yeni anahtarı oluşturun.
Yeni bir anahtar oluşturun
Bir anahtar oluşturun ve kopyalayın. 10 anahtarınız varsa önce artık kullanmadığınız birini silin.
Uygulamalarınızı güncelleyin
Yeni anahtarı eskisini kullanan her uygulamaya ve entegrasyona yapıştırın ve her birini kontrol edin, örneğin Kimlik bilgilerini kontrol etme ile.
Eski anahtarı silin
Silin. Hemen çalışmayı durdurur.
Kötüye kullanımı kontrol edin (sızıntıdan sonra)
Raporlar sayfasında göndermediğiniz mesajlara bakın ve hâlâ bekleyenleri iptal edin. Hatırlatıcılar sayfasında oluşturmadığınız hatırlatıcıları silin, çünkü çalışmaya devam ederler. WhatsApp numaraları sayfasında eklemediğiniz numaraları kaldırın. Unibox eklentiniz varsa Gelen kutusu numaraları sayfasında tanımadığınız bir Zapier rozeti veya webhook olup olmadığına bakın.
Anahtarlarınızı güvende tutun#
Bir anahtarın kendine ait izinleri yoktur: anahtara sahip olan herkes, rolü ne olursa olsun, çalışma alanınızda API'nin yapabildiği her şeyi yapabilir. Buna çalışma alanının herhangi bir numarasından mesaj göndermek (çalışma alanının mesajlarını kullanarak), mesaj geçmişini okumak, bekleyen mesajları iptal etmek, hatırlatıcıları ve medya dosyalarını yönetmek, numaraları kontrol etmek ve yeni numaralar bağlamak dahildir.
- Anahtarları sunucunuzda, bir ortam değişkeninde veya entegrasyonunuzun kimlik bilgisi deposunda tutun. Bir anahtarı asla bir web sitesinin JavaScript'ine, bir mobil uygulamaya, paylaşılan bir tabloya veya yayımladığınız koda koymayın.
- Anahtarları e-postayla veya sohbet üzerinden göndermeyin. Onları doğrudan ihtiyaç duyan uygulamaya yapıştırın.
- Her uygulama için bir anahtar kullanın ve artık kullanmadığınız anahtarları silin.
- Anahtarları zaman zaman, sızmış olabilecek bir anahtarı ise hemen yenisiyle değiştirin.
Client ID tek başına gizli değildir, ancak her anahtarı bir parola gibi koruyun.
API v2 anahtarları#
API v2 kendi anahtarlarını kullanır; bunlar aynı sekmedeki API v2 anahtarları kartında oluşturulur. Yukarıdaki anahtarlardan daha güvenlidirler:
- Yalnızca bir kez gösterilir. Anahtarın tamamı (
wbz_live_…) yalnızca oluşturduğunuz anda gösterilir; WbizTool yalnızca bir parmak izini saklar. Kaybederseniz iptal edin ve yeni bir anahtar oluşturun. - Yalnızca gerekenler. Anahtarın neler yapabileceğini işaretleyin (mesaj gönderme, mesajları okuma, hatırlatıcılar, numaralar, medya, numara kontrolleri), anahtarı numaralarınızdan bazılarıyla sınırlayın ve isterseniz bir son kullanma tarihi verin.
- Test anahtarları. Bir test anahtarı (
wbz_test_…) her isteği canlı bir anahtar gibi kontrol eder ama hiçbir şey göndermez – bir entegrasyon geliştirmek ve denemek için. - Son kullanım. Her anahtar en son ne zaman ve nereden kullanıldığını gösterir. İptal et anahtarı ve onunla kurulan webhook uç noktalarını hemen durdurur.
Yukarıdaki anahtarlar yalnızca API v1 ile, API v2 anahtarları ise yalnızca v2 ile çalışır. Bkz. v1'den v2'ye geçiş.
Webhook imzaları#
WbizTool size gönderdiği her webhook'u imzalar; böylece endpoint'iniz bir isteğin gerçekten bizden geldiğini ve yolda değiştirilmediğini doğrulayabilir: mesaj durumu webhook'u (gönderildi, başarısız, iptal edildi, süresi doldu), numara bağlantı olayları ve gelen kutusu webhook'ları. Gövdeler öncekiyle aynıdır; iki başlık eklenir:
| Başlık | Değer |
|---|---|
WbizTool-Timestamp | Gönderdiğimiz zaman, Unix saniyesi olarak, örneğin 1792310400 |
WbizTool-Signature | v1= ve <timestamp>.<raw body> için çalışma alanınızın imzalama gizli anahtarıyla hesaplanan onaltılık HMAC-SHA256 |
İmza, gönderdiğimiz baytların tam olarak kendisini kapsar: geldikleri haliyle form alanları, bir QR kodu görseli eklendiğinde multipart gövdenin tamamı ve gelen kutusu webhook'larının JSON'u. Başlıkları yok sayan alıcılar çalışmaya devam eder.
İmzalama gizli anahtarını alın#
Ayarlar → API anahtarları sayfasında, anahtarlarınızın altındaki Webhook imzalama gizli anahtarı kartı gizli anahtarın son dört karakterini gösterir, örneğin •••• b70d. Her çalışma alanının tüm webhook'ları için tek bir gizli anahtarı vardır; size gönderdiğimiz ilk webhook ile birlikte oluşturulur.
Yeni gizli anahtar göster'e tıklayın
Yeni gizli anahtar göster'e (çalışma alanında henüz yoksa Gizli anahtar oluştur'a) tıklayın. "İmzalama gizli anahtarı değiştirilsin mi?" iletişim kutusu, mevcut gizli anahtarın hemen çalışmayı durduracağı konusunda uyarır. Yeni gizli anahtar oluştur'a tıklayın.
Kopyalayın
Webhook imzalama gizli anahtarınız gizli anahtarın tamamını bir kez gösterir. Kopyala'ya tıklayın ve webhook alıcınızın okuyabileceği bir yerde, örneğin bir ortam değişkeninde saklayın. Onu bir daha göremezsiniz: kaybederseniz yenisini oluşturun.
Kartı yalnızca Sahipler görür. Yeni bir gizli anahtar oluşturmak eskisini hemen değiştirir, bu yüzden alıcılarınızı hemen ardından güncelleyin; arada gönderilen webhook'lar doğrulamanızdan geçemez.
Bir webhook'u doğrulayın#
İmzayı ham gövdeden (framework'ünüz onu ayrıştırmadan önce) hesaplayın, başlıkla sabit zamanlı olarak karşılaştırın ve eski bir isteğin yeniden oynatılamaması için 5 dakikadan eski zaman damgalarını reddedin:
import hashlib, hmac, time
def verify(secret: str, body: bytes, headers) -> bool:
ts, sig = headers["WbizTool-Timestamp"], headers["WbizTool-Signature"]
mac = "v1=" + hmac.new(secret.encode(), ts.encode() + b"." + body, hashlib.sha256).hexdigest()
return abs(time.time() - int(ts)) < 300 and hmac.compare_digest(mac, sig)Django'da request.body ve request.headers, Flask'ta request.get_data() ve request.headers verin.
const crypto = require("crypto");
function verify(secret, rawBody, headers) {
const ts = headers["wbiztool-timestamp"], sig = String(headers["wbiztool-signature"]);
const mac = "v1=" + crypto.createHmac("sha256", secret).update(ts + ".").update(rawBody).digest("hex");
return Math.abs(Date.now() / 1000 - Number(ts)) < 300 && sig.length === mac.length &&
crypto.timingSafeEqual(Buffer.from(sig), Buffer.from(mac));
}rawBody, Buffer olarak gövdedir: Express'te webhook rotasında JSON veya form ayrıştırıcısı yerine express.raw({ type: "*/*" }) kullanın.
Doğrulama başarılıysa 2xx, başarısızsa 401 ile yanıt verin. Kendi webhook gizli anahtarı olan gelen kutusu webhook'ları X-Wbiztool-Signature başlığını da taşımaya devam eder; WbizTool-Signature her webhook'ta aynı şemadır.
Sorun giderme#
| Mesaj veya sorun | Ne yapmalı |
|---|---|
| Kenar çubuğunda veya Ayarlar sayfasında API anahtarları yok | Bu çalışma alanında Editör veya Analistsiniz. Bir Sahipten anahtar isteyin ya da sizi Sahip yapmasını isteyin. |
| Anahtar oluştur gri | Çalışma alanında 10 anahtar var. Artık kullanmadığınız birini silin. |
| "Kopyalanamadı – tarayıcınız panoya erişimi engelledi. Tekrar deneyin." | Tarayıcınızda wbiztool.com için pano erişimine izin verin veya başka bir tarayıcı deneyin. Yeni API anahtarınız penceresinde anahtarı seçip kendiniz de kopyalayabilirsiniz. |
| "Anahtar alınamadı. Tekrar deneyin." | Sayfayı yenileyin ve Anahtarı kopyala'ya yeniden tıklayın. |
| "Bu anahtar zaten silinmiş." | Bu arada başka bir Sahip onu sildi. Liste kalan anahtarları gösterir. |
| Bir anahtarda Pasif yazıyor | Anahtar çalışmıyor. Silin ve yeni bir anahtar oluşturun. |
Auth Error: invalid api key | Anahtar silinmiş veya yanlış yazılmış (boşluk olmadan yeniden kopyalayın) ya da client_id bu çalışma alanının Client ID'si değil. |
Auth Error - Please send correct API key and Client id | api_key eksik veya boş. |
| Bir webhook imza doğrulamanızdan geçmiyor | Ayrıştırılıp yeniden kodlanmış alanlara değil, ham gövdeye göre doğrulayın; geçerli gizli anahtarı kullanın (Yeni gizli anahtar göster'den sonra yalnızca yenisi çalışır); ve sunucunuzun saatini kontrol edin (5 dakikadan fazla sapan bir zaman damgası reddedilir). |
Auth Error | Birden çok numaraya gönderme, Mesaj zamanlama ve Mesaj durumu gibi endpoint'lerde: client_id veya api_key eksik, gövde JSON veya form alanlarından oluşmuyor ya da istek bir POST değil. |
Invalid client id., Invalid Client Id, client_id is required veya client_id must be a valid integer | client_id eksik veya 5012 gibi bir sayı değil. Değeri Client ID satırından kopyalayın. |
Invalid WhatsApp Client ID (Kimlik bilgilerini kontrol etme) veya Invalid whatsapp client … (Mesaj gönderme) | Numara ID'si bu anahtarın çalışma alanında değil ya da numara kaldırılmış. ID … ⧉ değerini WhatsApp numaraları sayfasından kopyalayın. |
| "… çalışma alanından 2 gündür mesaj yok" e-postası | Çalışma alanınız genellikle her gün API veya bir entegrasyon üzerinden gönderim yapar ve 2 gündür hiçbir şey gelmedi. E-posta, geçen hafta oluşturulan veya silinen her anahtarı belirtir: uygulamanın hâlâ çalışan bir anahtarı olduğunu kontrol edin (bkz. Bildirimler). |
Invalid API key veya Invalid client_id for this API key | Numara doğrulama veya medya API'leri: anahtar yanlış veya silinmiş ya da client_id anahtarın çalışma alanına ait değil. |
This API key is not linked to a workspace. Create a new API key in WbizTool. | Anahtar eski bir hesap yapısından geliyor. Yeni bir anahtar oluşturun ve onu kullanın. |
Only workspace owners and editors can connect Zapier triggers | Anahtarı artık Sahip veya Editör olmayan biri oluşturmuş. Yeni bir anahtar oluşturun ve Zapier'ı yeniden bağlayın. |
Demo Account can not access apis | Demo hesabı API'yi kullanamaz. Kendi hesabınız için kaydolun. |
Not enough credits | Anahtar çalışıyor, ancak çalışma alanı ücretsiz planda ve mesajı kalmadı. Bkz. Planlar ve faturalandırma. |
| İstekler yanlış çalışma alanında işlem yapıyor | Anahtar başka bir çalışma alanında oluşturulmuş. Çalışma alanını değiştirin ve orada bir anahtar oluşturun. |


