Skip to main content
POST
Reconectar Instância
Auth: TokenAccount ou TokenInstanceRate-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

Resposta de sucesso

200 OK
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

string
obrigatório
Nome da instância.

Headers

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

Erros

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.