WhatsApp-Konten-API
Verbindungsstatus (WhatsApp Client Status API)
Prüfen Sie, ob eine Ihrer WhatsApp-Nummern verbunden und bereit zum Senden von Nachrichten ist. Nutzen Sie ihn vor einer Kampagne oder während Sie darauf warten, dass eine neu verbundene Nummer die Verknüpfung abschließt. Verwenden Sie diesen Endpoint statt /api/v1/whatsapp/status/<id>/, der nicht funktioniert.
https://wbiztool.com/api/v1/whatsapp-client/status/Body: JSON oder Formularfelder
Kurzes Beispiel#
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
}'import requests
response = requests.post(
"https://wbiztool.com/api/v1/whatsapp-client/status/",
json={
"client_id": 12345,
"api_key": "YOUR_API_KEY",
"whatsapp_client": 678,
},
timeout=30,
)
result = response.json() # read the body even when the HTTP code is 400 or 403
if result["status"] == 1:
print("Connected")
elif result["message"] == "Disconnected":
print("Not connected. Reconnect it in WhatsApp settings.")
else:
print("Failed:", result["message"])// Node.js 18+ (built-in fetch). Save as .mjs to use top-level await.
const response = await fetch("https://wbiztool.com/api/v1/whatsapp-client/status/", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
client_id: 12345,
api_key: "YOUR_API_KEY",
whatsapp_client: 678,
}),
});
const result = await response.json(); // read the body even when the HTTP code is 400 or 403
if (result.status === 1) {
console.log("Connected");
} else if (result.message === "Disconnected") {
console.log("Not connected. Reconnect it in WhatsApp settings.");
} else {
console.error("Failed:", result.message);
}<?php
$payload = [
'client_id' => 12345,
'api_key' => 'YOUR_API_KEY',
'whatsapp_client' => 678,
];
$ch = curl_init('https://wbiztool.com/api/v1/whatsapp-client/status/');
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
CURLOPT_POSTFIELDS => json_encode($payload),
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 30,
]);
$result = json_decode(curl_exec($ch), true);
curl_close($ch);
if (($result['status'] ?? 0) === 1) {
echo 'Connected';
} elseif (($result['message'] ?? '') === 'Disconnected') {
echo 'Not connected. Reconnect it in WhatsApp settings.';
} else {
echo 'Failed: ' . ($result['message'] ?? 'no response');
}Ersetzen Sie 12345, YOUR_API_KEY und 678 durch Ihre eigenen Werte. Wo Sie diese finden, steht unter Authentifizierung.
Request-Parameter#
client_idintegererforderlichIhre API-Client-ID aus Einstellungen → API-Schlüssel.
api_keystringerforderlichIhr API-Schlüssel von derselben Seite.
whatsapp_clientintegererforderlichID der zu prüfenden WhatsApp-Nummer, aus den WhatsApp-Einstellungen, aus Konten auflisten oder die von Nummer verbinden zurückgegebene
whatsapp_client_id.
Offizielle Clients verwenden#
Der Python-Client ruft diesen Endpoint für Sie auf.
from wbiztool_client import WbizToolClient
client = WbizToolClient(api_key="YOUR_API_KEY", client_id=12345)
result = client.get_whatsapp_client_status(678)
print(result)Der Python-Client löst requests.exceptions.HTTPError aus, wenn die API HTTP 400 oder 403 zurückgibt. Umschließen Sie den Aufruf daher mit try/except.
getWhatsAppClientStatus() im Node.js-Client ruft eine Adresse auf, die nicht existiert, und schlägt mit 404 fehl. Verwenden Sie fetch wie im Kurzen Beispiel.
Antwort#
Sind Ihre Zugangsdaten gültig, gibt der Request HTTP 200 mit einem dieser Bodys zurück.
Die Nummer ist verbunden:
{ "message": "Connected", "status": 1 }
Die Nummer ist nicht verbunden:
{ "message": "Disconnected", "status": 0 }
| Feld | Typ | Beschreibung |
|---|---|---|
status | integer | 1, wenn die Nummer verbunden ist. 0, wenn sie nicht verbunden ist oder der Request fehlgeschlagen ist. |
message | string | Connected, Disconnected oder der Fehler. |
Eine Nummer, die Sie in den WhatsApp-Einstellungen gelöscht haben, liefert ebenfalls Disconnected.
Fehler#
| Meldung | HTTP | Lösung |
|---|---|---|
Auth Error | 200 | Senden Sie client_id, api_key und ein numerisches whatsapp_client in einem POST-Body, als gültiges JSON oder als Formularfelder. |
Invalid Client Id | 403 | Senden Sie client_id als ganze Zahl, zum Beispiel 12345. |
Auth Error: invalid api key | 400 | Prüfen Sie, ob der Schlüssel existiert, nicht gelöscht wurde und zu dieser client_id gehört. |
Auth Error 2 | 200 | Diese whatsapp_client-ID gehört nicht zum Arbeitsbereich dieses API-Schlüssels. |
Demo Account can not access apis | 200 | Verwenden Sie ein reguläres Konto. |
Tipps#
- Vor dem Senden: Ist die Nummer, über die Sie senden, getrennt, warten ihre Nachrichten in der Warteschlange, bis sie wieder verbunden ist oder die Nachrichten ablaufen. Prüfen Sie den Status daher vor großen Sendungen. Nicht gesendete Nachrichten einer getrennten Nummer werden nach 90 Tagen entfernt.
- Nach dem Verbinden einer Nummer: Fragen Sie diesen Endpoint alle paar Sekunden ab, bis er
Connectedzurückgibt. Der Webhookconnectedkann einige Sekunden eintreffen, bevor dieser EndpointConnectedzurückgibt. Fragen Sie daher nach dem Ereignis bis zu einer Minute lang weiter ab. Siehe Nummer verbinden. - Alle Nummern auf einmal: Um den Status aller Nummern mit einem Aufruf abzurufen, verwenden Sie Konten auflisten.
