## Visión general

Cuando la función **Proxy administrado de WhatsApp Web** está habilitada, Conversa Labs reserva una ruta
de proxy antes de crear la bandeja. Las credenciales de los proveedores quedan bajo control del operador
de la plataforma y nunca se muestran a administradores de la cuenta ni a agentes.

**Automática** es la opción recomendada. La plataforma selecciona una ruta saludable usando región,
prioridad del proveedor, latencia y capacidad. Después de vincular, el código de país (DDI) del teléfono
puede provocar una única reconexión suave para ajustar la región. La asignación permanece fija para la
bandeja y los gateways residenciales usan una identidad de sesión persistente.

El flujo es **fail-closed**: si ningún proxy saludable tiene capacidad, la creación se bloquea antes de
la vinculación. La bandeja nunca se conecta directamente sin avisar. Ante un fallo posterior, el
failover intenta otra ruta aprobada; sin un reemplazo seguro, la sesión queda retenida.

## Requisitos previos

- El operador de la plataforma agregó y probó al menos una conexión de proxy activa.
- La función **Proxy administrado de WhatsApp Web** está habilitada para tu cuenta.
- Un administrador de la cuenta puede crear una bandeja de WhatsApp Web.
- El teléfono está disponible para escanear el QR o introducir el código de vinculación.

Los únicos proveedores aceptados son Webshare, Bright Data y un endpoint personalizado proporcionado
conscientemente por el operador. La compra y la administración del plan ocurren fuera de Conversa Labs.

Credenciales por proveedor:

- **Webshare**: una API key puede sincronizar automáticamente el inventario de proxies estáticos; el modo
  gateway/backbone puede usar el usuario y la contraseña nativos del proxy. Usa el tipo de credencial
  compatible con el modo contratado.
- **Bright Data**: usa el usuario de la Zone, como `brd-customer-...-zone-...`, y la contraseña de la
  Zone en **Proxies → Access details**. **No uses una API key de la REST API.** En modo HTTP, los valores
  predeterminados son `brd.superproxy.io` y el puerto `44445` (las cuentas antiguas y el Proxy Manager siguen usando el
  `33335`; si la prueba de conexión falla en uno, prueba el otro).
- **Personalizado**: el operador proporciona protocolo, host, puerto, capacidad/región y, cuando sea
  necesario, usuario y contraseña. Registra solo endpoints controlados y confiables.

## Paso a paso

1. Ve a **Configuración → Bandejas de entrada → Añadir bandeja → WhatsApp Web**.
2. Escribe el nombre de la bandeja.
3. En **Proxy de conexión administrado**, mantén **Automática (recomendada)** o elige un país disponible.
4. Configura las demás opciones y haz clic en **Crear canal de WhatsApp Web**.
5. Si la plataforma informa que no hay una ruta segura, no continúes en modo directo. Pide al operador
   que recupere la capacidad e inténtalo de nuevo.
6. Cuando se confirme la reserva, haz clic en **Conectar WhatsApp** y vincula por QR o código de teléfono.
7. Después de vincular, la plataforma confirma el DDI y ajusta la región cuando es necesario. Esto no
   crea otra bandeja.

### Volver a la salida directa (sin proxy)

Una bandeja que ya está en un proxy administrado puede volver a salir por la IP del propio servidor:

1. Abre **Configuración → Bandejas de entrada → tu bandeja → Conexión**.
2. En la tarjeta de ruta de red, elige **Sin proxy (salida directa)**.
3. Haz clic en **Usar salida directa**. La reserva de proxy se libera y el gateway sale directamente.

La opción sigue disponible incluso si el recurso de proxy se desactiva después en la cuenta; de lo
contrario la bandeja quedaría atrapada en la ruta anterior. Una bandeja enrutada por **dispositivo
propio** no puede volver a la salida directa desde aquí: el gateway solo deshace esa ruta eliminando la
sesión, lo que desconecta WhatsApp.

## Configuración y opciones

- **Automática**: elige la mejor ruta saludable usando geografía, prioridad, salud, latencia y capacidad.
- **Selección de país**: solicita una región. Puede elegirse otra región aprobada si la preferida no está
  disponible; sin ninguna ruta segura, la creación se bloquea.
