> ## Documentation Index
> Fetch the complete documentation index at: https://firecrawl-docs-remove-capabilities-from-sidebar.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Descripción general

> Notificaciones en tiempo real para tus operaciones de Firecrawl

Recibe notificaciones en el momento en que un rastreo, una extracción por lotes, una extracción, un trabajo de agente o una comprobación de monitor comienza, avanza o finaliza. En lugar de consultar periódicamente el estado, proporcionas un endpoint HTTPS y Firecrawl te envía eventos en tiempo real.

<div id="supported-operations">
  ## Operaciones admitidas
</div>

| Operación | Eventos |
| - | - |
| Rastreo | `started`, `page`, `completed` |
| extracción por lotes | `started`, `page`, `completed` |
| Extract | `started`, `completed`, `failed` |
| Agent | `started`, `action`, `completed`, `failed`, `cancelled` |
| Monitor | `check.completed` |

Consulta [Tipos de eventos](/es/webhooks/events) para obtener todos los detalles de la carga útil y ver ejemplos.

<div id="configuration">
  ## Configuración
</div>

Añade un objeto `webhook` a tu solicitud:

```json JSON theme={null}
{
  "webhook": {
    "url": "https://your-domain.com/webhook",
    "metadata": {
      "any_key": "any_value"
    },
    "events": ["iniciado", "página", "completado", "error"]
  }
}
```

| Campo | Tipo | Requerido | Descripción |
| - | - | - | - |
| `url` | string | Sí | La URL de tu endpoint (HTTPS) |
| `headers` | object | No | Encabezados personalizados para incluir en las solicitudes del webhook |
| `metadata` | object | No | Datos personalizados incluidos en las cargas del webhook |
| `events` | array | No | Tipos de eventos a recibir (por defecto: todos los eventos) |

<div id="usage">
  ## Uso
</div>

<div id="crawl-with-webhook">
  ### Rastreo con webhook
</div>

```bash cURL theme={null}
curl -X POST https://api.firecrawl.dev/v2/crawl \
    -H 'Content-Type: application/json' \
    -H 'Authorization: Bearer YOUR_API_KEY' \
    -d '{
      "url": "https://docs.firecrawl.dev",
      "limit": 100,
      "webhook": {
        "url": "https://tu-dominio.com/webhook",
        "metadata": {
          "any_key": "any_value"
        },
        "events": ["started", "page", "completed"]
      }
    }'
```

<div id="batch-scrape-with-webhook">
  ### Raspado en lote con webhook
</div>

```bash cURL theme={null}
curl -X POST https://api.firecrawl.dev/v2/batch/scrape \
    -H 'Content-Type: application/json' \
    -H 'Authorization: Bearer YOUR_API_KEY' \
    -d '{
      "urls": [
        "https://example.com/page1",
        "https://example.com/page2",
        "https://example.com/page3"
      ],
      "webhook": {
        "url": "https://your-domain.com/webhook",
        "metadata": {
          "any_key": "any_value"
        },
        "events": ["started", "page", "completed"]
      }
    }'
```

<div id="timeouts-retries">
  ## Tiempos de espera y reintentos
</div>

Tu endpoint debe responder con un estado `2xx` en un plazo de **10 segundos**.

Si la entrega falla (se excede el tiempo de espera, el estado no es 2xx o hay un error de red), Firecrawl reintenta automáticamente:

| Reintento | Retraso después del fallo |
| - | - |
| 1.º | 1 minuto |
| 2.º | 5 minutos |
| 3.º | 15 minutos |

Después de 3 reintentos fallidos, el webhook se marca como fallido y no se realizan más intentos.