Inicio › Desarrolladores › Documentación
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.
Antes de empezar
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.
Las cinco 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, grabaciones 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 |
¿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 |
Configuración vs. operación — Crear extensiones, editar IVRs, cambiar colas o dar de alta líneas se hace desde el panel de administración, no por API. Las integraciones operan la telefonía; no la configuran.
Credenciales y seguridad
- Solicita tus credenciales. Pide a tu contacto de Conexia las claves de las vías que vayas a usar (API Key, ARI, acceso Real-time) y, si aplica, la autorización de IP para tu servidor.
- Integra desde el backend. Las credenciales viven en tu servidor, nunca en el navegador.
- 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.