# Criar sessão do Interact (/pt-BR/api-reference/endpoint/browser-create)

<!-- agent-signals: reading_time_min: 3 · est_tokens: 1892 · updated: 2026-07-30 -->
Related: [Pesquisa](/pt-BR/api-reference/endpoint/search.md), [Feedback de busca](/pt-BR/api-reference/endpoint/search-feedback.md), [Raspar](/pt-BR/api-reference/endpoint/scrape.md), [Raspar em lote](/pt-BR/api-reference/endpoint/batch-scrape.md), [Obter status do scrape em lote](/pt-BR/api-reference/endpoint/batch-scrape-get.md), [Cancelar raspagem em lote](/pt-BR/api-reference/endpoint/batch-scrape-delete.md)

<div id="headers">
  ## Cabeçalhos [#cabeçalhos]
</div>

| Cabeçalho       | Valor              |
| --------------- | ------------------ |
| `Authorization` | `Bearer <API_KEY>` |
| `Content-Type`  | `application/json` |

<div id="request-body">
  ## Corpo da Requisição [#corpo-da-requisição]
</div>

| Parâmetro             | Tipo    | Obrigatório | Padrão | Descrição                                                                                                                                                                           |
| --------------------- | ------- | ----------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `ttl`                 | number  | Não         | 600    | Tempo de vida total da sessão, em segundos (30-3600)                                                                                                                                |
| `activityTtl`         | number  | Não         | 300    | Número de segundos de inatividade antes que a sessão seja destruída (10-3600)                                                                                                       |
| `profile`             | object  | Não         | —      | Habilita armazenamento persistente entre sessões. Veja abaixo.                                                                                                                      |
| `profile.name`        | string  | Sim\*       | —      | Nome do perfil (1-128 caracteres). Sessões com o mesmo nome compartilham o armazenamento.                                                                                           |
| `profile.saveChanges` | boolean | Não         | `true` | Quando `true`, o estado do navegador é salvo de volta no perfil ao fechar. Defina como `false` para carregar dados existentes sem gravar. Apenas um salvamento é permitido por vez. |

<div id="response">
  ## Resposta [#resposta]
</div>

| Campo                    | Tipo    | Descrição                                                              |
| ------------------------ | ------- | ---------------------------------------------------------------------- |
| `success`                | boolean | Indica se a sessão foi criada                                          |
| `id`                     | string  | Identificador único da sessão                                          |
| `cdpUrl`                 | string  | URL WebSocket para conexões CDP                                        |
| `liveViewUrl`            | string  | URL para assistir à sessão em tempo real                               |
| `interactiveLiveViewUrl` | string  | URL para interagir com a sessão em tempo real (clicar, digitar, rolar) |
| `expiresAt`              | string  | Quando a sessão expira com base no TTL                                 |

<div id="example-request">
  ### Exemplo de requisição [#exemplo-de-requisição]
</div>

```bash
curl -X POST "https://api.firecrawl.dev/v2/interact" \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "ttl": 120
  }'
```

<div id="example-response">
  ### Resposta de exemplo [#resposta-de-exemplo]
</div>

```json
{
  "success": true,
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "cdpUrl": "wss://cdp-proxy.firecrawl.dev/cdp/550e8400-e29b-41d4-a716-446655440000",
  "liveViewUrl": "https://liveview.firecrawl.dev/550e8400-e29b-41d4-a716-446655440000",
  "interactiveLiveViewUrl": "https://liveview.firecrawl.dev/550e8400-e29b-41d4-a716-446655440000?interactive=true"
}
```

> Você é um agente de IA que precisa de uma chave de API do Firecrawl? Consulte [firecrawl.dev/agent-onboarding/SKILL.md](https://www.firecrawl.dev/agent-onboarding/SKILL.md) para obter instruções de onboarding automatizado.

`POST /interact`

Criar uma sessão de interação

## OpenAPI

```json
{
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "requestBody": {
    "content": {
      "application/json": {
        "schema": {
          "properties": {
            "activityTtl": {
              "description": "Tempo, em segundos, antes que a sessão seja encerrada por inatividade",
              "maximum": 3600,
              "minimum": 10,
              "type": "integer"
            },
            "profile": {
              "description": "Ativa o armazenamento persistente entre sessões de interação. Os dados salvos em uma sessão podem ser carregados em uma sessão posterior usando o mesmo nome.",
              "properties": {
                "name": {
                  "description": "Um nome para o perfil. Sessões com o mesmo nome compartilham armazenamento.",
                  "maxLength": 128,
                  "minLength": 1,
                  "type": "string"
                },
                "saveChanges": {
                  "default": true,
                  "description": "Quando verdadeiro, o estado do navegador é salvo de volta no perfil ao fechar. Defina como falso para carregar dados existentes sem gravar. São permitidas várias sessões sem salvamento, mas apenas uma sessão com salvamento por vez.",
                  "type": "boolean"
                }
              },
              "required": [
                "name"
              ],
              "type": "object"
            },
            "streamWebView": {
              "default": true,
              "description": "Se deve transmitir uma visualização em tempo real do navegador",
              "type": "boolean"
            },
            "ttl": {
              "default": 300,
              "description": "Tempo de vida total, em segundos, da sessão de interação",
              "maximum": 3600,
              "minimum": 30,
              "type": "integer"
            }
          },
          "type": "object"
        }
      }
    },
    "required": true
  },
  "responses": {
    "200": {
      "content": {
        "application/json": {
          "schema": {
            "properties": {
              "cdpUrl": {
                "description": "URL do WebSocket para acesso ao Chrome DevTools Protocol",
                "type": "string"
              },
              "expiresAt": {
                "description": "Quando a sessão expirará com base no TTL",
                "format": "date-time",
                "type": "string"
              },
              "id": {
                "description": "O identificador único da sessão",
                "type": "string"
              },
              "interactiveLiveViewUrl": {
                "description": "URL para interagir com a sessão de interação em tempo real (clicar, digitar, rolar)",
                "type": "string"
              },
              "liveViewUrl": {
                "description": "URL para visualizar a sessão de interação em tempo real",
                "type": "string"
              },
              "success": {
                "type": "boolean"
              }
            },
            "type": "object"
          }
        }
      },
      "description": "Sessão de interação criada com sucesso"
    },
    "402": {
      "content": {
        "application/json": {
          "schema": {
            "properties": {
              "error": {
                "example": "Payment required to access this resource.",
                "type": "string"
              }
            },
            "type": "object"
          }
        }
      },
      "description": "Pagamento necessário"
    }
  }
}
```