Pular para o conteúdo principal
POST
/
api
/
instance
/
reconnect
/
:instance
Reconectar Instância
curl --request POST \
  --url https://api.example.com/api/instance/reconnect/:instance \
  --header 'token: <token>'
Auth: TokenAccount ou TokenInstance • Rate-limit: Global (100/min) • Idempotente: parcial

​
Descrição

Reutiliza a sessão whatsmeow já armazenada para restabelecer a conexão sem novo QR/pairing. Funciona se a instância já foi conectada pelo menos uma vez (sessão salva no whatsmeow_device).

​
Exemplo

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

​
Resposta de sucesso

200 OK
{
  "success": true,
  "message": "Reconnect initiated",
  "status": "connecting"
}
Após a chamada, faça poll de GET /api/instance/list?instanceName=<nome> para detectar quando o estado virar connected. O evento instance.state também é emitido via webhook/WebSocket.

​
Path parameters

​
instance
string
obrigatório
Nome da instância.

​
Headers

​
token
string
obrigatório
TokenAccount ou TokenInstance.
Body é aceito mas ignorado, pode enviar vazio.

​
Erros

HTTPerror.messageQuando
400Instance has no saved session, call /connect firstNão há sessão para reutilizar (instância nunca conectou ou foi deslogada).
401Invalid tokenToken ausente ou inválido.
404Instance not foundNome não existe.
429Rate limit exceeded. Try again later.Mais de 100 req/min.
500Failed to reconnect: <reason>Falha em Connect() (rede, proxy, DNS).
{
  "success": false,
  "error": {
    "message": "Instance has no saved session, call /connect first"
  }
}

​
Notas

Diferença para connect: connect sempre (re)cria um cliente novo e gera QR/pairing. reconnect reutiliza sessão existente, não funciona se a instância nunca foi conectada ou foi deslogada do lado do celular.
Se o WhatsApp deslogou o dispositivo (estado loggedout), o reconnect falha com 400. Use connect para gerar um novo QR.

​
Próximo

Conectar (QR/pairing)

Para reconectar quando a sessão foi perdida.

Logout

Desliga o dispositivo no WhatsApp mantendo a instância.