Qomni es Agents: agentes de IA que contestan el teléfono, llaman a tus clientes y conversan en tiempo real desde tu app. Tiene una app web para administrarlos y una API para ponerlos en tu código. Toda la API sigue las mismas reglas: las mismas claves, los mismos errores y el mismo modo de prueba. Si aprendes un endpoint, sabes usar todos.
Qué hace la API
| Recurso | Qué haces con él | Dónde |
|---|---|---|
| Llamadas | Un agente llama a un número y te dice cómo terminó | POST /calls, GET /calls |
| Sesiones en tiempo real | Tu app abre una conversación de voz o texto con un agente, sin exponer tu clave | POST /realtime/sessions y un WebSocket |
| Contexto de la clave | Comprueba una clave y mira en qué celda vive tu workspace | GET /ping |
La API vive en un solo host, api.qomni.ai: la ruta empieza por el producto
y después la versión, https://api.qomni.ai/agents/v1. Habla JSON y se
versiona en la ruta. Dentro de una versión sólo se agregan campos, nunca se
quitan: tu cliente debe ignorar los campos que no conoce.
Lo que vale en todos los endpoints
- Una clave por modo.
sk_agents_test_…para probar,sk_agents_live_…para producción. Ver API keys y autenticación. - Un solo host. Tu código no elige región: la clave lleva la celda y el edge enruta. Ver El edge y las celdas.
- La misma forma de error.
codepara tu código,messagepara personas,request_idpara soporte. Ver Errores. - Modo de prueba sin consecuencias. La misma API, sin marcar ni facturar nada. Ver Modo de prueba.
Por dónde empezar
Inicio rápido
Comprueba una clave y haz que un agente llame a un número, en cinco minutos.
Habla con un agente en tiempo real
Crea una sesión, abre el socket y conversa desde tu app.
Conceptos
Las reglas que valen para toda la API.
Referencia de la API
Cada endpoint, campo y error, generado desde el contrato.