API de cuentas de WhatsApp
API para listar cuentas de WhatsApp
Usa esta API para obtener en una sola llamada una lista completa de todos tus números de WhatsApp y su estado de conexión. A diferencia de Listar números conectados, incluye los números desconectados.
https://wbiztool.com/api/v1/whatsapp/accounts/Cuerpo: JSON o campos de formulario
| Diferencia | Listar cuentas | Listar números conectados |
|---|---|---|
| Incluye números desconectados y eliminados | Sí | No |
| Claves de cada elemento | whatsapp_client_id, whatsapp_number, status | id, whatsapp_client_id, whatsapp_client_number, is_connected |
message si la solicitud es correcta | No se incluye | okay |
Ejemplo rápido#
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');
}Sustituye 12345 y YOUR_API_KEY por tus propios valores. Consulta Autenticación para saber dónde encontrarlos.
Ninguno de los clientes oficiales tiene un método para este endpoint, así que llámalo directamente como en los ejemplos.
Parámetros de la solicitud#
client_idintegerobligatorioTu ID de cliente de la API, de Configuración → Claves API.
api_keystringobligatorioTu clave API, de esa misma página. La lista corresponde al espacio de trabajo en el que se creó esta clave.
Respuesta#
Una solicitud correcta devuelve 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 | Descripción |
|---|---|---|
status | integer | 1 si todo va bien, 0 si la solicitud falló. |
whatsapp_clients | array | Todos los números de WhatsApp que se han añadido alguna vez a este espacio de trabajo. Solo aparece si la solicitud es correcta. |
whatsapp_clients[].whatsapp_client_id | integer | El ID del número. Pásalo como whatsapp_client en otras llamadas a la API. |
whatsapp_clients[].whatsapp_number | string | El número de teléfono tal como se guardó al añadirlo. |
whatsapp_clients[].status | string | connected o not_connected. |
La lista no tiene ningún orden garantizado. Ordénala por whatsapp_client_id si el orden importa.
Una respuesta correcta no tiene campo message, así que léelo con un valor alternativo, como en los ejemplos.
Errores#
| Mensaje | HTTP | Cómo solucionarlo |
|---|---|---|
Auth Error | 200 | Envía client_id y api_key en el cuerpo de una solicitud POST, como JSON válido o campos de formulario. |
Invalid Client Id | 403 | Envía client_id como número entero, por ejemplo 12345. |
Auth Error: invalid api key | 400 | Comprueba que la clave existe, que no se ha eliminado y que pertenece a este client_id. |
Si el servidor encuentra un problema inesperado, o la solicitud no es un POST, la respuesta es un objeto vacío: {}. Trata la ausencia de status como un fallo.
Consejos#
- Volver a conectar un número: un número
not_connectedse puede volver a conectar en la configuración de WhatsApp o con Conectar un número. - Un solo número: para comprobar un único número, usa Estado de conexión.
- Varios espacios de trabajo: la clave API determina qué espacio de trabajo se lista. Usa una clave creada en el espacio de trabajo que quieras.
