Saltar al contenido
Qomni

Agents

Crea un agente, dale voz y ponlo a atender: REST para las llamadas y un WebSocket para hablar con él en tiempo real desde tu app.

URL base
https://api.qomni.ai/agents/v1
Clave
sk_agents_test_…
curl https://api.qomni.ai/agents/v1/calls \
  -H "Authorization: Bearer sk_agents_test_…"

Novedades

Inicio rápido

Comprueba tu clave de Agents y haz que un agente llame a un número en cinco minutos, desde la terminal, Python o TypeScript.

Al terminar esta guía habrás comprobado tu clave y creado una llamada con la API de Agents. Todo corre en modo de prueba: no se marca ningún número y no se factura nada.

Antes de empezar

Necesitas:

  • Una cuenta de Qomni (prueba gratis de 14 días, sin tarjeta).
  • Una terminal con curl, o Python 3.9 o superior, o Node.js 18 o superior.
  1. Crea una clave de prueba

    Regístrate en qomni.ai. En Settings → API keys de tu workspace, crea una clave de prueba: empieza por sk_agents_test_. Guárdala en una variable de entorno de tu shell:

    export QOMNI_KEY="sk_agents_test_…"

    Los ejemplos de esta página la leen de QOMNI_KEY. No la escribas en tu código ni la subas a un repositorio.

  2. Instala lo necesario

    Con cURL no necesitas nada más. En Python usamos requests; Node.js ya trae fetch, y tsx ejecuta TypeScript sin compilarlo.

  3. Comprueba la clave

    Pide a la API el contexto de tu clave. Guarda el código en ping.py o ping.mts, o pega el comando de cURL en tu terminal:

    Ejecútalo:

    Un 200 trae tu workspace y livemode: false, porque la clave es de prueba. La respuesta puede traer más campos: ignora los que no conozcas.

    200 OKjson
    {
      "product": "agents",
      "tenant": "acme",
      "cell": "co1",
      "region": "co",
      "livemode": false
    }

    Un 401 significa que la clave falta o no es válida: el campo code del error te dice cuál de las dos. Mira Errores.

  4. Crea una llamada

    Pide que un agente llame a un número. En modo de prueba, +15005550001 es un número mágico que siempre termina completed. Guarda el código en create_call.py o create_call.mts y ejecútalo como en el paso anterior:

    La API responde 201 con la llamada:

    201 Createdjson
    {
      "id": "call_01k8x2m4v7q9r3t5w8y1z0a2b4",
      "to": "+15005550001",
      "status": "completed",
      "livemode": false,
      "cell": "co1",
      "region": "co",
      "created_at": "2026-10-21T15:04:05+00:00"
    }

Deberías ver

La llamada existe, con estado completed, y ningún teléfono sonó: así funciona el modo de prueba. Acabas de hacer las dos llamadas que hace cualquier integración con Agents: comprobar la clave y crear una llamada. GET /calls te las devuelve, la más reciente primero.

Si en el paso 3 viste 401, el campo code dice por qué: api_key_missing si falta el header, api_key_malformed si la clave está mal copiada, api_key_invalid si fue revocada.

Siguiente paso

Cambia la clave de prueba por una real (sk_agents_live_…) y el mismo código hace llamadas de verdad. Antes de eso, pon al agente a conversar con tu app:

Navegación del sitio

Nuevo

Qomni está en beta privada

La API y la app todavía no están abiertas. Mira qué está hecho, qué falta y cómo se abre, paso a paso hasta el primer cliente.

Escribe para buscar…

↑↓ moverte↵ abrirEsc para cerrar