WhatsApp-Konten-API
WhatsApp-Konten auflisten (WhatsApp Accounts API)
Mit dieser API erhalten Sie in einem einzigen Aufruf eine vollständige Liste all Ihrer WhatsApp-Nummern und ihres Verbindungsstatus. Anders als Verbundene Nummern auflisten enthält sie auch getrennte Nummern.
https://wbiztool.com/api/v1/whatsapp/accounts/Body: JSON oder Formularfelder
| Unterschied | Konten auflisten | Verbundene Nummern auflisten |
|---|---|---|
| Enthält getrennte und gelöschte Nummern | Ja | Nein |
| Schlüssel der Einträge | whatsapp_client_id, whatsapp_number, status | id, whatsapp_client_id, whatsapp_client_number, is_connected |
message bei Erfolg | Nicht enthalten | okay |
Kurzes Beispiel#
curl -X POST https://wbiztool.com/api/v1/whatsapp/accounts/ \
-H "Content-Type: application/json" \
-d '{
"client_id": 12345,
"api_key": "YOUR_API_KEY"
}'import requests
response = requests.post(
"https://wbiztool.com/api/v1/whatsapp/accounts/",
json={
"client_id": 12345,
"api_key": "YOUR_API_KEY",
},
timeout=30,
)
result = response.json() # read the body even when the HTTP code is 400 or 403
if result.get("status") == 1:
for account in result["whatsapp_clients"]:
print(account["whatsapp_client_id"], account["whatsapp_number"], account["status"])
else:
print("Failed:", result.get("message", "no response"))// Node.js 18+ (built-in fetch). Save as .mjs to use top-level await.
const response = await fetch("https://wbiztool.com/api/v1/whatsapp/accounts/", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
client_id: 12345,
api_key: "YOUR_API_KEY",
}),
});
const result = await response.json(); // read the body even when the HTTP code is 400 or 403
if (result.status === 1) {
for (const account of result.whatsapp_clients) {
console.log(account.whatsapp_client_id, account.whatsapp_number, account.status);
}
} else {
console.error("Failed:", result.message ?? "no response");
}<?php
$payload = [
'client_id' => 12345,
'api_key' => 'YOUR_API_KEY',
];
$ch = curl_init('https://wbiztool.com/api/v1/whatsapp/accounts/');
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) {
foreach ($result['whatsapp_clients'] as $account) {
echo $account['whatsapp_client_id'] . ' ' . $account['whatsapp_number'] . ' ' . $account['status'] . PHP_EOL;
}
} else {
echo 'Failed: ' . ($result['message'] ?? 'no response');
}Ersetzen Sie 12345 und YOUR_API_KEY durch Ihre eigenen Werte. Wo Sie diese finden, steht unter Authentifizierung.
Keiner der offiziellen Clients hat eine Methode für diesen Endpoint. Rufen Sie ihn daher direkt auf, wie in den Beispielen.
Request-Parameter#
client_idintegererforderlichIhre API-Client-ID aus Einstellungen → API-Schlüssel.
api_keystringerforderlichIhr API-Schlüssel von derselben Seite. Die Liste gilt für den Arbeitsbereich, in dem dieser Schlüssel erstellt wurde.
Antwort#
Ein erfolgreicher Request gibt HTTP 200 zurück:
{
"whatsapp_clients": [
{
"whatsapp_client_id": 678,
"whatsapp_number": "919876543210",
"status": "connected"
},
{
"whatsapp_client_id": 702,
"whatsapp_number": "919812345678",
"status": "not_connected"
}
],
"status": 1
}
| Feld | Typ | Beschreibung |
|---|---|---|
status | integer | 1 bei Erfolg, 0, wenn der Request fehlgeschlagen ist. |
whatsapp_clients | array | Jede WhatsApp-Nummer, die jemals zu diesem Arbeitsbereich hinzugefügt wurde. Nur bei Erfolg vorhanden. |
whatsapp_clients[].whatsapp_client_id | integer | Die ID der Nummer. Übergeben Sie sie in anderen API-Aufrufen als whatsapp_client. |
whatsapp_clients[].whatsapp_number | string | Die Telefonnummer, wie sie beim Hinzufügen gespeichert wurde. |
whatsapp_clients[].status | string | connected oder not_connected. |
Die Liste ist nicht in einer garantierten Reihenfolge sortiert. Sortieren Sie nach whatsapp_client_id, wenn die Reihenfolge wichtig ist.
Eine erfolgreiche Antwort hat kein Feld message. Lesen Sie es daher wie in den Beispielen mit einem Fallback aus.
Fehler#
| Meldung | HTTP | Lösung |
|---|---|---|
Auth Error | 200 | Senden Sie client_id und api_key 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. |
Tritt auf dem Server ein unerwartetes Problem auf oder ist der Request kein POST, ist die Antwort ein leeres Objekt: {}. Behandeln Sie ein fehlendes status als Fehler.
Tipps#
- Nummer erneut verbinden: Eine Nummer mit
not_connectedkönnen Sie in den WhatsApp-Einstellungen oder mit Nummer verbinden erneut verbinden. - Nur eine Nummer: Um eine einzelne Nummer zu prüfen, verwenden Sie Verbindungsstatus.
- Mehrere Arbeitsbereiche: Der API-Schlüssel bestimmt, welcher Arbeitsbereich aufgelistet wird. Verwenden Sie einen Schlüssel, der im gewünschten Arbeitsbereich erstellt wurde.
