---
title: "Usa el SDK de TypeScript"
description: "Llama a la API de Agents desde TypeScript o JavaScript con @qomni/sdk: un método por operación, tipos del contrato y errores con código."
version: "es"
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.qomni.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Usa el SDK de TypeScript

`@qomni/sdk` envuelve cada operación de la [referencia](/es/agents-api/) en un
método con los tipos del contrato: `qomni.agents.createCall`,
`qomni.agents.listCalls`, `qomni.agents.createRealtimeSession` y el resto.
Se genera desde el contrato, así que un método siempre pide lo que pide la
operación.

## Antes de empezar

- Bun, o Node.js 22.18 o superior (los dos ejecutan TypeScript sin compilar).
- Una clave de prueba de Agents (`sk_agents_test_…`) en la variable `QOMNI_KEY`,
  como en el [inicio rápido](/es/get-started/quickstart/).
- El paquete aún no está en npm: instálalo desde la carpeta
  `sdks/typescript/` del repositorio de Qomni.

1. ### Instala el paquete

   ```shell
   pnpm add ../qomni/sdks/typescript
   ```

2. ### Crea el cliente y haz una llamada

   La clave decide el producto y el modo: una clave de Agents sirve en
   `qomni.agents`. Guarda el código en `call.mts`.

   ```ts title="call.mts"
   import { Qomni, QomniError } from "@qomni/sdk";

   const qomni = new Qomni({ apiKey: process.env.QOMNI_KEY! });

   try {
     const call = await qomni.agents.createCall(
       { to: "+15005550001" },
       { idempotencyKey: "order-1001" },
     );
     console.log(call.id, call.status);
   } catch (error) {
     if (error instanceof QomniError) {
       console.error(error.status, error.code, error.message);
     } else {
       throw error;
     }
   }
   ```

3. ### Ejecútalo

   ```shell
   bun run call.mts
   ```

   Node.js 22.18 o superior ejecuta el mismo archivo tal cual:

   ```shell
   node call.mts
   ```

## Deberías ver

```text title="Salida"
call_01hv4k8s2m9q7w3e5r6t8y0u1i completed
```

El SDK envió `POST https://api.qomni.ai/agents/v1/calls` con tu clave en
`Authorization`, el cuerpo en JSON y `Idempotency-Key: order-1001`. En modo
de prueba no sonó ningún teléfono: `+15005550001` es un número mágico que
termina `completed`. Si la clave no es válida, la API responde `401` y el SDK
lanza un `QomniError` con el `code` del error, por ejemplo
`api_key_malformed`.

## Siguientes pasos

- Cada método se llama como su operación en la [referencia de Agents](/es/agents-api/):
  parámetros de ruta, luego el cuerpo, luego la query, luego las opciones
  (`idempotencyKey`, `signal`, `headers`). El ejemplo en TypeScript de cada
  operación ya usa el SDK.
- [Habla con un agente en tiempo real](/es/agents/realtime/): `createRealtimeSession` abre la conversación.
- [Errores](/es/concepts/errors/): los códigos que puede traer un `QomniError`.
- [Idempotencia](/es/concepts/idempotency/): cuándo mandar `idempotencyKey`.

Source: https://docs.qomni.ai/es/get-started/sdks/index.mdx
