Saltar al contenido
Wbiztool

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.

POSThttps://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
  }'

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_idintegerobligatorio

Tu ID de cliente de la API, de Configuración → Claves API.

api_keystringobligatorio

Tu clave API, de esa misma página.

whatsapp_clientintegerobligatorio

ID del número de WhatsApp que quieres comprobar, de la configuración de WhatsApp, de Listar cuentas o el whatsapp_client_id que devuelve Conectar un número.

Usar los clientes oficiales#

El cliente de Python llama a este endpoint por ti.

Python
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 }
CampoTipoDescripción
statusinteger1 si el número está conectado. 0 si no está conectado o si la solicitud falló.
messagestringConnected, Disconnected o el error.

Un número que eliminaste en la configuración de WhatsApp también devuelve Disconnected.

Errores#

MensajeHTTPCómo solucionarlo
Auth Error200Enví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 Id403Envía client_id como número entero, por ejemplo 12345.
Auth Error: invalid api key400Comprueba que la clave existe, que no se ha eliminado y que pertenece a este client_id.
Auth Error 2200Ese ID de whatsapp_client no está en el espacio de trabajo de esta clave API.
Demo Account can not access apis200Usa 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 webhook connected puede llegar unos segundos antes de que este endpoint devuelva Connected, 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.