API REST de WhatsApp

Envia mensajes, administra celulares, configura webhooks y consulta saldo. 30 endpoints REST, ejemplos en 8 lenguajes, listo para produccion.

Ver los 30 endpoints Guia para principiantes
¿Necesitas administrar la cuenta desde tu sistema? Revisa la seccion Info y Saldo, Gestion de Celulares (incluye generacion de QR) y Webhooks. Todo via API, sin entrar al panel.
¿Tu sistema es antiguo? Si vienes del proyecto previo (multi_clientes / multi_lineas) o tienes integraciones legacy que envian mensajes via form-encoded, revisa la documentacion del endpoint legacy /panel/api_wa.php → (mismo contrato, ejemplos en PHP, cURL, Python y Node.js).

Pruebalo rapido

Importar en Postman

Coleccion lista con todas las requests, environments y variables. Importala y en 2 minutos tienes tu primera llamada.

Spec OpenAPI 3.0

Descarga la spec y usala para generar SDKs en cualquier lenguaje, validar tests, o explorar con Swagger UI.

REST simple

Endpoints HTTP estandar. POST/GET con form-data. JSON de respuesta. Sin SDK requerido.

Webhooks en tiempo real

Recibe eventos cuando un mensaje se entrega, se lee, o llega una respuesta. Configurable por cliente.

Rate limit manejable

Hasta 256 msg/min por celular. Errores 429 con retry_after explicito. Backoff automatico recomendado.

Auth por API key

Una key por celular. HMAC-SHA256 firmada. Rotable desde el panel. Logs de auditoria.

Proteccion anti-baneo incluida

WhatsApp suspende cuentas que envian mensajes identicos en bucle. Por eso la API incluye 3 capas automaticas para mantener tu numero seguro:

Cola humanizada

Por default los mensajes se encolan y se envian ~1 cada 5s. 1000 mensajes no llegan de golpe, se distribuyen en el tiempo. Asi WhatsApp no detecta patron de spam.

Anti-duplicado inteligente

El mismo mensaje (mismo texto + mismo destinatario + mismo celular) 3 veces en 2 minutos = bloqueo 5 min. Proteccion por cliente, no global. Evita loops accidentales.

Modo directo opcional

Para tiempo real (2FA, chatbots, alertas), envia directo=1. La API llama a WhatsApp al instante y registra como enviado. Ideal para codigos OTP.

30+ paises auto-detectados

El campo destinatario acepta cualquier formato. Mexico, USA, Espana, Argentina, Brasil, UK, China, Japon y mas. Normalizacion automatica a E.164.

Regla de oro: personaliza cada mensaje. Usa el nombre del destinatario, una clave de pedido, la fecha, o un contador. Cada mensaje que envies debe ser UNICO. Asi te proteges del baneo automatico de WhatsApp y de nuestra proteccion anti-duplicado.

Ver detalles tecnicos de proteccion →

Categoria: Administracion (9)

← Ver todos
GET /api/info.php

Info del cliente

Devuelve la ficha del cliente asociado a la API key: nombre, email, plan, max_celulares, saldo_global, num_celulares, mensajes ultimos 30 dias.

Administracion Ver documentacion →
GET /api/saldo.php

Consultar saldo

Devuelve el saldo global del cliente y el saldo del celular asociado a la API key.

Administracion Ver documentacion →
GET /api/celulares.php

Listar celulares

Lista todos los celulares del cliente con su estado, saldo, configuracion de rate limit y horario.

Administracion Ver documentacion →
GET /api/celular.php

Detalle de un celular

Devuelve el detalle completo de un celular por su id.

Administracion Ver documentacion →
POST /api/celular_crear.php

Crear celular

Crea un celular nuevo en estado desconectado. Para vincularlo con WhatsApp via QR, llamar despues a /api/celular_qr.php?id=N

Administracion Ver documentacion →
POST /api/celular_editar.php

Editar celular

Edita uno o varios campos de un celular. Solo se actualizan los campos enviados.

Administracion Ver documentacion →
POST /api/celular_eliminar.php

Eliminar celular (hard delete)

Elimina el celular junto con todos sus mensajes, entrenamientos y movimientos de saldo. Genera un snapshot JSON forense en la auditoria antes de borrar. Tambien desconecta la session de WhatsApp (best effort).

Administracion Ver documentacion →
POST /api/celular_qr.php

Generar QR de vinculacion

Genera o recupera el QR para vincular el WhatsApp. Si el celular no tiene session, crea una automaticamente. Devuelve el string del QR que debes convertir a imagen con una libreria qrcode (cliente JS o Python) y mostrar al usuario para que lo escanee desde WhatsApp.

Administracion Ver documentacion →
GET /api/celular_status.php

Status de la sesion WhatsApp

Consulta el status actual de la sesion de WhatsApp del celular segun el proveedor. Actualiza la BD local.

Administracion Ver documentacion →

¿Listo para empezar?

Crea tu cuenta, vincula tu WhatsApp con QR y envia tu primer mensaje en menos de 5 minutos.

Ir al portal del cliente Contactar soporte