> 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/pt-br/headless-browser/troubleshooting-guide.md). # Guia de solução de problemas | Sintoma | Causa provável | Solução | | --------------------------------------------------------------------- | --------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- | | *401 credenciais inválidas (as credenciais estão corretas)* | Usando `ws://` esquema | Mude para `wss://` | | *401 credenciais inválidas* | Puro `nome de usuário` sem sufixo | Use o nome de usuário completo com o token de sufixo do painel (por exemplo, `_ab12`) | | *CDP\_SESSION\_RATE\_LIMIT\_REACHED* | Você está tentando iniciar navegadores demais por segundo | Fique dentro do limite de `10` limite de sessões por segundo ou [entre em contato com o suporte](#need-a-feature-enabled-1) para aumentar o limite. | | *CDP\_MAX\_CONCURRENT\_SESSIONS\_REACHED* | Sua contagem de sessões ativas atingiu o limite | Fique abaixo de `100` total de sessões simultâneas ou [entre em contato com o suporte](#need-a-feature-enabled-1) para aumentar o limite. | | *Inspeção de sessão (VNC) não consegue conectar (o navegador inicia)* | Limite máximo de VNC atingido | Use menos sessões VNC. | | *Erro de TLS / certificado* | Validação de certificado no Node.js | Defina `NODE_TLS_REJECT_UNAUTHORIZED="0"` antes de usar o Playwright (somente para testes). | | *CDP\_LIMIT\_REACHED: limite de perfil atingido* | `o_profile` a contagem excede `max_profiles` | Reutilize um nome de perfil estável ou entre em contato com o suporte para aumentar o limite. | | *400 session\_name deve ter 3-36 caracteres alfanuméricos ou '-'* | Sublinhado ou caracteres inválidos em `session_name` | Use apenas letras, dígitos e hífens (`[A-Za-z0-9-]`). | | *Perfil restaurado, mas cookies estão vazios* | O IP de saída mudou entre as sessões | Fixe `proxy_resi_ses_id` + `proxy_resi_ses_time` com valores idênticos em cada sessão. | | *Barreira de login / baixa taxa de sucesso* | Reputação do IP, geolocalização incorreta ou incompatibilidade de mecanismo | Defina `p_cc` (+ `p_city`), tente outro `p_device`, ou tente novamente em uma sessão nova. | | *Destino bloqueado totalmente* | Categoria de destino restrita | Conclua o KYC por meio do seu Gerente de Conta Dedicado. | {% hint style="info" %} Ainda travado? Entre em contato com o suporte da Oxylabs via chat ao vivo ou e-mail (). {% endhint %} Se você estiver enfrentando comportamento inesperado ou baixa taxa de sucesso, considere as seguintes etapas: ### **Entenda nosso processo de tratamento de CAPTCHA** Familiarize-se com nossos [tratamento de CAPTCHA](broken://pages/4d66d426f5a90a98286d6e19538d7747a6c87731) métodos e seu uso. Isso pode fornecer uma visão sobre se os desafios de CAPTCHA são a origem do problema. ### **Use o parâmetro de país** Especificar um parâmetro de país nas suas solicitações pode aumentar significativamente as taxas de sucesso. Isso garante que suas solicitações sejam roteadas por IPs de uma localização geográfica específica, filtrando IPs de locais aleatórios ou potencialmente menos confiáveis. Você pode especificar um país para sua sessão de navegador adicionando o `?p_cc` parâmetro à sua URL de conexão. Mais informações podem ser encontradas na seção [Segmentação por geolocalização](broken://pages/b3c10d92faa156ae09af6573d4fc97e49562c939). ### **Use o parâmetro de tipo de dispositivo** Experimentar um parâmetro de dispositivo pode resultar em taxas de sucesso mais altas. Você pode personalizar como o navegador emula diferentes tipos de dispositivos usando o `?p_device` parâmetro. Mais informações podem ser encontradas em [Tipo de dispositivo](https://developers.oxylabs.io/scraping-solutions/unblocking-browser/chrome#device-type) seção. {% hint style="info" %} Se os problemas persistirem após tentar estas etapas, entre em contato com seu Gerente de Conta Dedicado com detalhes do problema e as etapas que você já tomou. {% endhint %} ## Precisa habilitar um recurso? Alguns recursos do Headless Browser estão desativados ou restritos por padrão. Para acessá-los, entre em contato com o suporte da Oxylabs ([chat ao vivo](https://oxylabs.io/) ou [e-mail](mailto:support@oxylabs.io)) ou com seu Gerente de Conta Dedicado: * **Perfis persistentes** – aumente o `max_profiles` limite. * **Destinos restritos** – desbloqueie mais categorias de destino por meio do processo de KYC. * **Limites de taxa mais altos** – aumente além de `100` sessões simultâneas / `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/pt-br/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.