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

Novedades

Lo que cambió en la API y en esta documentación, por fecha: lo nuevo, lo que cambió y lo corregido en cada versión.

Suscribirse por RSS
  1. Beta: la web, la lista de espera y esta documentación están publicadas

    Plataforma

    Qomni Agents entra en beta privada. Desde hoy qomni.ai y esta documentación son públicas, y puedes apuntarte a la lista de espera. La API y la app todavía no están abiertas.

    Nuevo

    • qomni.ai con la lista de espera de Agents: dejas tu correo y te escribimos una vez, cuando abra.
    • Esta documentación en docs.qomni.ai, en español, inglés y portugués.
    • Estado de la beta: qué está hecho, qué falta y cómo se abre, paso a paso hasta el primer cliente.

    Cambiado

    • Agents aparece como “Próximamente” en todo el portal y cada guía avisa que la API aún no responde. Los ejemplos muestran cómo va a funcionar.
  2. La API en un solo host

    Plataforma

    La API de Qomni vive ahora en api.qomni.ai, con el producto y la versión en la ruta: https://api.qomni.ai/agents/v1. El host anterior (agents-api.qomni.ai) ya no atiende: responde 404 api_host_moved con la URL base nueva, sin redirigir.

    Cambiado

    • URL base de la API: https://api.qomni.ai/agents/v1, antes https://agents-api.qomni.ai/v1. Cambia la URL base de tu cliente; las rutas, las claves y las respuestas no cambian. Ver Bienvenida.
    • Tiempo real: crea la sesión con POST https://api.qomni.ai/agents/v1/realtime/sessions; su url es wss://api.qomni.ai/agents/v1/realtime?session=…. Ver Habla con un agente en tiempo real.
    • SDK de TypeScript: baseUrl es ahora el host (por defecto https://api.qomni.ai) y cada producto agrega su /{product}/v1. Ver Usa el SDK de TypeScript.
    • Errores nuevos: 404 api_host_moved en el host antiguo y 404 unknown_api cuando la ruta no empieza por una API. Ver Errores.
  3. Tutoriales, y novedades por producto con RSS

    Plataforma

    Una sección de tutoriales con soluciones de punta a punta, y esta página con filtro por producto, página por entrada y RSS.

    Nuevo

    • Tutoriales: guías de punta a punta con el tiempo que toman, filtrables por producto, y “Empieza por aquí” en la portada.
    • Filtro por producto arriba de la lista (?product=agents lo comparte) y RSS de las novedades en cada idioma.
    • Cada entrada tiene su URL (/es/changelog/2026-10-23-blog-subscriptions/), con la anterior y la siguiente al pie; la portada y el menú de productos enlazan ahí.

    Cambiado

    • La línea de tiempo lleva la fecha en una columna a la izquierda, el título como enlace y el producto como etiqueta con su color; las entradas van de la más reciente a la más antigua.
    • La portada agrupa los productos por categoría y el prompt del hero es un botón con las marcas de los agentes de IA. Una banda “Lista para tu agente de IA” reúne llms.txt, llms-full.txt y el Markdown de cada página.
  4. Suscripción al blog por correo

    Plataforma

    El blog avisa por correo de cada artículo nuevo: deja tu dirección al pie de cualquier artículo o de la lista, confirma desde el correo y listo.

    Nuevo

    • Formulario de suscripción en el blog y al final de cada artículo, con confirmación por correo (doble opt-in) y baja desde cualquier mensaje.
    • La API detrás, api.qomni.ai/newsletter/v1 (POST /subscriptions), no dice nunca si una dirección ya está suscrita y acepta cinco altas por hora desde una misma dirección IP.
    • El blog en tres idiomas también por RSS: /es/blog/rss.xml, /blog/rss.xml y /pt-br/blog/rss.xml.
  5. BYOC, conecta tu propia telefonía

    Agents

    Tu operador y tu línea de siempre llegan a tus agentes de voz

    Trae tu operador o tu troncal SIP y tus números de siempre llegan a tus agentes de voz, sin portar nada y sin cambiar de proveedor.

    Nuevo

    • BYOC: tu propia telefonía: las dos maneras de traerla (troncal SIP y línea desviada), qué agente contesta cada número y cómo llamar hacia fuera por tu operador.
    • Un anuncio en el portal presenta BYOC con su enlace; se cierra una vez y no vuelve.
  6. SDK de TypeScript

    Agents

    @qomni/sdk llama a la API de Agents con un método por operación, los tipos del contrato y errores con código; la referencia muestra sus llamadas.

    Nuevo

    • Usa el SDK de TypeScript: new Qomni({ apiKey }) y qomni.agents.createCall(…), con idempotencyKey como opción y QomniError (status, code, message, requestId, fields).
    • El ejemplo en TypeScript de cada operación de la referencia de Agents usa el SDK; cURL y Python siguen como estaban.
    • El SDK se genera del contrato con bin/contracts generate; todavía no está en npm y se instala desde el repositorio.
    • Anuncios en el portal: una tarjeta presenta la última función nueva, con enlace y, cuando lo hay, un video; se cierra una vez y no vuelve.
  7. Ejemplos completos, diagramas y blog

    Plataforma

    El portal cambia de cara: los ejemplos de las guías son programas enteros con su salida, los procesos se explican con diagramas, hay un blog de ingeniería y este registro detalla cada versión.

    Nuevo

    • Blog: notas de ingeniería sobre cómo está construida la plataforma, empezando por las celdas por país y la anatomía de una clave de API.
    • Diagramas de proceso en El edge y las celdas, Idempotencia y reintentos y Habla con un agente. Se abren a tamaño completo con un clic.
    • Menú de productos con vista previa: al pasar el puntero por un producto ves su host, su primera llamada y sus guías; a la derecha, los últimos anuncios con imagen.
    • Menú “En esta página” bajo el título en pantallas pequeñas, con la sección que estás leyendo marcada.
    • El menú lateral se puede ocultar desde su botón; la elección se recuerda.

    Cambiado

    • Tema neutro, claro y oscuro: blancos y grises, con el color de marca sólo en el logo y en lo seleccionado (pestaña, fila del menú, indicador).
    • Los ejemplos de código muestran los lenguajes como pestañas en la cabecera del bloque, con el icono de cada uno, un solo botón de copiar y números de línea; elegir Python en un bloque lo elige en todos.
    • Las guías siguen la guía de estilo de Cloudflare: cada tipo de página (resumen, inicio rápido, concepto, tarea, referencia) tiene la misma forma, con “Antes de empezar”, “Deberías ver” y “Siguiente paso” en las tareas.
    • Referencia de la API: cada operación tiene un título corto (“Create call”) y su explicación aparte, y los grupos de endpoints llevan nombre. El selector de lenguaje del ejemplo es un menú con el icono de cada lenguaje. El menú lateral empieza con Resumen y Referencia del producto, como el de sus guías.
    • Este registro: cada entrada lleva su fecha en un carril, el producto como etiqueta y las listas de lo nuevo, lo cambiado y lo corregido.
    • Tablas más compactas y paginación en tarjetas con el título de la página anterior y la siguiente.

    Corregido

    • La bandera de Colombia en el menú de idioma estaba mal dibujada.
    • El ancho del menú lateral cambiaba de una página a otra.
    • Un clic en una imagen de las guías no abría el visor.
  8. Documentación en inglés y portugués

    Plataforma

    Las guías en español, inglés y portugués

    Las guías ahora también están en inglés y en portugués. Cambia de idioma desde el menú del encabezado: te lleva a la misma página.

    Nuevo

    • Inglés en la raíz del sitio (docs.qomni.ai/concepts/errors/) y portugués bajo /pt-br/, traducidos desde las guías en español y revisados.
    • Menú de idioma en el encabezado, con la bandera de cada uno.
    • Cada página declara sus versiones en los otros idiomas (hreflang), para que un buscador muestre la del lector.

    Cambiado

    • El español pasa a /es/; cada URL anterior redirige a su página nueva.
    • La referencia de la API sigue en inglés y es la misma para los tres idiomas; su menú y sus enlaces van en el idioma de la página.
  9. Nueva portada y directorio de productos

    Plataforma

    La portada muestra el producto con su primera llamada, las últimas novedades y lo común a toda la API.

    Nuevo

    • Directorio con los productos por categoría, con filtro por texto.
    • Cada página se puede abrir en Claude o en ChatGPT, copiar como Markdown o ver en Markdown desde su menú de acciones.

    Cambiado

    • El logo de Qomni, una tipografía propia para los títulos (sustituida al día siguiente por la del sistema) y transiciones entre páginas: la pestaña y la fila activas se deslizan a la siguiente.
    • Menú de productos junto al logo, con el icono y el resultado del producto.
  10. Nuevo portal

    Plataforma

    La documentación se mudó a un portal propio, generado desde contracts/.

    Nuevo

    • La sección de Agents con su referencia REST.
    • La referencia del WebSocket de Agents, generada desde su AsyncAPI.
    • Las guías en español, con el mismo menú y la misma búsqueda que la referencia.

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