# RPA de navegador

A RPA de navegador automatiza tarefas repetitivas em um perfil de navegador Chromium local: abrir páginas, interagir com elementos, ler resultados e controlar o fluxo com condições e loops. Você monta o fluxo como um modelo, salva o modelo na sua conta MoreLogin e o executa em um perfil de navegador, seja no cliente desktop, seja pela Local API da RPA de navegador.

Esta seção é destinada a desenvolvedores e agentes de IA que criam e executam modelos de forma programática. Para automatizar celulares Android na nuvem, consulte [RPA de celulares na nuvem](/pt/rparobotic-process-automation/01-overview/01-rpa-introduction).

## Requisitos

- O cliente desktop MoreLogin V2.73.0 ou posterior está em execução e com a sessão iniciada. Os modelos ficam armazenados na conta conectada e aparecem em **Modelos Personalizados** no cliente.
- A Local API está disponível em `http://127.0.0.1:<port>/api/rpa/browser/v1`. Use a porta da Local API exibida nas configurações do cliente; o padrão é `40000`.
- A autenticação funciona da mesma forma que no restante da Local API. Consulte [Autenticação](/pt/api-reference/getting-started/authentication).
- As execuções exigem um perfil de navegador Chromium (`browserTypeId: 1`).
- `GET /capabilities` retorna as operações, os limites e as URLs da documentação disponíveis para o seu cliente e a sua conta. Consulte esse endpoint antes de montar um modelo.


## Conceitos principais

| Conceito | Significado |
|  --- | --- |
| Modelo | Um fluxo salvo, com título, descrição e as dependências de modelos filhos. Cada salvamento cria uma nova versão. |
| Fluxo | A árvore ordenada de nós de um modelo. Ela começa com um único nó `start` e termina com um único nó `end`. |
| Nó | Uma etapa, como abrir uma URL ou clicar em um elemento. Cada tipo de nó tem um contrato que define suas entradas e saídas. |
| Ambiente | O perfil de navegador usado por uma execução. `environmentId` é o `envId` do perfil na [Local API do navegador](/pt/api-reference/browser/local-api). |
| Execução | Uma execução de uma versão salva de um modelo em um ambiente. Cada execução tem registros de execução dos nós e artefatos. |
| Recibo de solicitação | O resultado armazenado de uma solicitação de gravação enviada com `Idempotency-Key`. Use-o para descobrir o que aconteceu depois que o tempo limite se esgotou. |


## Diferenças em relação a outros endpoints da Local API

Os endpoints da RPA de navegador não usam o formato `{code, msg, data}` descrito em [Formato de Resposta Comum](/pt/api-reference/getting-started/response-format).

- Eles retornam códigos de status HTTP reais, como 201, 202, 409, 412, 422, 429 e 503.
- O corpo de uma resposta de sucesso é `{data, meta}` e o de uma resposta de erro é `{error, meta}`. Os códigos de erro são strings como `RPA_VALIDATION_FAILED`; consulte [Códigos de erro](/pt/browser-rpa/api/error-codes).
- As solicitações de gravação usam os cabeçalhos `Idempotency-Key`, `If-Match` e `X-RPA-Catalog-Revision`. Consulte [Cabeçalhos obrigatórios para solicitações de gravação](/pt/browser-rpa/local-api#cabe%C3%A7alhos-obrigat%C3%B3rios-para-solicita%C3%A7%C3%B5es-de-grava%C3%A7%C3%A3o).
- As falhas de autenticação usam o formato 401 padrão da Local API.


## Primeiros passos

1. [Início rápido](/pt/browser-rpa/quickstart): consulte os recursos e os contratos de nó e, depois, valide e salve um modelo que retorna a URL final da página.
2. [Executar um modelo com a API](/pt/browser-rpa/run-api-example): faça a pré-verificação da versão salva, inicie uma execução e leia o resultado.
3. [Campos comuns e estrutura do fluxo](/pt/browser-rpa/node-contract-guide): conheça a organização do fluxo, as referências, os tempos limite e as novas tentativas.
4. [Catálogo de nós](/pt/browser-rpa/nodes): veja as entradas, os valores padrão, as referências e as saídas de cada nó.
5. [Referência da Local API](/pt/browser-rpa/local-api): encontre todos os endpoints, os cabeçalhos exigidos pelas gravações e como se recuperar de tempos limite e conflitos de versão.


Para executar um modelo manualmente, consulte [Executar um modelo no cliente desktop](/pt/browser-rpa/run).