> ## 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.

# Cómo vincular una instancia a una organización

> Asigna una instancia de la agencia a un cliente, elige el tipo de canal, renombra o desvincula.

## Para qué sirve

La instancia es el espacio de conexión que la agencia asigna a una organización. Al vincular, eliges el tipo de canal. Después, el cliente conecta el canal (por ejemplo, leyendo el QR de WhatsApp).

## Quién puede

Solo el Dueño o el Admin de la agencia desvincula instancias. Dentro de **Abrir como cliente** los botones de vincular y desvincular no aparecen.

## Dónde hacer clic

Hay dos lugares:

* En la organización: **Organizaciones**, abre el cliente y entra a la pestaña **Instancias**. El botón es **Vincular instancia**.
* En la pantalla **Instancias** (`/instancias`), que muestra todas las instancias de la agencia, con las vistas Todas, Desconectadas, Inicio de sesión vencido, Bloqueadas y Libres.

## Paso a paso

**1. Abre la pestaña Instancias del cliente**

Entra a la organización y haz clic en **Instancias**.

**2. Haz clic en Vincular instancia**

Busca por "Nombre, número o @cuenta". Las instancias usadas por otra organización aparecen como **En uso**.

**3. Elige el tipo de conexión**

Para un **Espacio libre · elige el tipo**, selecciona el tipo: **WhatsApp QR**, **WhatsApp Oficial**, **Instagram** o **Perfil de Empresa de Google**. Una instancia que ya tiene tipo muestra "Esta instancia ya tiene tipo definido." Si quieres, ponle un **Nombre de la instancia (opcional)**.

**4. Haz clic en Vincular**

La instancia se crea. La pantalla muestra el **Enlace de conexión del cliente**. Usa **Copiar enlace** y envíaselo al cliente.

## Renombrar y desvincular

En el menú de acciones de la fila (**Copiar ID de la instancia**, **Copiar enlace de conexión del cliente**, **Renombrar**, **Desvincular de esta organización**):

* **Renombrar**: el nombre debe tener de 1 a 80 caracteres. Aparece "Nombre actualizado."
* **Desvincular de esta organización**: el espacio vuelve a quedar libre para la agencia, desde cero. La instancia deja de existir para la organización. Revisa el aviso de la pantalla antes de confirmar.

## Qué pasa después

La fila muestra la situación: Conectada, Desconectada, Sesión vencida, Bloqueada, Desactivada, Suspendida o Esperando la conexión del cliente. Si el módulo del canal está apagado en la organización, aparece **Módulo desactivado**: las conversaciones siguen, pero no se puede conectar ni reconectar. Consulta [Cómo habilitar módulos](https://docs.stchat.app/es/agencias/liberar-modulos.md).

## Errores comunes

* "La agencia no tiene cupo de instancia libre. Compra más instancias."
* "El cliente alcanzó el límite de instancias del plan."
* "Esta instancia ya está vinculada."
* "El tipo elegido no es el de esta instancia. Elige el tipo correcto u otro espacio."
* "Demasiados intentos. Inténtalo en unos instantes."
* "Solo el Dueño o el Admin de la agencia desvincula instancias."
* "Esta organización está en eliminación y no acepta cambios."

## Siguiente paso

* [Instancias y canales](https://docs.stchat.app/es/agencias/instancias-e-canais.md)
* [Cómo habilitar módulos](https://docs.stchat.app/es/agencias/liberar-modulos.md)
* [Cómo crear una organización](https://docs.stchat.app/es/agencias/criar-organizacao.md)


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