> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stchat.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Como vincular uma instância a uma organização

> Atribua uma instância da agência a um cliente, escolha o tipo de canal, renomeie ou desvincule.

## Para que serve

A instância é a vaga de conexão que a agência atribui a uma organização. Ao vincular, você escolhe o tipo de canal. Depois, o cliente conecta o canal (por exemplo, lendo o QR do WhatsApp).

## Quem pode

Só o Dono ou o Admin da agência desvincula instâncias. Dentro de **Abrir como cliente** os botões de vincular e desvincular não aparecem.

## Onde clicar

Há dois lugares:

* Na organização: **Organizações**, abra o cliente e entre na aba **Instâncias**. O botão é **Vincular instância**.
* Na tela **Instâncias** (`/instancias`), que mostra todas as instâncias da agência, com as visões Todas, Desconectadas, Login vencido, Bloqueadas e Livres.

## Passo a passo

**1. Abra a aba Instâncias do cliente**

Entre na organização e clique em **Instâncias**.

**2. Clique em Vincular instância**

Procure por "Nome, número ou @conta". Instâncias usadas por outra organização aparecem como **Em uso**.

**3. Escolha o tipo de conexão**

Para uma **Vaga livre · escolha o tipo**, selecione o tipo: **WhatsApp QR**, **WhatsApp Oficial**, **Instagram** ou **Google Meu Negócio**. Uma instância que já tem tipo mostra "Esta instância já tem tipo definido." Se quiser, dê um **Nome da instância (opcional)**.

**4. Clique em Vincular**

A instância é criada. A tela mostra o **Link de conexão do cliente**. Use **Copiar link** e envie ao cliente.

## Renomear e desvincular

No menu de ações da linha (**Copiar ID da instância**, **Copiar link de conexão do cliente**, **Renomear**, **Desvincular desta organização**):

* **Renomear**: o nome precisa ter de 1 a 80 caracteres. Aparece "Nome atualizado."
* **Desvincular desta organização**: a vaga volta livre para a agência, do zero. A instância deixa de existir para a organização. Confira o aviso da tela antes de confirmar.

## O que acontece depois

A linha mostra a situação: Conectada, Desconectada, Login vencido, Bloqueada, Desativada, Suspensa ou Aguardando conexão do cliente. Se o módulo do canal está desligado na organização, aparece **Módulo desligado**: as conversas seguem, mas não dá para conectar nem reconectar. Veja [Como liberar módulos](https://docs.stchat.app/agencias/liberar-modulos.md).

## Erros comuns

* "A agência não tem vaga de instância livre. Compre mais instâncias."
* "O cliente atingiu o limite de instâncias do plano."
* "Esta instância já está vinculada."
* "O tipo escolhido não é o desta instância. Escolha o tipo certo ou outra vaga."
* "Muitas tentativas. Tente de novo em instantes."
* "Só o Dono ou o Admin da agência desvincula instâncias."
* "Esta organização está em exclusão e não aceita mudanças."

## Próximo passo

* [Instâncias e canais](https://docs.stchat.app/agencias/instancias-e-canais.md)
* [Como liberar módulos](https://docs.stchat.app/agencias/liberar-modulos.md)
* [Como criar uma organização](https://docs.stchat.app/agencias/criar-organizacao.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.