> 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/help-center/pt-br/perguntas-mais-populares/configurando-seu-primeiro-produto.md).

# Configurando seu primeiro produto

Este guia começa quando você tiver uma conta da Oxylabs.

Cada produto segue o mesmo padrão de três etapas: obtenha acesso, conecte-se e envie sua primeira requisição. O acesso varia um pouco entre os produtos, e eles estão agrupados abaixo conforme o padrão. Para saber como funcionam o saldo de créditos, o crédito de boas-vindas e as alterações de plano, veja [Como funcionam os preços e a cobrança](https://developers.oxylabs.io/help-center/most-popular-questions/custom-pricing-or-a-free-trial).

### [Residential Proxies](https://developers.oxylabs.io/products/proxies/residential-proxies), [Mobile Proxies](https://developers.oxylabs.io/products/proxies/mobile-proxies), [Web Unblocker](https://developers.oxylabs.io/products/web-unblocker), e [Agent Browser](#residential-proxies-mobile-proxies-web-unblocker-and-agent-browser)

Você receberá um nome de usuário e uma senha. Não é preciso escolher quantidade ou país ao criar a instância.

1. **Obtenha seu acesso.** Vá ao painel, escolha o produto e selecione **Criar instância**. Você precisa nomear a instância antes de confirmá-la. Seu nome de usuário e senha são gerados assim que você fizer isso.
2. **Conecte-se.**

**Residential Proxies** – abra o Endpoint Generator, escolha um local e defina uma sessão persistente ou rotativa.

**Mobile Proxies** – conecte-se por meio de um único endpoint. Como os Proxies são pré-marcados automaticamente, não há lista de IPs para importar.

**Web Unblocker** – adicione o único endpoint do Web Unblocker ao seu código.

**Agent Browser** – conecte sua ferramenta. Clientes como Puppeteer, Playwright, CDP e MCP, como o Claude, são todos suportados.

3. **Envie sua primeira requisição.** Adicione o endpoint ao seu script e execute-o. Para o Agent Browser, isso significa iniciar sua sessão e começar a coletar dados.

<img src="https://3133925417-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpGNgdeKVOM3XvAaPheYj%2Fuploads%2FBGveoQdFoIwjfsu1Rgi3%2Funknown.png?alt=media&amp;token=ab241fec-9a61-4535-afae-fcf9ff9b60f4" alt="" height="344" width="624">

Opcionalmente, defina um limite de gastos para a instância durante a criação. Isso limita quanto do seu saldo de créditos compartilhado ela pode usar em cada ciclo de cobrança.

Residential Proxies e Mobile Proxies também suportam allowlist de IP. Veja [Como posso colocar IPs na allowlist?](https://developers.oxylabs.io/help-center/products-and-features/how-can-i-whitelist-ips) para mais detalhes.

### [ISP Proxies](https://developers.oxylabs.io/products/proxies/isp-proxies), [Dedicated ISP Proxies](https://developers.oxylabs.io/products/proxies/dedicated-isp-proxies), [Datacenter Proxies](https://developers.oxylabs.io/products/proxies/datacenter-proxies), e [Dedicated Datacenter Proxies](#residential-proxies-mobile-proxies-web-unblocker-and-agent-browser)

Você precisará escolher um tipo de IP, quantidade e país antes de acessá-lo.

1. **Obtenha seu acesso.** Vá ao painel, escolha o produto e selecione **Criar instância**. Você precisa definir o tipo de IP, nomear a instância e informar a quantidade antes de confirmá-la. Seu nome de usuário e senha são gerados assim que você fizer isso. Você também pode definir um país e, para Dedicated ISP Proxies, um provedor ASN, se necessário.
2. **Conecte-se.** Use o endpoint gerado a partir da sua instância.
3. **Envie sua primeira requisição.** Adicione o endpoint ao seu script e execute-o.

<img src="https://3133925417-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpGNgdeKVOM3XvAaPheYj%2Fuploads%2FMwsLrAKPHfkxErEyC4N0%2Funknown.png?alt=media&amp;token=a6186a94-ac62-4502-bb3c-73093147acf4" alt="" height="344" width="624">

<img src="https://3133925417-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpGNgdeKVOM3XvAaPheYj%2Fuploads%2Fqd1QCfnsI7a5fRl179P9%2Funknown.png?alt=media&amp;token=c2bc60f0-b26e-43ab-9485-d0d5c09e0b06" alt="" height="344" width="624">

Opcionalmente, defina um limite de gastos para a instância na criação. Isso limita quanto do seu saldo de créditos compartilhado ela pode usar em cada ciclo de cobrança.

Datacenter Proxies e Dedicated Datacenter Proxies também suportam allowlist de IP. Veja [Como posso colocar IPs na allowlist?](https://developers.oxylabs.io/help-center/products-and-features/how-can-i-whitelist-ips) para saber como gerenciar isso depois.

### [API da Web](https://developers.oxylabs.io/products/web-api)

Você receberá uma chave de API em vez de um nome de usuário e uma senha.

1. **Obtenha seu acesso.** Vá ao painel, escolha API da Web e selecione **Criar instância**. Você precisa nomear a instância antes de confirmá-la. Sua chave de API é gerada assim que você a confirmar.
2. **Conecte-se.** Monte sua requisição. Escolha um alvo e um local e, em seguida, solicite HTML bruto ou JSON estruturado.
3. **Envie sua primeira requisição.** Execute a requisição e obtenha seus dados.

<img src="https://3133925417-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpGNgdeKVOM3XvAaPheYj%2Fuploads%2F0O1Lnbhdo78xJ5sfLBcN%2Funknown.png?alt=media&amp;token=a8be6854-3eab-4b58-ba13-2479ac75b9ee" alt="" height="344" width="624">

***

### Prefere um passo a passo guiado?

* [Siga o guia de início rápido](https://developers.oxylabs.io/get-started)
* [Visite a documentação](https://developers.oxylabs.io/overview)
* Ou deixe seu assistente de codificação com IA cuidar da configuração com [Agent Skills](https://github.com/oxylabs/agent-skills)

Quer assistir em vez disso? Este vídeo cobre todo o painel, incluindo login, criação de uma instância e verificação do status.

#### **Visão geral completa do painel**

{% embed url="<https://youtu.be/6piEx4Am77U>" %}

***

### Faça mais com seus créditos

Seu saldo de créditos funciona em todos os produtos. Adicione outra instância a qualquer momento para testar algo novo.

***

<a href="https://dashboard.oxylabs.io/en/" class="button primary">Volte ao painel</a>


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://developers.oxylabs.io/help-center/pt-br/perguntas-mais-populares/configurando-seu-primeiro-produto.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.