- Inicio
- Desarrolladores
- Documentación
Conexia Infinity · API
Documentación de Conexia Infinity
Referencia técnica para integrar la centralita Conexia Infinity en tu CRM o aplicación: consultar el histórico, originar llamadas, recibir eventos, controlar la llamada en vivo y exponer tu CRM como herramienta a un agente de voz IA mediante el conector MCP.
- Dirigido a desarrolladores e integradores
- 7 vías de integración
- Actualizado: noviembre 2026
Antes de empezar
Qué describe esta documentación y cómo se accede
Esta documentación describe qué expone la plataforma y cómo se integra. Las credenciales y los endpoints concretos de tu instalación te los facilita tu contacto de Conexia: no se publican aquí.
Convención
Los valores entre ángulos son marcadores que sustituyes por los de tu instalación: <TU_SERVIDOR>, <API_KEY>, <TENANT>, <ARI_URL>, <RT_HOST>, <MCP_URL>, <EXT>.
Las credenciales viven en tu backend
Ni la API Key ni las credenciales de ARI o Real-time deben salir nunca al navegador. El navegador muestra avisos y pulsa botones; es tu servidor quien guarda las credenciales y habla con la plataforma.
Credenciales y seguridad
1. Solicita tus credenciales. Pide a tu contacto de Conexia las claves de las vías que vayas a usar (API Key, API REST v2, ARI, acceso Real-time) y, si aplica, la autorización de IP para tu servidor.
2. Integra desde el backend. Las credenciales viven en tu servidor, nunca en el navegador.
3. Combina las vías que necesites. Call Popup con Real-time, click-to-call con ARI, historial con API Key, IA con MCP.
La disponibilidad de cada función depende de la versión y la licencia de tu instalación.
Vías de integración
Las siete vías de integración
No compiten entre sí: cada una resuelve un trabajo distinto y en un CRM suelen convivir varias.
| Vía | Qué resuelve | Modelo | Referencia |
|---|---|---|---|
| API Key | Consultar histórico (CDR), presencia y transcripciones | Petición-respuesta (solo lectura) | API Key |
| ARI | Originar llamadas (click-to-call) y colgar canal | Comando REST | ARI |
| Real-time API | Eventos en directo y control de la llamada (transferir, aparcar, conferencia, grabar) | Conexión persistente | Real-time API |
| Webhook | Avisos HTTP de eventos de llamada, sin mantener conexión | Push (centralita → tu URL) | Webhook |
| Conector MCP | Que un agente de voz IA consulte y actúe sobre tu CRM durante la llamada | Plataforma → tu servidor MCP | Conector MCP |
| API REST v2 | Gestionar la agenda de contactos, los webhooks y los agentes de voz IA | REST con clave Bearer | Bajo solicitud |
| SDK JS/TS | Softphone, barra de llamadas y avisos en tiempo real dentro de tu aplicación web | Biblioteca en el navegador | SDK |
¿Qué vía necesito para cada función?
| Lo que quieres hacer en tu CRM | Vía |
|---|---|
| Que salte la ficha del contacto al recibir una llamada (Call Popup) | Real-time API |
| Botón «Llamar» en la ficha del contacto | ARI |
| Transferir, aparcar o poner en conferencia durante la llamada | Real-time API |
| Iniciar, pausar o parar la grabación en vivo | Real-time API |
| Poblar el historial, informes y cuadros de mando (CDR) | API Key |
| Adjuntar la transcripción a la actividad del contacto | API Key |
| Semáforo de presencia del equipo | API Key o Real-time API |
| Avisar a otro sistema al entrar o colgar una llamada, sin mantener conexión | Webhook |
| Que un agente de voz IA identifique a quien llama o agende | Conector MCP |
| Que el nombre del cliente salga en el teléfono (agenda de la centralita) | API REST v2 |
| Softphone o barra de llamadas dentro de tu aplicación web | SDK JS/TS |
Configuración vs. operación. Crear extensiones, editar IVRs, cambiar colas o dar de alta líneas lo gestiona Conexia desde el panel de administración, no por API. La agenda, los webhooks y los agentes de voz sí se pueden gestionar por API REST v2 con la clave que te facilite Conexia.
Empieza por aquí