@qomni/sdk envuelve cada operación de la referencia 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 variableQOMNI_KEY, como en el inicio rápido. - El paquete aún no está en npm: instálalo desde la carpeta
sdks/typescript/del repositorio de Qomni.
-
Instala el paquete
pnpm add ../qomni/sdks/typescript -
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 encall.mts.call.mtsts 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; } } -
Ejecútalo
bun run call.mts¿Sin Bun?
Node.js 22.18 o superior ejecuta el mismo archivo tal cual:
node call.mts
Deberías ver
call_01hv4k8s2m9q7w3e5r6t8y0u1i completedEl 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:
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:
createRealtimeSessionabre la conversación. - Errores: los códigos que puede traer un
QomniError. - Idempotencia: cuándo mandar
idempotencyKey.