> ## 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 conectar WhatsApp por código QR

> Lee el código QR con el celular de la empresa, o envía un enlace de conexión a quien tiene el aparato.

## Para qué sirve

Vincular el número de WhatsApp de la empresa a STChat. Después, las conversaciones llegan a Conversaciones y el equipo responde desde el sistema.

La conexión es parecida a la de WhatsApp Web: lees un código QR con el celular de la empresa.

## Quién puede

El Dueño y el Admin de la organización conectan. Los demás roles ven el aviso "Solo el Dueño o un gerente puede conectar. Avisa a quien administra la cuenta."

Quien asigna el número (la "bandeja") a la organización es la agencia. Si aparece "Falta un número libre para conectar", pide a la agencia que libere uno.

## Dónde hacer clic

* En **Conversaciones**, si la organización todavía no tiene ninguna instancia vinculada por la agencia, la pantalla muestra "Ningún canal habilitado todavía" y **no muestra el QR**. El QR solo aparece después de que la agencia vincula un cupo a la organización.
* En **Ajustes › Canales**, el botón **Conectar canal** abre la elección del canal: "Elige el canal. WhatsApp pide el número; los otros abren el panel del canal, donde la agencia conecta la cuenta."
* En **Ajustes › Canales**, en la fila de WhatsApp, usa **Conectar** (o **Reconectar**, si ya estuvo conectado).

## Paso a paso

**1. Abre WhatsApp en el celular de la empresa**

Toca ⋮ › **Dispositivos vinculados** › **Vincular un dispositivo**.

**2. Apunta la cámara al código**

El código cambia cada 20 segundos. Si vence, aparece "El código venció": toca **Generar código nuevo**. También puedes usar **Actualizar código**.

**3. Espera a que termine**

Aparece "Conectando…" y "Código leído". Deja WhatsApp abierto en el celular hasta que termine.

### ¿El celular no está contigo?

**1. Pide el enlace**

Haz clic en **¿El celular no está aquí? Enviarle el enlace**.

**2. Indica el WhatsApp del celular de la empresa**

Completa el campo **WhatsApp del celular de la empresa** y haz clic en **Enviar enlace**.

**3. Quien tiene el celular abre el enlace**

La persona toca Conectar y listo. No necesita entrar al sistema ni tener contraseña.

El enlace se envía por el WhatsApp de la agencia, vale 15 minutos y solo funciona una vez. Abre una página pública (`/conectar/...`) con el QR y los pasos. En el celular, la página también ofrece un código para escribir, en **Conectar con número de teléfono**.&#x20;

## Qué pasa después

Aparece "¡Listo! WhatsApp conectado". Las conversaciones nuevas llegan a Conversaciones y se traen las últimas de los 7 días. En el flujo de la primera vez, el botón **Continuar la Primera semana** lleva al siguiente paso.

En la pantalla de quien envió el enlace, aparece "Enlace enviado a..." y la pantalla cambia sola cuando la persona conecta. Si hace falta, usa **Reenviar** o **Mostrar el código**. La hora del envío y de la validez aparece en la zona horaria de tu navegador.

## Errores comunes

* "Este enlace ya fue usado": solo vale una vez. Pide uno nuevo.
* "Este enlace venció": el enlace de conexión vale 15 minutos. Pide uno nuevo a la agencia.
* "Este enlace ya está abierto en otro navegador": por seguridad, solo funciona en el navegador que lo abrió primero.
* "Enlace no encontrado": revisa la dirección o pide otro.
* "No se pudo generar el código": puede ser el internet o WhatsApp fuera de servicio. Usa **Intentar de nuevo**.
* "Este número ya está conectado": no hace falta leer el QR otra vez.
* "La agencia no tiene un WhatsApp para enviar el enlace": usa **Copiar el enlace** y envíalo tú mismo.&#x20;
* "El enlace se creó, pero WhatsApp no lo envió": igual, cópialo y envíalo.&#x20;
* "Esta bandeja usa la API Oficial: reconecta por Meta en Ajustes › Canales": el QR no sirve para ella.

## Siguiente paso

* [WhatsApp Oficial](https://docs.stchat.app/es/subcontas/whatsapp-oficial.md)
* [La pantalla de Canales](https://docs.stchat.app/es/subcontas/tela-de-canais.md)
* [Calentamiento del número](https://docs.stchat.app/es/subcontas/aquecimento-do-numero.md)
* [Canal desconectado](https://docs.stchat.app/es/subcontas/canal-desconectado.md)


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