İçeriğe geç
Wbiztool

WhatsApp hesapları API'si

WhatsApp bağlantı durumu API'si

WhatsApp numaralarınızdan birinin bağlı ve mesaj göndermeye hazır olup olmadığını kontrol edin. Bir kampanyadan önce veya yeni bağlanan bir numaranın bağlantısının tamamlanmasını beklerken kullanın. Çalışmayan /api/v1/whatsapp/status/<id>/ yerine bu endpoint'i kullanın.

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

Gövde: JSON veya form alanları

Hızlı örnek#

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

12345, YOUR_API_KEY ve 678 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#

client_idintegerzorunlu

Ayarlar → API anahtarları sayfasındaki API Client ID'niz.

api_keystringzorunlu

Aynı sayfadaki API anahtarınız.

whatsapp_clientintegerzorunlu

Kontrol edilecek WhatsApp numarasının ID'si; WhatsApp ayarları sayfasından, Hesapları listeleme endpoint'inden veya Numara bağlama tarafından döndürülen whatsapp_client_id değerinden alınır.

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.get_whatsapp_client_status(678)
print(result)

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 getWhatsAppClientStatus() 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#

Kimlik bilgileriniz geçerli olduğunda istek, şu gövdelerden biriyle HTTP 200 döndürür.

Numara bağlı:

{ "message": "Connected", "status": 1 }

Numara bağlı değil:

{ "message": "Disconnected", "status": 0 }
AlanTürAçıklama
statusintegerNumara bağlıysa 1. Numara bağlı değilse veya istek başarısız olduysa 0.
messagestringConnected, Disconnected veya hata mesajı.

WhatsApp ayarlarından sildiğiniz bir numara da Disconnected döndürür.

Hatalar#

MesajHTTPNasıl düzeltilir
Auth Error200client_id, api_key ve sayısal bir whatsapp_client değerini 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.
Auth Error 2200Bu whatsapp_client ID'si bu API anahtarının çalışma alanında değil.
Demo Account can not access apis200Normal bir hesap kullanın.

İpuçları#

  • Göndermeden önce: gönderim yaptığınız numaranın bağlantısı kesikse, mesajları numara yeniden bağlanana veya süreleri dolana kadar kuyrukta bekler; bu yüzden büyük gönderimlerden önce durumu kontrol edin. Bağlantısı kesik bir numaradaki gönderilmemiş mesajlar 90 gün sonra silinir.
  • Bir numara bağladıktan sonra: Connected döndürene kadar bu endpoint'i birkaç saniyede bir sorgulayın. connected webhook'u, bu endpoint Connected döndürmeden birkaç saniye önce gelebilir; bu yüzden olaydan sonra bir dakikaya kadar sorgulamaya devam edin. Bkz. Numara bağlama.
  • Tüm numaralar bir arada: tek bir çağrıyla her numaranın durumunu almak için Hesapları listeleme endpoint'ini kullanın.