Ürün kılavuzları

API anahtarları

Wbiztool API'sini veya kimlik bilgilerinizi isteyen bir entegrasyonu kullanmak için panelden üç şeye ihtiyacınız vardır:

Kimlik bilgisi	API alanı	Nerede bulunur
API Client ID	`client_id`	Ayarlar → API anahtarları, sayfanın üstünde
API anahtarı	`api_key`	Ayarlar → API anahtarları
WhatsApp Client ID	`whatsapp_client`	WhatsApp ayarları sayfasındaki Whatsapp Client ID sütunu

Başlamadan önce#

API anahtarlarını görmek, oluşturmak veya silmek için çalışma alanının Administrator (Yönetici) rolüne sahip olmanız gerekir. Bkz. Roller ve izinler.
Önce doğru çalışma alanını seçin. Anahtarlar, oluşturdukları sırada seçili olan çalışma alanına aittir ve bir anahtarla yapılan API istekleri o çalışma alanı üzerinde işlem yapar. Bkz. Çalışma alanını değiştirin.
Demo hesapları API'yi kullanamaz.

API Client ID'nizi bulun#

Ayarlar → API anahtarları sayfasını açın. API Overview (API'ye genel bakış) kartı, API Client ID: ve ardından bir sayı gösterir. Bu sayıyı her istekte client_id olarak kullanın. Çalışma alanındaki tüm anahtarlar için aynıdır.

API anahtarı oluşturun#

API anahtarları sekmesini açın
Ayarlar sayfasına gidip API Keys (API anahtarları) sekmesine tıklayın veya doğrudan /settings/?tab=api-keys adresini açın.
Anahtarı oluşturun
New API Key (Yeni API anahtarı) altında Create New (Yeni oluştur) düğmesine tıklayın. Bir başarı mesajı anahtarın oluşturulduğunu onaylar ve anahtar tabloda görünür.
Anahtarın tamamını kopyalayın
API Key sütunu her anahtarın yalnızca başını ve sonunu gösterir. Anahtarın tamamını kopyalamak için yanındaki kopyala düğmesine (Copy Full API Key – API anahtarının tamamını kopyala) tıklayın, ardından uygulamanıza veya entegrasyonunuza yapıştırın.

Anahtarlar, çalışma alanındaki anahtar sayısına göre otomatik olarak adlandırılır (API Key 1, API Key 2 vb.) ve yeniden adlandırılamaz. Bir anahtarı sildikten sonra yeni bir anahtar mevcut bir anahtarla aynı adı alabilir; bu yüzden anahtarları ilk ve son karakterlerinden ve Created (Oluşturulma) tarihinden ayırt edin. Anahtarların süresi dolmaz: bir anahtar siz silene kadar çalışır.

Sınır#

Bir çalışma alanında aynı anda en fazla 10 API anahtarı olabilir. Sınıra ulaştığınızda "You have reached the maximum limit of 10 API keys per organization." (Kuruluş başına en fazla 10 API anahtarı sınırına ulaştınız) mesajını görürsünüz. Yenisini oluşturmak için artık kullanmadığınız bir anahtarı silin.

API anahtarları tablosu#

Sütun	Anlamı
Label (Etiket)	Anahtarın adı, örneğin API Key 1.
API Key	Anahtarın ilk ve son karakterleri. Anahtarın tamamı için kopyala düğmesini kullanın.
Created	Anahtarın oluşturulduğu tarih.
Durum	Her zaman Aktif. Silinen anahtarlar tablodan kaldırılır.
İşlemler	Sil anahtarı kaldırır.

API anahtarını silin#

Anahtarı bulun
Ayarlar → API anahtarları sayfasında anahtarı tabloda bulun.
Silin
Sil'e, ardından Yes, Delete API Key (Evet, API anahtarını sil) düğmesine tıklayın.

Bir anahtarı silmek geri alınamaz. Onu hâlâ kullanan tüm uygulamalar hemen çalışmayı durdurur ve Auth Error: invalid api key alır. Önce uygulamalarınızı yeni bir anahtarla güncelleyin.

WhatsApp Client ID'leri#

Bağlı her WhatsApp numarasının kendi kimliği vardır. Çoğu mesajlaşma endpoint'i, mesajı hangi numaranın göndereceğini seçmek için bu kimliği whatsapp_client alanında ister.

WhatsApp ayarları sayfasını açın ve her numaranın yanındaki Whatsapp Client ID sütununu okuyun. Henüz numara bağlamadıysanız bkz. WhatsApp numaranızı bağlayın.

Kimlik bilgilerinizi test edin#

client_id ve api_key değerlerinizle, isteğe bağlı olarak bir whatsapp_client ile Kimlik bilgilerini kontrol etme (POST /api/v1/me/) endpoint'ini çağırın. Hiçbir şey göndermeden veya mesaj kullanmadan birlikte çalıştıklarını doğrular. whatsapp_client çalışma alanına ait değilse yanıt Invalid WhatsApp Client ID olur.

Bir API anahtarı sızarsa#

API anahtarınıza ve API Client ID'nize sahip olan herkes WhatsApp numaralarınızdan mesaj gönderebilir ve çalışma alanınızın mesajlarını kullanabilir.

Yedek bir anahtar oluşturun
Ayarlar → API anahtarları sayfasında Create New'a tıklayın ve yeni anahtarı kopyalayın.
Uygulamalarınızı güncelleyin
Eski anahtarı kullanan tüm uygulama ve entegrasyonlarda onu değiştirin.
Sızan anahtarı silin
Sızan anahtarda Sil'e tıklayın. Hemen çalışmayı durdurur.
Kötüye kullanımı kontrol edin
Göndermediğiniz bir şey olup olmadığını görmek için Raporlar sayfasındaki son mesajları inceleyin.

"WbizTool Alert - WhatsApp Connected Successfully!" e-postasını da gizli tutun: bir numara ilk kez bağlandığında çalışma alanını oluşturan kişiye gönderilir ve API anahtarlarınızdan birini içerebilir.

Sorun giderme#

Sorun	Neyi kontrol etmeli
API Keys sekmesi No API Keys Found (API anahtarı bulunamadı) gösteriyor ama anahtarlar var	Bu çalışma alanında Administrator değilsiniz ya da farklı bir çalışma alanı seçili.
"You don't have permission to create API keys in this space."	Anahtar oluşturma veya silme işlemini yalnızca Administrator'lar yapabilir. Boş bir tablodaki Generate New API Key (Yeni API anahtarı oluştur) düğmesi herkese görünür, ancak yalnızca Administrator'lar için çalışır.
"You have reached the maximum limit of 10 API keys per organization."	Artık kullanmadığınız bir anahtarı silin.
`Auth Error: invalid api key`	Anahtar silinmiş veya yanlış yazılmış ya da `client_id` anahtarla aynı çalışma alanına ait değil. Yeni bir anahtar ve sayfada gösterilen API Client ID hâlâ başarısız oluyorsa destek ekibiyle iletişime geçin (eski çalışma alanları yalnızca çalışma alanını oluşturan kişinin oluşturduğu anahtarlarla çalışan bir API Client ID gösterebilir).
`Auth Error - Please send correct API key and Client id`	İstekte `api_key` eksik.
`Invalid client id.` (veya bazı endpoint'lerde `Invalid Client Id`)	`client_id` eksik veya bir sayı değil. Kimlik bilgilerini kontrol etme endpoint'inde eksik bir `client_id` veya `api_key` yalnızca `Auth Error` döndürür; oradaki `Invalid Client Id` değerin sayı olmadığı anlamına gelir. Değeri API Overview kartından kopyalayın.
İ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.
`Demo Account can not access apis`	Demo hesapları API'yi kullanamaz. Ücretsiz bir hesap için kaydolun.