# Inicio rápido: Sypnia Cloud

> De cero a tu primera sesión y tu primer problema en Sypnia Cloud, en cinco pasos y unos diez minutos.

Aplica a: Sypnia Cloud (servicio pago). Estado: al lanzar.  
Fuente: https://docs.sypnia.com/es/start/quickstart-cloud/

**\[Nube]** Esta página es para quien tiene una app web y todavía no tiene Sypnia. Usa Sypnia Cloud, donde nosotros corremos el motor por ti: no hay nada que desplegar. Para correr el motor tú mismo, usa el [inicio rápido con alojamiento propio](https://docs.sypnia.com/es/start/quickstart-self-host); el fragmento en tu app es el mismo.

**Al final tendrás:** tu app enviando a Sypnia, tu propia visita listada como una sesión, y un problema que causaste a propósito.

**Necesitas:** una app web que puedas editar y correr, y unos diez minutos. El nivel gratis alcanza.

### 1. Crea un proyecto

Abre `https://app.sypnia.com`, crea una cuenta y crea un proyecto. Ponle el nombre de tu app; los ejemplos de aquí usan `Shop`.

**Deberías ver:**La página del proyecto muestra su llave de ingesta, que empieza por `spk_`, y dice que está esperando el primer evento. Deja la página abierta.

La llave de ingesta es pública. Solo sirve para enviar datos a este proyecto, así que puede ir en el código de tu app.

### 2. Agrega el SDK a tu app

**npm**

```bash
npm install @sypnia/browser
```

```js
import { init } from '@sypnia/browser';

init({ project: 'YOUR_PROJECT_KEY' });
```

**pnpm**

```bash
pnpm add @sypnia/browser
```

```js
import { init } from '@sypnia/browser';

init({ project: 'YOUR_PROJECT_KEY' });
```

**yarn**

```bash
yarn add @sypnia/browser
```

```js
import { init } from '@sypnia/browser';

init({ project: 'YOUR_PROJECT_KEY' });
```

**bun**

```bash
bun add @sypnia/browser
```

```js
import { init } from '@sypnia/browser';

init({ project: 'YOUR_PROJECT_KEY' });
```

**script tag**

```html
<script async
  src="https://ingest.sypnia.com/v1/sdk.js"
  data-project="YOUR_PROJECT_KEY"></script>
```

Sin paso de compilación y sin llamar a `init`: pégala antes de `</head>`. La etiqueta inicia Sypnia con la llave que va en `data-project`.

Pon la llamada a `init` donde arranca tu app, antes de que pinte: `src/main.ts`, `src/main.tsx`, `src/index.js`. Luego reemplázala por esta versión más completa, con tu propia llave:

`src/main.ts`

```ts
import { init } from '@sypnia/browser';

init({
  project: 'spk_7d1f0c9e4b8a2f6d3c5e1a9b0f4d8c2e',
  environment: location.hostname === 'localhost' ? 'development' : 'production',
});
```

La línea `environment` separa tus propias pruebas de tus clientes: en tu máquina la app reporta como `development`, y en cualquier otro lugar como `production`. Las alertas solo se envían para `production`.

¿Usas Next.js? Sigue [Next.js](https://docs.sypnia.com/es/sdks/nextjs) para este paso y vuelve. ¿Usas un constructor de apps con IA? Mira [Lovable, Bolt, v0 y Replit](https://docs.sypnia.com/es/guides/lovable-bolt-v0-replit).

**Deberías ver:**Tu app compila y corre como antes. Nada se ve distinto.

### 3. Abre tu app y comprueba que envía

Corre tu app, ábrela en un navegador y haz clic en varias cosas. Abre las herramientas de desarrollo del navegador, pestaña **Network** (Red), y escribe `ingest` en el filtro.

**Deberías ver:**En menos de 10 segundos, una petición `POST` a `https://ingest.sypnia.com/v1/ingest/events` con estado `200`. Su respuesta se ve como `{"accepted": 5, "dropped": 0}`.

Si no hay petición, o sale en rojo, ve a [Solución de problemas](https://docs.sypnia.com/es/sdks/troubleshooting).

### 4. Mira tu primera sesión

Vuelve a Sypnia y abre **Sesiones**. Elige el entorno `development`.

**Deberías ver:**En menos de 10 minutos, una sesión: la tuya. Lista las páginas que abriste y en qué hiciste clic, en palabras: «Hizo clic en Agregar al carrito».

La sesión es anónima: Sypnia no sabe quién eres hasta que tu app lo dice. Eso es una línea más, en [Identificar personas](https://docs.sypnia.com/es/sdks/identifying-people).

### 5. Causa tu primer problema

Agrega una línea después de `init`, guarda y recarga tu app una vez:

`src/main.ts`

```ts
import { init, reportError } from '@sypnia/browser';

init({
  project: 'spk_7d1f0c9e4b8a2f6d3c5e1a9b0f4d8c2e',
  environment: location.hostname === 'localhost' ? 'development' : 'production',
});

reportError(new Error('Sypnia test: the cart total is missing'));
```

Luego abre **Problemas** en Sypnia, en el entorno `development`.

**Deberías ver:**En menos de 2 minutos, un problema nuevo. Su primer título es el técnico, `Error: Sypnia test: the cart total is missing`. Un momento después el agente lo reemplaza por una frase en palabras simples y dice a quién afectó (1 persona), desde cuándo y en qué parte de tu código.

Quita la línea. En el uso real nunca llamas a `reportError` para esto: los errores que nadie capturó se reportan solos.

## Lo que tienes ahora

- Cada visita a tu app es una sesión, con sus páginas y sus clics.
- Los errores, las páginas lentas, las llamadas a la API lentas o fallidas, y los clics de rabia y clics muertos se capturan sin más código.
- Las sesiones donde algo sale mal se graban, con todo lo que una persona escribe enmascarado.
- Los problemas llegan como frases, con el prompt para tu agente de código.

## Sigue con esto

| Para tener                                                                  | Haz                                                                                                                                                              |
| --------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| El ciclo completo una vez, con un clic de rabia, una grabación y el arreglo | [Tu primer problema](https://docs.sypnia.com/es/start/your-first-problem)                                                                                        |
| «Desde el cambio de ayer», y los nombres de tus archivos en las pilas       | Pon `release` y sube los source maps: [Source maps en CI](https://docs.sypnia.com/es/guides/source-maps-in-ci)                                                   |
| «3 personas», con sus nombres                                               | [Identificar personas](https://docs.sypnia.com/es/sdks/identifying-people)                                                                                       |
| La petición seguida hasta tu backend                                        | [Node](https://docs.sypnia.com/es/sdks/node), [Next.js](https://docs.sypnia.com/es/sdks/nextjs) u [OpenTelemetry](https://docs.sypnia.com/es/sdks/opentelemetry) |
| Tu agente de código leyendo los problemas por su cuenta                     | [Instalar con tu agente de código](https://docs.sypnia.com/es/start/install-with-your-agent)                                                                     |
| Saber qué se envía y qué nunca                                              | [Privacidad y enmascarado](https://docs.sypnia.com/es/sdks/privacy-and-masking)                                                                                  |

Cuando despliegues, tu app reporta como `production` y Sypnia empieza a enviar alertas y el resumen diario por correo.
