Sesiones (líneas)

Una sesión es un número de WhatsApp conectado a tu cuenta. El límite de sesiones lo define tu plan.

Listar sesiones

GET /sessions

{
  "data": [
    {
      "_id": "665f...",
      "name": "Ventas",
      "status": "connected",
      "phone": "51912345678",
      "lastUsed": "2026-08-12T15:04:05.000Z"
    }
  ]
}

Estados posibles: initializing · qr · pairing · connected · disconnected · logged_out

Crear sesión

POST /sessions

{ "name": "Ventas" }

Opcional: "pairingPhone": "51912345678" para vincular por código de emparejamiento en vez de QR.

Obtener QR / código de emparejamiento

GET /sessions/{id}/qr

{ "status": "qr", "qr": "data:image/png;base64,...", "pairingCode": null }

Muestra el QR al usuario para escanearlo con WhatsApp (Dispositivos vinculados). El QR rota — consulta este endpoint cada pocos segundos hasta que status sea connected.

Estado de la sesión

GET /sessions/{id}/status

Verificar un número

Comprueba si un número tiene WhatsApp antes de enviarle:

POST /sessions/{id}/check-number

{ "number": "51987654321" }

{ "data": { "exists": true, "jid": "51987654321@s.whatsapp.net" } }

Control de la sesión

Endpoint	Efecto
POST /sessions/{id}/reconnect	Fuerza reconexión (si estaba logged_out, genera QR nuevo)
POST /sessions/{id}/disconnect	Pausa la línea — conserva la vinculación (reconecta sin QR)
POST /sessions/{id}/logout	Desvincula el dispositivo de WhatsApp (requiere QR nuevo)
DELETE /sessions/{id}	Elimina la sesión de tu cuenta