API account WhatsApp
API Elenca account WhatsApp
Usa questa API per ottenere in una sola chiamata l'elenco completo di tutti i tuoi numeri WhatsApp con il relativo stato di connessione. A differenza di Elenca numeri collegati, include anche i numeri scollegati.
https://wbiztool.com/api/v1/whatsapp/accounts/Corpo: JSON o campi di un modulo
| Differenza | Elenca account | Elenca numeri collegati |
|---|---|---|
| Include numeri scollegati ed eliminati | Sì | No |
| Chiavi degli elementi | whatsapp_client_id, whatsapp_number, status | id, whatsapp_client_id, whatsapp_client_number, is_connected |
message in caso di successo | Non incluso | okay |
Esempio rapido#
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');
}Sostituisci 12345 e YOUR_API_KEY con i tuoi valori. Consulta Autenticazione per sapere dove trovarli.
Nessuno dei due client ufficiali ha un metodo per questo endpoint, quindi chiamalo direttamente come negli esempi.
Parametri della richiesta#
client_idintegerobbligatorioIl tuo ID Client API, da Impostazioni → Chiavi API.
api_keystringobbligatorioLa tua chiave API, dalla stessa pagina. L'elenco riguarda lo spazio di lavoro in cui è stata creata questa chiave.
Risposta#
Una richiesta riuscita restituisce HTTP 200:
{
"whatsapp_clients": [
{
"whatsapp_client_id": 678,
"whatsapp_number": "919876543210",
"status": "connected"
},
{
"whatsapp_client_id": 702,
"whatsapp_number": "919812345678",
"status": "not_connected"
}
],
"status": 1
}
| Campo | Tipo | Descrizione |
|---|---|---|
status | integer | 1 in caso di successo, 0 se la richiesta non è riuscita. |
whatsapp_clients | array | Tutti i numeri WhatsApp mai aggiunti a questo spazio di lavoro. Presente solo in caso di successo. |
whatsapp_clients[].whatsapp_client_id | integer | L'ID del numero. Passalo come whatsapp_client nelle altre chiamate API. |
whatsapp_clients[].whatsapp_number | string | Il numero di telefono così come è stato salvato quando è stato aggiunto. |
whatsapp_clients[].status | string | connected o not_connected. |
L'elenco non segue un ordine garantito. Ordina per whatsapp_client_id se l'ordine è importante.
Una risposta riuscita non ha il campo message, quindi leggilo con un valore di ripiego come negli esempi.
Errori#
| Messaggio | HTTP | Come risolvere |
|---|---|---|
Auth Error | 200 | Invia sia client_id sia api_key nel corpo di una richiesta POST, come JSON valido o campi di un modulo. |
Invalid Client Id | 403 | Invia client_id come numero intero, ad esempio 12345. |
Auth Error: invalid api key | 400 | Verifica che la chiave esista, non sia stata eliminata e appartenga a questo client_id. |
Se il server incontra un problema imprevisto, o se la richiesta non è una POST, la risposta è un oggetto vuoto: {}. Considera un fallimento l'assenza di status.
Suggerimenti#
- Ricollegare un numero: un numero
not_connectedpuò essere ricollegato nelle Impostazioni WhatsApp oppure con Collega un numero. - Un solo numero: per controllare un singolo numero, usa Stato della connessione.
- Più spazi di lavoro: la chiave API determina quale spazio di lavoro viene elencato. Usa una chiave creata nello spazio di lavoro che ti interessa.
