API de cuentas de WhatsApp
API de estado de conexión de WhatsApp
Comprueba si uno de tus números de WhatsApp está conectado y listo para enviar mensajes. Úsalo antes de una campaña o mientras esperas a que termine de vincularse un número recién conectado. Usa este endpoint en lugar de /api/v1/whatsapp/status/<id>/, que no funciona.
https://wbiztool.com/api/v1/whatsapp-client/status/Cuerpo: JSON o campos de formulario
Ejemplo rápido#
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');
}Sustituye 12345, YOUR_API_KEY y 678 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.
whatsapp_clientintegerobligatorioID del número de WhatsApp que quieres comprobar, de la configuración de WhatsApp, de Listar cuentas o el
whatsapp_client_idque devuelve Conectar un número.
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.get_whatsapp_client_status(678)
print(result)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.
getWhatsAppClientStatus() 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#
Cuando tus credenciales son válidas, la solicitud devuelve HTTP 200 con uno de estos cuerpos.
El número está conectado:
{ "message": "Connected", "status": 1 }
El número no está conectado:
{ "message": "Disconnected", "status": 0 }
| Campo | Tipo | Descripción |
|---|---|---|
status | integer | 1 si el número está conectado. 0 si no está conectado o si la solicitud falló. |
message | string | Connected, Disconnected o el error. |
Un número que eliminaste en la configuración de WhatsApp también devuelve Disconnected.
Errores#
| Mensaje | HTTP | Cómo solucionarlo |
|---|---|---|
Auth Error | 200 | Envía client_id, api_key y un whatsapp_client numérico 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. |
Auth Error 2 | 200 | Ese ID de whatsapp_client no está en el espacio de trabajo de esta clave API. |
Demo Account can not access apis | 200 | Usa una cuenta normal. |
Consejos#
- Antes de enviar: si el número desde el que envías está desconectado, sus mensajes esperan en la cola hasta que se vuelva a conectar o hasta que caduquen, así que comprueba el estado antes de hacer envíos grandes. Los mensajes no enviados en un número desconectado se eliminan después de 90 días.
- Después de conectar un número: consulta este endpoint cada pocos segundos hasta que devuelva
Connected. El webhookconnectedpuede llegar unos segundos antes de que este endpoint devuelvaConnected, así que sigue consultando durante hasta un minuto después del evento. Consulta Conectar un número. - Todos los números a la vez: para obtener el estado de todos los números en una sola llamada, usa Listar cuentas.
