Saltar al contenido principal
POST
/
api
/
instance
/
reconnect
/
:instance
Reconectar instancia
curl --request POST \
  --url https://api.example.com/api/instance/reconnect/:instance \
  --header 'token: <token>'
Auth: TokenAccount o TokenInstance • Rate-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

curl -X POST "https://ryzeapi.cloud/api/instance/reconnect/my-instance" \
  -H "token: $Token_Instance"

​
Respuesta exitosa

200 OK
{
  "success": true,
  "message": "Reconnect initiated",
  "status": "connecting"
}
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

​
instance
string
requerido
Nombre de la instancia.

​
Cabeceras

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

​
Errores

HTTPerror.messageCuándo
400Instance has no saved session, call /connect firstSin sesión que reutilizar (instancia nunca conectada o se hizo logout).
401Invalid tokenToken faltante o inválido.
404Instance not foundNombre no existe.
429Rate limit exceeded. Try again later.Más de 100 req/min.
500Failed to reconnect: <reason>Falla en Connect() (red, proxy, DNS).
{
  "success": false,
  "error": {
    "message": "Instance has no saved session, call /connect first"
  }
}

​
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.