Visión general
Al elegir Proxy de conexión gestionado, con la función habilitada, la plataforma reserva una ruta antes de crear la bandeja. Las credenciales de los proveedores quedan bajo control del operador y nunca se muestran a administradores de la cuenta ni a agentes.
También puedes elegir Sin proxy (conexión directa) desde el inicio. La bandeja usa entonces la IP del servidor de conexión de WhatsApp Web. Esta elección se conserva tras la vinculación y las comprobaciones automáticas; para usar un proxy después, cambia explícitamente la ruta en la pestaña Conexión.
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 reemplazo, la política guardada decide entre retener la conexión y usar una salida directa temporal.
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 ConversaLabs.
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 sonbrd.superproxy.ioy el puerto44445(las cuentas antiguas y el Proxy Manager siguen usando el33335; 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
- Ve a Configuración → Bandejas de entrada → Añadir bandeja → WhatsApp Web.
- Escribe el nombre de la bandeja.
- Elige Proxy de conexión gestionado y mantén la región automática o selecciona un país disponible. Para usar la IP del servidor de conexión, elige Sin proxy (conexión directa).
- Configura las demás opciones y haz clic en Crear canal de WhatsApp Web.
- Si el proxy elegido se queda sin capacidad, la creación informa del fallo. Pide al operador que restaure la ruta o vuelve y elige explícitamente Sin proxy si deseas conexión directa.
- Cuando se confirme la reserva, haz clic en Conectar WhatsApp y vincula por QR o código de teléfono.
- 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:
- Abre Configuración → Bandejas de entrada → tu bandeja → Conexión.
- En la tarjeta de ruta de red, elige Sin proxy (salida directa).
- 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.
- Política guardada: las políticas de retención conservan la ruta. Solo la política que permite salida directa usa el servidor temporalmente cuando falta capacidad de proxy.
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 siguen su política de fallback guardada.
- 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. Para usar proxy, espera la recuperación. Para usar la IP del servidor de conexión, elige explícitamente Sin proxy en el asistente.
- 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 ConversaLabs 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 sigue su política de fallback guardada.
Recuperación temporal de la ruta
Servidor (salida temporal) indica que la política guardada permite usar la IP del servidor mientras se recupera la capacidad de proxy. Se diferencia de elegir Sin proxy, una preferencia permanente hasta que la cambies. Los reintentos usan intervalos crecientes, visibles en Conexión → Ruta de salida, y vuelven al proxy administrado cuando hay capacidad.
El cambio de ruta y la conexión de WhatsApp se confirman por separado. Si el gateway pierde una respuesta, el panel muestra la ruta deseada, aplicada y observada mientras espera confirmación. Sin lectura de la ruta, el estado permanece sin confirmar. No elimines la bandeja ni vincules otro número para corregir un fallo temporal: la reconexión suave conserva el dispositivo vinculado. Solo hace falta vincular de nuevo cuando WhatsApp termina realmente la autorización o tú lo solicitas explícitamente.