API de cuentas de WhatsApp
API para listar números de WhatsApp conectados
Obtén los números de WhatsApp de tu espacio de trabajo que están conectados en este momento. Úsala para que los usuarios elijan desde qué número enviar, o para encontrar el ID de whatsapp_client para otras llamadas a la API.
https://wbiztool.com/api/v1/whatsapp-client/list/Cuerpo: JSON o campos de formulario
Solo se devuelven los números conectados. Para ver también los números desconectados, usa Listar cuentas.
Ejemplo rápido#
curl -X POST https://wbiztool.com/api/v1/whatsapp-client/list/ \
-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-client/list/",
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 number in result["whatsapp_clients"]:
print(number["whatsapp_client_id"], number["whatsapp_client_number"])
else:
print("Failed:", result.get("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/list/", {
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 number of result.whatsapp_clients) {
console.log(number.whatsapp_client_id, number.whatsapp_client_number);
}
} else {
console.error("Failed:", result.message);
}<?php
$payload = [
'client_id' => 12345,
'api_key' => 'YOUR_API_KEY',
];
$ch = curl_init('https://wbiztool.com/api/v1/whatsapp-client/list/');
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 $number) {
echo $number['whatsapp_client_id'] . ' ' . $number['whatsapp_client_number'] . 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.
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.
Usar los clientes oficiales#
El cliente de Python llama a este endpoint por ti.
from wbiztool_client import WbizToolClient
client = WbizToolClient(api_key="YOUR_API_KEY", client_id=12345)
result = client.list_whatsapp_clients()
for number in result.get("whatsapp_clients", []):
print(number["whatsapp_client_id"], number["whatsapp_client_number"])El cliente de Python lanza requests.exceptions.HTTPError cuando la API devuelve HTTP 400 o 403, así que envuelve la llamada en un try/except.
getWhatsAppClients() del cliente de Node.js llama a una dirección que no existe y falla con un 404. Usa fetch como en el Ejemplo rápido.
Respuesta#
Una solicitud correcta devuelve HTTP 200:
{
"message": "okay",
"whatsapp_clients": [
{
"id": 678,
"whatsapp_client_id": 678,
"whatsapp_client_number": "919876543210",
"is_connected": true
}
],
"status": 1
}
| Campo | Tipo | Descripción |
|---|---|---|
status | integer | 1 si todo va bien, 0 si la solicitud falló. |
message | string | okay si todo va bien; en caso contrario, el error. |
whatsapp_clients | array | Tus números conectados. Vacío si no hay ninguno conectado. 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[].id | integer | El mismo valor que whatsapp_client_id. |
whatsapp_clients[].whatsapp_client_number | string | El número de teléfono tal como se guardó cuando se agregó el número. |
whatsapp_clients[].is_connected | boolean | Siempre true, porque solo se listan los números conectados. |
La lista no sigue ningún orden garantizado. Ordénala por whatsapp_client_id si el orden importa.
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. |
Una solicitud que no sea POST devuelve un objeto vacío {}. Un problema inesperado del servidor devuelve HTTP 500 con un cuerpo HTML, así que comprueba que la respuesta sea JSON antes de leer status.
Consejos#
- Lista vacía:
"whatsapp_clients": []significa que no hay ningún número conectado en este espacio de trabajo. Conecta uno en la configuración de WhatsApp o con Conectar un número. - 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.
- Un solo número: para comprobar un único número, usa Estado de conexión.
