Pular para o conteúdo

Desconectar conexão

POST/tenants/{id}/connections/{connId}/disconnect

Como POST /connections/{id}/disconnect: fecha a conexão com o WhatsApp e preserva a sessão, para conectar de novo sem QR code com POST /tenants/{id}/connections/{connId}/connect. Escopo necessário: connections:write.

Ver em Markdown

Parâmetros de caminho

idstring · uuidobrigatório

Identificador do projeto (tenantId).

connIdstring · uuidobrigatório

Identificador da conexão (o número) no projeto.

Respostas

Respostas: código de status, erro e descrição
CódigoErro e descrição
200A conexão foi desconectada: {"ok": true}.
400FST_ERR_VALIDATIONid ou connId não é um UUID; message diz o que está errado.
401Sem chave de API, ou com uma chave desconhecida, revogada ou expirada. A chave de um projeto desativado também responde 401.
403A chave não tem o escopo connections:write; a mensagem de erro cita o escopo que falta.
404O projeto ou a conexão não existe, ou não é de quem chama (Tenant not found, Connection not found). A conexão precisa ser do projeto do caminho.
429Requisições demais deste IP de origem, ou autenticações com falha demais: espere os segundos de Retry-After. Veja Limites.Cabeçalho: Retry-After
503A instância do gateway que roda a conexão está mudando (um reinício, um failover) ou não responde: espere os segundos de Retry-After e tente de novo.Cabeçalho: Retry-After

Detalhes

Funciona mesmo quando a assinatura da organização não está em dia: desconectar só reduz o uso. A conexão continua ocupando um dos números contratados; para liberá-lo, exclua a conexão.

Guia: Projetos e conexões

Esta página ajudou? · Atualizado em 28 set 2026