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 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.
- En Proxy de conexión administrado, mantén Automática (recomendada) o elige un país disponible.
- Configura las demás opciones y haz clic en Crear canal de WhatsApp Web.
- 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.
- 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.
- 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.