> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Navegando em sites pelo seu app

> Deixe seu app da Base44 navegar em outros sites como uma pessoa faria para coletar preços ou detalhes de eventos, preencher formulários ou testar seu app publicado. Configure pelo chat de IA.

Seu app pode navegar em outros sites como uma pessoa faria. Ele pode coletar informações como preços, anúncios ou detalhes de eventos, preencher formulários ou verificar se o seu app publicado funciona. Ele faz isso com automação de navegador, que abre um navegador real na nuvem. Por isso, funciona mesmo quando um site não tem API. Você configura descrevendo o que quer no chat de IA, e a IA escreve uma função de backend que controla o navegador para você.

![Uma captura de tela do chat de IA mostrando um teste de navegador que retornou as 10 cidades mais visitadas](https://mintcdn.com/base44/IGOI9jQXAjFJ_hdg/images/browser-automation-test-run.png?fit=max\&auto=format\&n=IGOI9jQXAjFJ_hdg\&q=85\&s=02e22d0bc2cf917f2e93ded5f01ee4f8)

O chat de IA mostrando o que o navegador do seu app coletou de outro site

> [!WARNING]
>
> Você precisa do [plano Builder ou superior](https://docs.base44.com/pt-BR/Account-and-billing/Billing-and-plans.md) para usar a automação de navegador, porque ela roda nas funções de backend do seu app.

> [card] O que você pode fazer com ela
>
> * **Coletar anúncios:** Reúna o nome, a data e o local de próximos eventos de um site de eventos.
> * **Comparar preços:** Confira preços de voos ou produtos em outros sites e salve as melhores opções.
> * **Ver o que está em alta:** Traga os principais vídeos de uma hashtag ou as principais notícias de um site de notícias.
> * **Acompanhar mudanças:** Confira uma página toda manhã e receba um e-mail quando um preço ou anúncio mudar.
> * **Preencher formulários:** Peça um orçamento no site de um fornecedor com os detalhes de um pedido.
> * **Verificar seu app publicado:** Confirme que o cadastro funciona ou que um pixel de rastreamento dispara no seu domínio personalizado.

***

## Como funciona

Cada vez que sua função de backend roda, ela abre uma nova sessão de navegador, faz o trabalho e fecha o navegador. A IA encontra elementos na página, clica, digita e extrai as informações que você pediu. Assim, você descreve o que quer em palavras simples, em vez de apontar para partes da página.

Seu app pode iniciar uma sessão de 2 formas:

* **Pelo seu app:** Alguém clica em um botão ou abre uma página que chama a função de backend.
* **Em um horário programado:** Um [workflow](https://docs.base44.com/pt-BR/Building-your-app/Creating-workflows.md) executa a função de backend nos horários que você escolher, por exemplo toda manhã.

Um navegador é a ferramenta certa quando um site só mostra o conteúdo depois que a página roda, ou quando obter a informação exige várias etapas. Se um [conector](https://docs.base44.com/pt-BR/Integrations/Connectors.md), uma API ou uma simples requisição de página conseguir os mesmos dados, a IA usa essa opção, porque ela é mais rápida e custa menos.

***

## Pedindo ao chat de IA

Descreva o site, o que fazer nele e o que fazer com o resultado. A IA escreve a função de backend, executa um teste com um navegador real e mostra o que voltou.

**Para adicionar automação de navegador ao seu app:**

1. Vá para o editor do seu app.
2. Descreva a tarefa no chat de IA, incluindo o endereço do site, as informações de que você precisa e onde salvá-las ou exibi-las.
3. Confira o resultado do teste da IA e peça ao chat de IA para ajustar a função se algo estiver faltando ou errado.

> [!NOTE]
>
> Cada teste que a IA executa abre uma sessão de navegador real, então ele pode usar créditos como qualquer outra sessão.

***

## Exemplos de prompts

Use estes prompts como ponto de partida e substitua o site e os detalhes pelos seus.

Para coletar dados de um site:

```text theme={null}
Toda vez que eu clicar em "Atualizar eventos" na página Eventos, abra https://example.com/events em um navegador, colete o nome, a data, o local e o link de ingressos de cada evento e salve-os na tabela Event. Ignore os eventos que já estão salvos.
```

Para preencher um formulário em outro site:

```text theme={null}
Crie uma função de backend que abra https://example.com/quote, preencha o formulário de orçamento com o produto, a quantidade e o CEP do pedido, envie o formulário e salve no pedido o preço mostrado na página seguinte.
```

Para executar em um horário programado:

```text theme={null}
Crie um workflow que rode todos os dias às 8:00. Ele deve abrir https://example.com/pricing em um navegador, ler o preço de cada plano e me enviar um e-mail se algum preço tiver mudado desde ontem.
```

***

## Testando seu app publicado

Você pode usar a automação de navegador para verificar como seu app publicado se comporta no endereço ao vivo, por exemplo no seu domínio personalizado. Isso é útil para problemas que só aparecem no site publicado. Por exemplo, um e-mail de cadastro que não chega, um pixel de rastreamento que não dispara no seu domínio personalizado, um checkout que pede verificação do cartão ou algo que só quebra no celular.

Para verificar a versão que você está construindo no editor do app, use o [agente de testes](https://docs.base44.com/pt-BR/documentation/managing-app-data/testing-agent.md). Ele foi feito para testar sua prévia.

Por exemplo:

```text theme={null}
Crie uma função de backend que abra meu app publicado, faça cadastro com uma nova conta de teste e confirme que a página de boas-vindas carrega. Tire uma captura de tela de cada etapa para eu ver o que aconteceu.
```

***

## Créditos e limites

A automação de navegador usa créditos do workspace do seu app cada vez que uma sessão roda, não importa quem a iniciou. O custo é composto por:

* **Tempo de navegador:** Cobrado por minuto em que o navegador fica aberto, arredondado para cima, com mínimo de 1 minuto.
* **Etapas de IA:** Cada vez que a IA encontra, clica ou lê algo na página, ela usa créditos como outras chamadas de IA.

A maior parte do custo geralmente vem das etapas de IA, não do tempo de navegador. Saiba mais sobre [como os créditos funcionam](https://docs.base44.com/pt-BR/Account-and-billing/Credits.md).

> [!WARNING]
>
> **Limites de sessão:**
>
> * **Duração da sessão:** Uma sessão fecha depois de 5 minutos por padrão. Você pode pedir ao chat de IA para permitir que uma sessão rode por 1 a 15 minutos.
> * **Créditos:** Uma sessão não começa se o seu workspace estiver sem créditos.
> * **Horários de pico:** Se nenhum navegador estiver livre no momento, a sessão não começa e seu app mostra um erro. Tente de novo um pouco mais tarde.

Por padrão, a IA faz a função de backend verificar se quem a chama entrou no seu app. Assim, pessoas que você não conhece não conseguem executar sessões com os seus créditos.

***

## Usando sites com responsabilidade

Antes de automatizar um site, confira os termos de uso dele e veja se permitem acesso automatizado. Alguns sites não permitem.

Tenha em mente estes pontos:

* **Acesso bloqueado:** Alguns sites bloqueiam navegadores automatizados ou mostram um CAPTCHA. A automação de navegador não contorna isso. Escolha sites que permitam visitas automatizadas, ou use a API do site ou um [conector](https://docs.base44.com/pt-BR/Integrations/Connectors.md), se houver.
* **Login:** Toda sessão começa sem login, sem nada salvo de sessões anteriores. Se um site exigir login, armazene os dados de acesso como um [segredo do app](https://docs.base44.com/pt-BR/Integrations/Using-integrations.md#managing-app-secrets), e não no seu prompt. Use apenas contas que você tem permissão para usar dessa forma.
* **Gravações:** Por padrão, as sessões mantêm uma gravação e logs para ajudar a corrigir problemas. Se você não quiser isso, peça ao chat de IA para desativá-los.
* **Sites que mudam:** Quando um site muda o layout, uma função que funcionava antes pode retornar menos dados. Peça ao chat de IA para verificar a função de novo.

***

## Solução de problemas

Se a sua automação de navegador não estiver funcionando como esperado, encontre sua situação abaixo.

> [accordion] A função não retorna dados ou retorna os dados errados
>
> A página pode ter mudado, carregado devagar ou mostrado algo que o navegador não esperava, como um banner de cookies ou uma página de login. Peça ao chat de IA para investigar. A IA pode tirar capturas de tela durante um teste para ver o que o navegador viu.
>
> ```text theme={null}
> Minha função [nome da função] não retornou dados. Execute-a de novo com capturas de tela em cada etapa, descubra o que o navegador viu e corrija.
> ```

> [accordion] A sessão termina antes de a tarefa acabar
>
> Tarefas longas podem atingir o limite de tempo da sessão. Peça ao chat de IA para dar mais tempo à sessão, até 15 minutos, ou para dividir a tarefa em execuções menores.

> [accordion] Recebo um erro dizendo que nenhum navegador está disponível
>
> Todos os navegadores estavam ocupados naquele momento. Espere um pouco e execute de novo. Se isso acontecer em um horário programado, mude o workflow para outro horário.

> [accordion] Recebo um erro sobre créditos
>
> Seu workspace não tem créditos suficientes para iniciar uma sessão. Confira seu [saldo de créditos](https://docs.base44.com/pt-BR/Account-and-billing/Credits.md#checking-your-credit-balance) e recarregue ou faça upgrade do seu plano.

> [accordion] O site bloqueia o navegador ou mostra um CAPTCHA
>
> A automação de navegador não consegue passar por bloqueios ou CAPTCHAs. Procure uma API, um [conector](https://docs.base44.com/pt-BR/Integrations/Connectors.md) ou outra fonte para as mesmas informações.

> [!NOTE]
>
> Esta página foi traduzida usando IA. Para as informações mais precisas e atualizadas, consulte a [versão em inglês](https://docs.base44.com/index.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.