> 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 Saiba como lidar com comportamento inesperado ou baixas taxas de sucesso ao usar Headless Browser. | 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* | Simples `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 muitos navegadores por segundo | Fique dentro do `10` limite de sessões por segundo ou [contate 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` o total de sessões simultâneas ou [contate o suporte](#need-a-feature-enabled-1) para aumentar o limite. | | *Inspeção de sessão (VNC) não consegue se conectar (o navegador inicia)* | Limite máximo de VNC atingido | Use menos sessões de VNC. | | *Erro de TLS / certificado* | Validação de certificado no Node.js | Defina `NODE_TLS_REJECT_UNAUTHORIZED="0"` antes de carregar o Playwright (somente para testes). | | *CDP\_LIMIT\_REACHED: limite de perfil atingido* | `o_profile` a contagem excede `max_profiles` (padrão: `5`) | Reutilize um nome de perfil estável, exclua perfis não usados no Dashboard (`hb.oxylabs.io/dashboard`), ou [contate o suporte](#need-a-feature-enabled-1) 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 sessões | Fixar `proxy_resi_ses_id` + `proxy_resi_ses_time` com valores idênticos em cada sessão. | | *Parede de login / taxa de sucesso baixa* | Reputação do IP, geolocalização incorreta ou incompatibilidade de engine | Defina `p_cc` (+ `p_city`), tente um diferente `p_device`, ou tente novamente em uma sessão nova. | | *Alvo bloqueado completamente* | Categoria de alvo restrita | Conclua o KYC com 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 taxas de sucesso baixas, considere as etapas a seguir: ### **Entenda nosso processo de tratamento de CAPTCHA** Familiarize-se com nossos [tratamento de CAPTCHA](/products/pt-br/headless-browser/captcha-handling.md) métodos e seu uso. Isso pode ajudar a identificar 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 em 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](/products/pt-br/headless-browser/geolocation-and-proxy-selection.md). ### **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 dispositivo usando o `?p_device` parâmetro. Mais informações podem ser encontradas em [Tipo de dispositivo](/products/pt-br/headless-browser/device-type.md) 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 das etapas que você já executou. {% endhint %} ## Precisa habilitar um recurso? Alguns recursos do Headless Browser são limitados por padrão. Para ajustar seus limites, 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: * **Mais perfis persistentes** – aumente o limite padrão da sua conta de 5 perfis salvos. * **Mais sessões persistentes** – aumente o limite padrão da sua conta de 5 sessões persistentes simultâneas. * **Alvos restritos** – desbloqueie mais categorias de alvo via 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.