İçeriğe geç
WbizTool

WhatsApp hesapları API'si

Bağlı WhatsApp numaralarını listeleme API'si

Çalışma alanınızda şu anda gönderim yapabilen veya mesajları tarayıcısını bekleyen WhatsApp numaralarını alın. Kullanıcıların gönderim yapacakları numarayı seçmesini sağlamak veya diğer API çağrıları için whatsapp_client ID'sini bulmak için kullanın.

POSThttps://wbiztool.com/api/v1/whatsapp-client/list/

Gövde: JSON veya form alanları

Bağlı numaralar ve tarayıcısı kapalı olan Chrome uzantısı numaraları (status waiting_for_browser) döndürülür: bu numaralardan gönderebilirsiniz ve mesajları tarayıcı geri gelene kadar bekler. Bağlantısı kesik numaraları da görmek için Hesapları listeleme endpoint'ini kullanın. Bağlı Telegram hesapları da platform değeri telegram olarak listelenir.

Hızlı örnek#

curl -X POST https://wbiztool.com/api/v1/whatsapp-client/list/ \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": 12345,
    "api_key": "YOUR_API_KEY"
  }'

12345 ve YOUR_API_KEY değerlerini kendi değerlerinizle değiştirin. Bunları nerede bulacağınız için Kimlik doğrulama bölümüne bakın.

İstek parametreleri#

AuthorizationheaderÖnerilir

Bearer YOUR_API_KEY: Ayarlar → API anahtarları sayfasındaki API anahtarınız. Bu başlıkla client_id ve api_key gövdeden çıkarılabilir; ikisi birden gönderilirse başlıktaki geçerli anahtar kullanılır. Bkz. Anahtarı başlıkta gönderin.

client_idintegerAuthorization başlığı olmadan

Ayarlar → API anahtarları sayfasındaki API Client ID'niz. Başlıkla isteğe bağlıdır; gönderirseniz anahtarın çalışma alanına ait olmalıdır.

api_keystringAuthorization başlığı olmadan

Aynı sayfadaki API anahtarınız; başlıkta göndermediğinizde. Liste, bu anahtarın oluşturulduğu çalışma alanı içindir.

Resmi istemcileri kullanma#

Python istemcisi bu endpoint'i sizin için çağırır.

Python
from wbiztool_client import WbizToolClient

client = WbizToolClient(api_key="YOUR_API_KEY", client_id=12345)

result = client.list_whatsapp_clients()
for number in result.get("whatsapp_clients", []):
    print(number["whatsapp_client_id"], number["whatsapp_client_number"])

Python istemcisi, API HTTP 400 veya 403 döndürdüğünde requests.exceptions.HTTPError fırlatır; bu yüzden çağrıyı try/except içine alın.

Node.js istemcisinin getWhatsAppClients() yöntemi var olmayan bir adresi çağırır ve 404 ile başarısız olur. Hızlı örnek bölümündeki gibi fetch kullanın.

Yanıt#

Başarılı bir istek HTTP 200 döndürür:

{
  "message": "okay",
  "whatsapp_clients": [
    {
      "id": 678,
      "whatsapp_client_id": 678,
      "whatsapp_client_number": "919876543210",
      "platform": "whatsapp",
      "is_connected": true,
      "status": "connected"
    },
    {
      "id": 702,
      "whatsapp_client_id": 702,
      "whatsapp_client_number": "919812345670",
      "platform": "telegram",
      "is_connected": true,
      "status": "connected"
    },
    {
      "id": 731,
      "whatsapp_client_id": 731,
      "whatsapp_client_number": "919898989898",
      "platform": "whatsapp",
      "is_connected": false,
      "status": "waiting_for_browser"
    }
  ],
  "status": 1
}
AlanTürAçıklama
statusintegerBaşarıda 1, istek başarısız olduysa 0.
messagestringBaşarıda okay, aksi halde hata mesajı.
whatsapp_clientsdiziBağlı numaralarınız ve tarayıcısını bekleyen uzantı numaralarınız. Hiçbiri yoksa boştur. Yalnızca başarıda bulunur.
whatsapp_clients[].whatsapp_client_idintegerNumaranın ID'si. Diğer API çağrılarında whatsapp_client olarak iletin.
whatsapp_clients[].idintegerwhatsapp_client_id ile aynı değer.
whatsapp_clients[].whatsapp_client_numberstringNumara eklendiğinde kaydedildiği haliyle telefon numarası.
whatsapp_clients[].platformstringBir WhatsApp numarası için whatsapp, bir Telegram hesabı için telegram. İkisinden de ID'sini whatsapp_client olarak ileterek gönderin.
whatsapp_clients[].is_connectedbooleanBağlı bir numara için true, tarayıcısını bekleyen bir uzantı numarası için false.
whatsapp_clients[].statusstringconnected: numara şimdi gönderir. waiting_for_browser: tarayıcısı kapalı bir Chrome uzantısı numarası; ondan gönderilen mesajlar bekler ve tarayıcı geri geldiğinde gider ya da 48 saat sonra süreleri dolar.

Listenin sırası garanti edilmez. Sıra önemliyse whatsapp_client_id değerine göre sıralayın.

Hatalar#

MesajHTTPNasıl düzeltilir
Auth Error200client_id ve api_key değerlerinin ikisini de bir POST gövdesinde, geçerli JSON veya form alanları olarak gönderin.
Invalid Client Id403client_id değerini 12345 gibi bir tam sayı olarak gönderin.
Auth Error: invalid api key400Anahtarın mevcut olduğunu, silinmediğini ve bu client_id değerine ait olduğunu kontrol edin.

POST olmayan bir istek boş bir nesne {} döndürür. Beklenmeyen bir sunucu sorunu HTML gövdesiyle HTTP 500 döndürür; bu yüzden status değerini okumadan önce yanıtın JSON olduğunu kontrol edin.

İpuçları#

  • Boş liste: "whatsapp_clients": [] bu çalışma alanında bağlı numara olmadığı ve tarayıcısını bekleyen bir uzantı numarası da bulunmadığı anlamına gelir. WhatsApp ayarları sayfasından veya Numara bağlama ile bir numara bağlayın.
  • Birden fazla çalışma alanı: hangi çalışma alanının listeleneceğini API anahtarı belirler. İstediğiniz çalışma alanında oluşturulmuş bir anahtar kullanın.
  • Yalnızca bir numara: tek bir numarayı kontrol etmek için Bağlantı durumu endpoint'ini kullanın.