Skip to main content
POST
Reconectar instancia
Auth: TokenAccount o TokenInstanceRate-limit: Global (100/min) • Idempotente: parcial

Descripción

Reutiliza la sesión whatsmeow ya almacenada para restablecer la conexión sin un nuevo QR/pairing. Funciona si la instancia se ha conectado al menos una vez (sesión guardada en whatsmeow_device).

Ejemplo

Respuesta exitosa

200 OK
Después de la llamada, haz polling a GET /api/instance/list?instanceName=<name> para detectar cuando el estado pase a connected. El evento instance.state también es emitido vía webhook/WebSocket.

Parámetros de ruta

string
requerido
Nombre de la instancia.

Cabeceras

string
requerido
TokenAccount o TokenInstance.
El body es aceptado pero ignorado, puedes enviarlo vacío.

Errores

Notas

Diferencia con connect: connect siempre (re)crea un nuevo cliente y genera QR/pairing. reconnect reutiliza una sesión existente, no funciona si la instancia nunca se conectó o se hizo logout desde el lado del teléfono.
Si WhatsApp deslogueó el dispositivo (estado loggedout), reconnect falla con 400. Usa connect para generar un nuevo QR.

Siguiente

Conectar (QR/pairing)

Para reconectar cuando la sesión se ha perdido.

Logout

Desloguea el dispositivo de WhatsApp manteniendo la instancia.