- **Asignación fija**: un endpoint estático o dedicado permanece reservado para la bandeja.
- **Gateway persistente**: los proveedores rotativos/residenciales reciben una identidad de sesión
  estable para la bandeja.
- **Failover automático**: los fallos repetidos de salud mueven la bandeja a otro endpoint aprobado. Un
  tiempo de espera evita cambios rápidos de ruta.
- **Retención segura**: si el pool aprobado no está disponible, la conexión queda retenida; no existe
  fallback directo automático.

## Casos de uso

- Mantener la sesión de WhatsApp Web cerca del país del número.
- Dar a cada bandeja una IP dedicada estable o una identidad residencial persistente.
- Distribuir muchas bandejas entre suscripciones aprobadas sin exponer credenciales.
- Hacer failover entre rutas confiables sin permitir salida directa silenciosa.

## Consejos, límites y buenas prácticas

- Prefiere endpoints estables, dedicados/estáticos cuando el proveedor los ofrezca. Evita cambios
  innecesarios de región o identidad.
- Un proxy mejora el aislamiento de la ruta, pero no elude las políticas de WhatsApp, los límites de
  mensajes ni los controles de calidad de la cuenta.
- Nunca pegues credenciales del proveedor en el asistente de la bandeja. Los administradores de la
  cuenta solo eligen la preferencia de enrutamiento.
- En Bright Data, la contraseña necesaria es la de la **Zone de proxy**, no la contraseña de la cuenta ni
  una API key.
- En Webshare, revoca inmediatamente cualquier API key expuesta en una captura de pantalla, chat o log.
- Si eliges un país manualmente, usa el país donde se opera normalmente el número.
- Pausar un proveedor impide nuevas asignaciones. Sin un reemplazo aprobado, las rutas afectadas quedan
  retenidas.
- En una **bandeja híbrida** (WhatsApp Web emparejado con Cloud), la ruta solo se aplica al tráfico
  que sale por WhatsApp Web. Los mensajes enviados por la API de Cloud salen siempre por la IP del
  propio servidor, sea cual sea el proxy elegido. La ruta se gestiona en la pestaña **Conexión** de
  la bandeja WhatsApp Web del par — la pestaña **Híbrido** de la bandeja Cloud muestra la ruta actual
  y enlaza allí.

## Solución de problemas

- **La sección de proxy no aparece**: pide al operador que habilite la función para tu cuenta.
- **No aparecen países**: el inventario puede estar sincronizándose o no tener capacidad saludable.
  Espera la recuperación; la creación no usará una conexión directa.
- **La creación se bloqueó porque no había ruta**: es intencional. El operador debe probar credenciales,
  salud, capacidad y regiones del proveedor antes de intentarlo otra vez.
- **Bright Data solicita credenciales**: copia el usuario y la contraseña de la Zone desde
  **Proxies → Access details**. No crees una API key para este adaptador.
- **Webshare no sincroniza proxies estáticos**: confirma la API key y el plan seleccionado. Para el modo
  gateway/backbone, revisa usuario, contraseña, host y puerto nativos.
- **Falla un endpoint personalizado**: revisa protocolo, DNS/host, puerto, autenticación, capacidad y si
  el servidor de Conversa Labs puede alcanzarlo de forma segura.
- **La sesión se reconecta una vez después de vincular**: el DDI difiere de la estimación inicial y la
  ruta se ajustó. Es normal.
- **Desconexiones repetidas**: revisa la salud de los proveedores. El failover usa solo endpoints
  aprobados; si todos están offline, la bandeja queda retenida.

## Ver también

- [Conectar WhatsApp Web por emparejamiento de QR](/hc/ajuda/articles/inboxes-channels-whatsapp-web-wazmeow-es)
- [Bandeja híbrida de WhatsApp](/hc/ajuda/articles/inboxes-channels-whatsapp-hybrid-inbox-es)
- [WhatsApp Inbox Suite](/hc/ajuda/articles/inboxes-channels-whatsapp-inbox-suite-es)