> For the complete documentation index, see [llms.txt](https://docs.airops.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.airops.com/docs/es/insights/onsite/traffic/vercel-agent-analytics.md).

# de Vercel

Conecta tu proyecto de Vercel a AirOps para rastrear el tráfico de bots de IA mediante Vercel Log Drains.

Conecta tu proyecto de Vercel a AirOps para rastrear el tráfico de bots de IA. AirOps aprovisiona automáticamente un **Vercel Log Drain** cuando instalas la integración, clasifica las visitas de bots de IA (ChatGPT, Claude, Perplexity, Google y más), y muestra información en tu panel de análisis de agentes.

***

### Requisitos previos

* Una **AirOps** cuenta activa con Agent Analytics habilitado
* Una **Vercel Pro o Enterprise** cuenta (los Log Drains no están disponibles en los planes Hobby)
* Una **proyecto de Vercel** sirviendo tu sitio web en un dominio personalizado
* Una **Kit de marca** en AirOps cuyo dominio coincida con el dominio de implementación de tu Vercel (configurable en Contexto > Brand Kits > Brand URL)

Si no estás seguro de si tu kit de marca está configurado correctamente, consulta con tu contacto de Customer Success de AirOps antes de instalar.

***

### Paso 1: Instala AirOps desde el Marketplace de Vercel

1. Abre la URL de instalación: [`https://vercel.com/integrations/airops-agent-analytics/new`](https://vercel.com/integrations/airops-agent-analytics/new)
2. Vercel muestra un selector de equipo. Selecciona el **equipo de Vercel** que posee el proyecto que quieres rastrear.
3. Vercel muestra la pantalla de **Instalar AirOps Agent Analytics** . En "Selecciona a qué proyectos tendrá acceso la integración", elige **Proyectos específicos** y selecciona solo el/los proyecto(s) que sirven tu sitio de marca rastreado.
4. Haz clic en **Instalar**.

{% hint style="info" %}
Recomendamos encarecidamente **Proyectos específicos** sobre **Todos los proyectos**. "Todos los proyectos" da a la integración acceso a cada proyecto de tu equipo de Vercel, incluidos los no relacionados (sitios de marketing, herramientas internas, implementaciones de vista previa). AirOps filtra los registros que no coinciden con el dominio de tu kit de marca antes de almacenarlos, pero aun así generan egresos del drain de Vercel (aproximadamente $0,50/GB) en tu factura. Elegir solo el proyecto del sitio de marca mantiene predecibles los costos de Vercel y evita transmitir tráfico que será descartado.
{% endhint %}

***

### Paso 2: Conecta con tu espacio de trabajo de AirOps

Después de autorizar en Vercel, serás redirigido de vuelta a AirOps.

* Si tu cuenta de AirOps tiene acceso a **un espacio de trabajo**, la integración se conecta automáticamente.
* Si tienes acceso a **varios espacios de trabajo**, aparece un selector. Selecciona el espacio de trabajo al que quieres vincular esta integración de Vercel.

AirOps aprovisiona automáticamente un Vercel Log Drain en tu equipo seleccionado. No se requiere configuración manual de URL de endpoint, secretos de firma ni encabezados Bearer.

Serás redirigido a la página de integración de AirOps Agent Analytics en Vercel, confirmando que la instalación se ha completado.

***

### Paso 3: Verifica la conexión

En AirOps, navega a **Insights > Settings > General** para cualquier kit de marca y desplázate hasta la **Integraciones conectadas** sección.

Deberías ver una **Vercel** fila con:

* Una **Conectado** insignia
* El nombre de tu equipo de Vercel conectado
* Una **Desinstalar en Vercel** acción

Los datos comienzan a fluir en cuanto tu sitio recibe tráfico de un bot de IA. Con volúmenes bajos de tráfico, Vercel agrupa los registros y los entrega cada **30 a 60 segundos**.

{% hint style="warning" %}
el botón **Probar** (en la configuración de Drains del lado de Vercel) solo envía registros sintéticos sin datos de solicitud. Una prueba satisfactoria **no** significa que el tráfico real aparecerá en AirOps; solo confirma que el endpoint es accesible. El tráfico real de agentes llega una vez que un bot de IA hace una solicitud a tu sitio que coincide con los proyectos configurados.
{% endhint %}

<figure><img src="https://3036434873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-af54a5d372532d53bdeaf65d70dc7566611d100d%2Fagent-vercel-01-setup-panel.png?alt=media" alt="Set up Agent Analytics source picker with Vercel marked Connected, next to CloudFront, Cloudflare Worker, and Netlify"><figcaption><p>Vercel aparece como Conectado una vez que la integración de AirOps está instalada.</p></figcaption></figure>

***

### Solución de problemas

| Síntoma                                                                            | Causa probable                                                                                                            | Solución                                                                                                                                                                                                                          |
| ---------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| la fila de Vercel muestra **Conectado** pero no aparecen datos en Insights Traffic | El dominio de tu kit de marca no coincide con el dominio de implementación de tu Vercel                                   | En AirOps, abre la configuración de Brand Kit y confirma que la URL de la marca coincide con el dominio que realmente sirve tu proyecto de Vercel (por ejemplo, `acme.com` no `www.acme.com` si tu sitio se sirve en `acme.com`). |
| Vercel te envía "drain errored"                                                    | El endpoint de AirOps devolvió 4xx/5xx durante más de 50 entregas en una hora, o más del 80% de las entregas en una hora  | Contacta con Customer Success de AirOps. Podemos diagnosticarlo a partir de los registros del servidor.                                                                                                                           |
| El drain aparece como "active" pero no aparecen filas después de 5 minutos         | Lo probaste con la URL de implementación generada automáticamente por Vercel (por ejemplo, `<project>-<hash>.vercel.app`) | La protección de implementación de Vercel en los planes Pro devuelve 401 a los bots en estas URL. Usa en su lugar el alias público de tu proyecto o un dominio personalizado.                                                     |
| El botón de prueba funciona, pero nunca aparecen datos reales                      | A los que accedes dan 404 en una implementación estática                                                                  | Los 404 en implementaciones solo estáticas se sirven desde la caché de borde de Vercel sin invocar el drain. Visita una ruta conocida que realmente exista en tu implementación.                                                  |
| La columna Bytes muestra 0 para algunas solicitudes                                | Las solicitudes estáticas en caché no incluyen `responseByteSize`                                                         | Esto es lo esperado en activos estáticos almacenados en caché por Vercel. Otras métricas (estado, agente de usuario, tiempo) no se ven afectadas.                                                                                 |
| Eliminaste la integración en Vercel pero AirOps aún muestra **Conectado**          | La página muestra un estado desactualizado                                                                                | Haz una recarga completa de la página de AirOps (Cmd+Shift+R en Mac, Ctrl+Shift+R en Windows). El webhook de desinstalación de Vercel es asíncrono y tarda unos segundos en llegar.                                               |

***

### Requisitos del plan

Los Vercel Log Drains están disponibles solo en **Vercel Pro y Enterprise** planes. Los planes Hobby no pueden crear drains; si tu equipo está en Hobby, tendrás que actualizar antes de instalar.

Vercel cobra el egreso del drain a aproximadamente $0,50 por GB transmitido, cargado en tu factura de Vercel. Para sitios con poco tráfico, normalmente es menos de $1 al mes. Para sitios con mucho tráfico, reduce el costo de dos maneras: limita la instalación a **Proyectos específicos** solo en el proyecto del sitio de marca (ver Paso 1), y en la configuración por entorno de Vercel empieza solo con Producción y excluye las implementaciones de vista previa.

***

### Configuración de seguridad y de mínimo privilegio

#### Permisos necesarios para instalar

**En Vercel:** cualquier usuario con el **Member** rol en tu equipo de Vercel puede instalar la integración. No se requiere ser Owner. La configuración de integraciones forma parte de las responsabilidades estándar del rol Member ([roles de acceso de Vercel](https://vercel.com/docs/rbac/access-roles)).

**En AirOps:** el usuario que complete la instalación debe haber iniciado sesión en AirOps y ser miembro del espacio de trabajo de destino, y sirve cualquier rol de AirOps.

#### Usuario dedicado de estilo servicio

AirOps no tiene un primitivo separado de identidad de máquina distinto de un usuario, pero la integración está diseñada para que el usuario que instala sea solo el actor del momento de la instalación y no el principal en tiempo de ejecución. Puedes cumplir los requisitos de mínimo privilegio tratando una cuenta de usuario dedicada como un proxy de cuenta de servicio:

1. Invita a un usuario nombrado y dedicado (por ejemplo, `vercel-airops@yourcompany.com`) a tu espacio de trabajo de AirOps. Usa el rol de menor privilegio que ofrezca tu espacio de trabajo.
2. Inicia sesión como ese usuario una vez y completa la instalación OAuth.
3. Después de que se complete la instalación, ese usuario no tiene autoridad en tiempo de ejecución. La integración sigue autenticándose mediante el token de API del espacio de trabajo descrito a continuación. Puedes eliminar al usuario del espacio de trabajo después si tu política de seguridad lo requiere; la integración seguirá funcionando.

El mismo patrón se aplica del lado de Vercel: un usuario dedicado de Vercel con el rol Member puede hacer la instalación y luego quedar como un miembro inactivo del equipo.

#### Autenticación en tiempo de ejecución

Después de la instalación, no interviene ninguna sesión de usuario en ninguna entrega del drain. La autenticación en cada entrega tiene dos capas:

* **firma HMAC-SHA1** del cuerpo de la solicitud, cifrada con un secreto de drain por instalación generado por AirOps en el momento de la instalación. Vercel envía la firma en el `x-vercel-signature` encabezado en cada entrega.
* **token Bearer** en el `Authorization` encabezado. El token es la **clave de API de AirOps de tu espacio de trabajo**, escrita en la configuración del drain durante la instalación.

Ambos factores están a nivel de espacio de trabajo, no de usuario. El usuario que instala se registra solo en los metadatos de auditoría de AirOps.

#### Rotación de tokens

La clave de API del espacio de trabajo se puede rotar en la app en **Account > Workspace > API Key** (requiere rol de administrador del espacio de trabajo de AirOps). Hay dos cosas que entender antes de rotarla:

* El drain de Vercel tiene incrustado el token anterior en su `Authorization` encabezado de salida. Después de la rotación, el drain empezará a fallar en la autenticación hasta que la integración se reinstale desde Vercel (lo que escribe el nuevo token en un nuevo drain).
* La misma clave de API del espacio de trabajo autentica otras APIs de AirOps (API pública, servidor MCP, SDK). Rotarla afecta a todas ellas, no solo a Vercel.

Si la cadencia de rotación forma parte de tu política de cumplimiento, la secuencia segura es: rota el token de AirOps y luego reinstala inmediatamente la integración de Vercel desde la lista del marketplace de Vercel.

#### Lo que no hace esta integración

* No solicita permisos en tu cuenta de Vercel más allá de lo necesario para crear y administrar un log drain en el equipo seleccionado. No puede leer el código fuente del proyecto, las variables de entorno ni los registros de implementación fuera del flujo de solicitudes del drain.
* No escribe de vuelta en tu cuenta de Vercel de forma continua. Después del aprovisionamiento inicial del drain, AirOps solo recibe datos de Vercel; no vuelve a llamar a la API de Vercel a menos que reinstales o desconectes.

Si tu revisión de seguridad necesita más detalles, contacta con Customer Success de AirOps y podemos guiar a tu equipo a través del flujo de datos a nivel de implementación.

***

### Desconectando

Para eliminar la integración de Vercel:

1. En AirOps, abre **Insights > Settings > General > Connected Integrations**.
2. Haz clic en **Desinstalar en Vercel** en la fila de Vercel. Esto te lleva a la página de integraciones de tu equipo de Vercel.
3. Busca la integración de AirOps y haz clic en **Eliminar**. Confirma.
4. AirOps marca la integración como **Desconectado** en tu siguiente actualización de página.

Tus datos históricos de Vercel permanecen en AirOps después de desconectar. Para reanudar el seguimiento, haz clic en **Reinstalar en Vercel** desde la misma fila.

***

### Qué rastrea AirOps

Una vez conectado, AirOps automáticamente:

* **Ingresa todas las solicitudes servidas por Vercel:** vistas de página, recursos, llamadas a API
* **Clasifica el tráfico de bots de IA:** identifica visitas de ChatGPT, Claude, Google, Perplexity, Meta, Apple, Bing, Bytedance, Common Crawl y otros
* **Categoriza el comportamiento de rastreo:** distingue entre rastreadores de entrenamiento de IA (GPTBot, ClaudeBot, etc.), búsquedas de IA (PerplexityBot, OAI-SearchBot, etc.) y navegación de IA iniciada por el usuario (ChatGPT-User, Claude-User, etc.)
* **Muestra análisis:** desgloses de tráfico, proporciones entre bots y humanos, y tendencias de rastreo en tu panel


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.airops.com/docs/es/insights/onsite/traffic/vercel-agent-analytics.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
