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: Webhooks (2)

← Ver todos
POST /api/webhook_configurar.php

Configurar webhook del cliente

Configura la URL del webhook donde se recibiran los eventos del cliente (mensajes recibidos, estados).

Webhooks Ver documentacion →
GET | POST | DELETE /api/webhook.php

Webhook del cliente (CRUD)

GET lee la config. POST crea/actualiza (UPSERT). DELETE elimina el webhook. Aplica a TODA la cuenta del cliente, no a un celular especifico. Eventos disponibles: messages.received, message.status, session.status, all.

Webhooks 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