Entrar Painel
Doc AI Friendly (agente de IA)

Desconectar Instância

Desconecta a sessão ativa do WhatsApp para a instância informada.

POST /instances/{instance_id}/disconnect

Desconectar a instância encerra a sessão ativa do WhatsApp. Para usá-la novamente, será necessário gerar e ler um novo QR Code.

Headers

Authorization string header required 06/04/2026

Token no formato Bearer <token_empresa>.

Query Parameters

instance_id string (uuid) path required 06/04/2026

ID único da instância (UUIDv7) enviado no caminho da URL.

Response Schema

application/json
success boolean required 06/04/2026

Indica se a requisição obteve sucesso.

error string | null required 06/04/2026

Mensagem de erro.

data object | null required 06/04/2026

Status resultante (pode ser null em alguns casos).

Atributos do Objeto
status enum 06/04/2026

Status da desconexão (deve retornar DISCONNECTED).

{
  "success": true,
  "data": {
    "status": "DISCONNECTED",
    "message": "Instância desconectada com sucesso."
  },
  "error": null
}