> ## Documentation Index
> Fetch the complete documentation index at: https://docs.firecrawl.dev/llms.txt
> Use this file to discover all available pages before exploring further.
# Criar sessão do Interact
> Inicia uma sessão independente do navegador Interact que você controla com código (sem scraping prévio).
| Cabeçalho | Valor |
| --------------- | ------------------ |
| `Authorization` | `Bearer ` |
| `Content-Type` | `application/json` |
## Corpo da Requisição
| 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. |
## Resposta
| 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 |
### Exemplo de requisição
```bash theme={null}
curl -X POST "https://api.firecrawl.dev/v2/interact" \
-H "Authorization: Bearer $FIRECRAWL_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"ttl": 120
}'
```
### Resposta de exemplo
```json theme={null}
{
"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.
## OpenAPI
````yaml pt-BR/api-reference/v2-openapi.json POST /interact
openapi: 3.0.0
info:
contact:
email: support@firecrawl.dev
name: Firecrawl Support
url: https://firecrawl.dev/support
description: >-
API para interagir com os serviços do Firecrawl e executar tarefas de web
scraping e crawling.
title: Firecrawl API
version: v2
servers:
- url: https://api.firecrawl.dev/v2
security:
- bearerAuth: []
paths:
/interact:
post:
tags:
- Interact
summary: Criar uma sessão de interação
operationId: createBrowserSession
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
security:
- bearerAuth: []
components:
securitySchemes:
bearerAuth:
scheme: bearer
type: http
````