> For the complete documentation index, see [llms.txt](https://developers.oxylabs.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.oxylabs.io/products/es/headless-browser/troubleshooting-guide.md). # Guía de solución de problemas | Síntoma | Causa probable | Solución | | ------------------------------------------------------------------------- | ------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------- | | *401 credenciales inválidas (las credenciales son correctas)* | Usando `ws://` esquema | Cambia a `wss://` | | *401 credenciales inválidas* | Sin `nombre de usuario` sin sufijo | Usa el nombre de usuario completo con el token de sufijo del panel (p. ej., `_ab12`) | | *CDP\_SESSION\_RATE\_LIMIT\_REACHED* | Estás intentando iniciar demasiados navegadores por segundo | Mantente dentro del `10` límite de sesiones por segundo o [contacta con soporte](#need-a-feature-enabled-1) para aumentar el límite. | | *CDP\_MAX\_CONCURRENT\_SESSIONS\_REACHED* | Tu número de sesiones activas alcanzó el límite | Mantente por debajo de `100` el total de sesiones concurrentes o [contacta con soporte](#need-a-feature-enabled-1) para aumentar el límite. | | *Inspección de sesión (VNC) no puede conectarse (el navegador se inicia)* | Se alcanzó el límite máximo de VNC | Usa menos sesiones VNC. | | *Error de TLS / certificado* | Validación de certificados en Node.js | Establece `NODE_TLS_REJECT_UNAUTHORIZED="0"` antes de requerir Playwright (solo pruebas). | | *CDP\_LIMIT\_REACHED: límite de perfiles alcanzado* | `o_profile` el recuento supera `max_profiles` | Reutiliza un nombre de perfil estable o contacta con soporte para aumentar el límite. | | *400 session\_name debe tener 3-36 caracteres alfanuméricos o '-'* | Guion bajo o caracteres no válidos en `session_name` | Usa solo letras, dígitos y guiones (`[A-Za-z0-9-]`). | | *Perfil restaurado, pero cookies están vacías* | La IP de salida cambió entre sesiones | Fija `proxy_resi_ses_id` + `proxy_resi_ses_time` con valores idénticos en cada sesión. | | *Bloqueo de inicio de sesión / baja tasa de éxito* | Reputación de IP, geolocalización incorrecta o desajuste del motor | Establece `p_cc` (+ `p_city`), prueba con otro `p_device`, o vuelve a intentarlo en una sesión nueva. | | *Objetivo bloqueado por completo* | Categoría de objetivo restringida | Completa el KYC a través de tu Dedicated Account Manager. | {% hint style="info" %} ¿Sigues atascado? Contacta con el soporte de Oxylabs por chat en vivo o correo electrónico (). {% endhint %} Si experimentas un comportamiento inesperado o bajas tasas de éxito, considera los siguientes pasos: ### **Entiende nuestro proceso de manejo de CAPTCHA** Familiarízate con nuestros [métodos de manejo de CAPTCHA](broken://pages/312be760a143137b9a3208fd14a0b45068ee4c94) y su uso. Esto puede dar una idea de si los desafíos CAPTCHA son la causa del problema. ### **Usa el parámetro de país** Especificar un parámetro de país en tus solicitudes puede aumentar significativamente las tasas de éxito. Esto garantiza que tus solicitudes se enruten a través de IPs de una ubicación geográfica específica, filtrando IPs de ubicaciones aleatorias o potencialmente menos fiables. Puedes especificar un país para tu sesión de navegador añadiendo el `?p_cc` parámetro a la URL de conexión. Más información se puede encontrar en la sección [Segmentación por geolocalización](broken://pages/f55ffd451f17f696401c328422f25557f95edcc3). ### **Usa el parámetro de tipo de dispositivo** Experimentar con un parámetro de dispositivo puede resultar en tasas de éxito más altas. Puedes personalizar cómo el navegador emula distintos tipos de dispositivo usando el `?p_device` parámetro. Más información se puede encontrar en [Tipo de dispositivo](https://developers.oxylabs.io/scraping-solutions/unblocking-browser/chrome#device-type) sección. {% hint style="info" %} Si los problemas persisten después de probar estos pasos, contacta a tu Dedicated Account Manager con los detalles del problema y los pasos que ya has tomado. {% endhint %} ## ¿Necesitas habilitar una función? Algunas funciones de Headless Browser están desactivadas o restringidas por defecto. Para acceder a ellas, contacta con el soporte de Oxylabs ([chat en vivo](https://oxylabs.io/) o [correo electrónico](mailto:support@oxylabs.io)) o tu Dedicated Account Manager: * **Perfiles persistentes** – aumenta el `max_profiles` límite. * **Objetivos restringidos** – desbloquea más categorías de objetivo mediante el proceso KYC. * **Límites de tasa más altos** – aumenta por encima de `100` sesiones concurrentes / `10` por segundo. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://developers.oxylabs.io/products/es/headless-browser/troubleshooting-guide.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.