Introducción

WSPerú es una API REST de WhatsApp: conectas una línea escaneando un QR desde el panel y envías mensajes desde tu sistema con simples requests HTTP.

Base URL

https://api.wsperu.dev

El alias histórico https://ws.apiperu.dev/api sigue funcionando de forma permanente para integraciones existentes.

Inicio rápido

1. Crea tu cuenta (el plan Gratuito incluye 1 línea y 100 mensajes/día)
2. En el panel, crea una sesión y escanea el QR con el WhatsApp del número emisor
3. Copia tu API Key (panel → Cuenta)
4. Envía tu primer mensaje:

curl -X POST https://api.wsperu.dev/messages/send/text \
  -H "x-api-key: TU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"to": "51912345678", "text": "Hola desde WSPerú 👋"}'

Respuesta:

{
  "messageId": "665f1c2e9b8a4a0012345678",
  "status": "queued",
  "jobId": "1234"
}

Los mensajes se encolan y se envían con delays automáticos anti-bloqueo. Puedes consultar el estado con GET /messages/{id}/status o recibirlo por webhook.

Conceptos

Concepto	Descripción
Sesión (línea)	Un número de WhatsApp conectado por QR. Tu plan define cuántas puedes tener
API Key	Credencial de tu cuenta (x-api-key). Puedes restringirla por IP o dominio desde el panel
Cola	Todo envío pasa por una cola con delays aleatorios entre mensajes (anti-ban)
Webhook	URL tuya donde te notificamos eventos (entrega, mensajes entrantes, estado de sesión)