API Cloud de netelip: guía completa de integración

La interfaz de netelip que convierte los recursos de tu cuenta —numeración, Centralita Virtual, extensiones, grabaciones, llamadas— en operaciones que ejecuta tu propio software.

Las empresas que construyen productos de comunicaciones tienen una versión de esta conversación al menos una vez al mes: "queremos integrar la telefonía en nuestro producto, pero no queremos convertirnos en operadores".

Nosotros tampoco queremos que se conviertan en operadores. Ese trabajo ya lo hacemos nosotros.

Lo que queremos es que puedan construir su producto —sea una plataforma SaaS, un CRM, un lanzador de campañas o un agente de voz con IA— sin tocar la infraestructura de voz. Sin cablear centralitas, sin gestionar interconexiones, sin depender de tickets manuales para dar de alta un número.

Para eso existe API Cloud: una interfaz que permite que tu aplicación ejecute las mismas operaciones que normalmente harías desde el panel de netelip. Consultar recursos, cambiar configuraciones, comprar numeración, crear extensiones, activar grabaciones, revisar transcripciones. Todo desde tu backend. Sin coste añadido.

Este artículo explica qué es API Cloud, qué puedes construir con ella y qué necesitas para empezar.

LA IDEA

API Cloud es una interfaz. No un panel alternativo, no una app terminada, no un producto para usuario final. Es la fontanería que permite que tu plataforma hable con nuestra infraestructura.

1. Qué es API Cloud

La definición formal es sencilla: API Cloud es la interfaz que permite realizar desde una aplicación propia las acciones que habitualmente se llevan a cabo desde el panel de control de netelip.

Su finalidad es facilitar la automatización de tareas, la integración con otros sistemas y la gestión remota de los recursos disponibles. De esta manera, una empresa puede incorporar funciones de netelip a su propia plataforma y adaptarlas a sus procesos.

Con API Cloud puedes:

• Consultar información actualizada sobre los recursos de tu cuenta.
• Cambiar configuraciones mediante las operaciones documentadas.
• Automatizar procesos repetitivos que hoy haces desde el panel.
• Integrar los servicios de netelip en aplicaciones de terceros.
• Construir recorridos propios para los usuarios de tu plataforma.

Y conviene decir con la misma claridad lo que no es: no es un panel alternativo, no es una aplicación terminada y no es un producto para el usuario final. Tus clientes no ven API Cloud. Ven tu producto.

La aplicación desde la que se utiliza API Cloud la desarrolla y mantiene la empresa que realiza la integración. Nosotros proporcionamos el acceso y prestamos los servicios contratados. No desarrollamos la plataforma del cliente. Ese reparto de responsabilidades es lo que hace posible que tu producto sea tu producto.

QUIÉN HACE QUÉ

netelip proporciona el acceso a la API, presta los servicios contratados, verifica la documentación y realiza las activaciones internas. Tu empresa desarrolla la integración, custodia las credenciales, mantiene el saldo cuando toca y atiende a los usuarios finales de tu plataforma.

2. Qué puedes construir con API Cloud

Empecemos por el para qué. Estos son los cinco casos de uso más habituales que vemos entre nuestros clientes integradores.

🔹 Plataforma SaaS que incorpora numeración

Vendes un producto SaaS y quieres que tus clientes soliciten un número virtual desde tu propia interfaz, sin salir de tu plataforma.

Con API Cloud tu aplicación consulta los países disponibles, muestra las ciudades, obtiene los requisitos legales de cada país, recoge la documentación del usuario, la envía, guarda la referencia recibida y solicita la compra. Todo por API. El número queda dentro de la cuenta de netelip de tu empresa, pero la experiencia entera vive dentro de tu producto.

🔹 Plataforma de agentes de voz con IA

Estás construyendo agentes conversacionales con Retell AI, ElevenLabs, LiveKit o cualquier otro orquestador. La conversación la gestiona tu plataforma; la voz viaja por nuestra infraestructura.

Con API Cloud creas la cuenta, compras la numeración, configuras el envío a tu servidor SIP y consultas el saldo. Y probablemente no necesites API Voice: si tu plataforma ya orquesta la lógica de llamada por su cuenta, no hay que duplicar ese control desde nosotros.

🔹 Portal propio de Centralita Virtual

Ofreces a tus administradores una interfaz propia para consultar y configurar su Centralita Virtual, sin obligarlos a entrar al panel de netelip.

API Cloud te permite crear una Centralita básica, listar y crear extensiones, renovar contraseñas SIP, cambiar identificadores de llamada, consultar números y configurar su enrutamiento, consultar llamadas y activar servicios de análisis.

🔹 Panel de calidad de llamadas

Tu equipo de calidad quiere revisar llamadas desde su propia herramienta interna. Con API Cloud activas grabación, transcripción y análisis del sentimiento, buscas por fecha, origen, destino o texto transcrito, filtras por puntuación de sentimiento y descargas grabaciones concretas cuando toque escucharlas.

🔹 Administración centralizada de API Voice

Si tu producto usa API Voice, puedes administrarlo desde tu propia interfaz: listar los recursos, modificar URL de control, informes, eventos y registros, limitar la IP desde la que se realizan llamadas, seleccionar extensiones y eventos observados, y generar tokens cuando haga falta.

3. Qué recursos puedes gestionar

La versión documentada de API Cloud permite trabajar funcionalmente con estos bloques:

• API Voice. Crear, listar, consultar, modificar, eliminar y generar el token del servicio.
• Línea SIP. Consultar identificadores de llamada disponibles y la información de crédito y saldo.
• Numeración telefónica. Listar y consultar los números de la cuenta, configurar su destino y su formato de identificador entrante.
• Compra de numeración. Consultar países y ciudades, obtener requisitos, enviar documentación y solicitar la compra.
• vDrive. Crear y activar el servicio de almacenamiento para el usuario principal de la cuenta.
• Centralita Virtual. Crear una básica, consultar estado, servicios activos y límites de capacidad.
• Extensiones. Listar, crear, modificar, eliminar, cambiar contraseña SIP, configurar desvíos, activar grabación y transcripción por extensión.
• Grabaciones, transcripciones y sentimiento. Activar, buscar por múltiples filtros, descargar archivos, consultar puntuaciones.
• Consulta de llamadas. Realizadas, recibidas y entre extensiones, con filtros por número, extensión, origen, destino y fechas.
• Enrutamiento de numeración en la Centralita Virtual. Configurar cómo se tratan las llamadas recibidas por cada número (extensión, cola, IVR, locución, sala de conferencias, etc.).

Un aviso importante: que la consulta general de la Centralita Virtual devuelva información sobre IVR, colas o filtros no significa por sí solo que la versión actual permita crearlos por API. Solo debe asumirse que puedes gestionar aquello para lo que existe una operación documentada. La referencia siempre vive en la documentación técnica oficial de API Cloud.

4. Cómo funciona una integración típica

Aunque cada operación usa datos diferentes, el recorrido general de una petición es siempre el mismo:

1. Un usuario o proceso inicia una acción en tu aplicación.
2. Tu aplicación comprueba que dispone de los datos necesarios.
3. Tu servidor realiza una petición autenticada a API Cloud.
4. API Cloud procesa la petición.
5. Tu aplicación recibe una respuesta en JSON.
6. Interpreta el estado y la información devuelta.
7. Muestra el resultado, guarda la referencia necesaria o continúa con el siguiente paso.

Las llamadas se realizan contra la URL base indicada en la documentación, utilizan métodos GET o POST según la operación, y el token de seguridad se envía en la cabecera api-id. Las respuestas siempre van en JSON.

Hay tres tipos de operaciones que conviene distinguir:

• Consultas. Obtienen información: recursos, saldo, números, extensiones, grabaciones, llamadas. La aplicación las usa para construir paneles, buscadores o pantallas de configuración.
• Cambios de configuración. Modifican un recurso existente: destino de un número, datos de una extensión, servicios activos. Antes de enviarlas, la aplicación debe validar los datos y mostrar sus consecuencias al usuario.
• Procesos de varios pasos. No son una única petición. El caso más claro es la compra de numeración, que requiere seleccionar país, ciudad, consultar requisitos, recoger documentación, enviarla, guardar la referencia y solicitar la compra. La aplicación debe representar cada fase sin mostrar como activo lo que aún está pendiente de validación.

Y una regla no negociable: la integración se realiza desde un servidor controlado por tu empresa. El token no vive en el navegador, ni en aplicaciones instaladas en dispositivos de usuarios finales, ni en repositorios públicos.

5. Qué necesitas para empezar

Para utilizar API Cloud necesitas cuatro cosas:

• Una cuenta de empresa en netelip. Si aún no eres cliente, empieza por el registro de empresas.
• El token de seguridad. Se genera desde "Editar perfil" en tu panel de control (necesitas sesión iniciada). Este token identifica a tu cuenta cada vez que tu aplicación se conecta.
• El ID de cliente. Se obtiene pulsando sobre el avatar del panel.
• Una IP autorizada desde la que tu sistema realizará las peticiones.

Con esos cuatro datos, abres un ticket a través del sistema de tickets de netelip indicando la IP, el token y el ID de cliente. Nosotros habilitamos el acceso. A partir de ese momento tu integración puede empezar a trabajar contra la URL base de la API.

SEGURIDAD DEL TOKEN

El token no debe estar expuesto en el navegador, ni en aplicaciones instaladas en dispositivos de usuarios finales, ni en repositorios de código, ni en capturas de pantalla, ni en tickets. Vive en tu servidor, en un gestor de secretos, y solo tu backend lo utiliza.

6. API Cloud y API Voice: dos servicios distintos

Se confunden mucho. Vamos a aclararlo aquí, porque afecta a lo que contratas y a lo que pagas.

API Cloud administra recursos. API Voice controla llamadas. Utilizar una no obliga a incorporar la otra.

Puedes prescindir de API Voice si conectas los agentes por SIP, tu plataforma gestiona la conversación y tú controlas los eventos, las grabaciones y los datos de llamada. Es el escenario más habitual en plataformas SaaS que integran voz.

Debes valorar API Voice si necesitas lanzar, transferir, grabar, modificar o finalizar llamadas desde la infraestructura de netelip. En ese caso la propia infraestructura ejecuta acciones sobre la llamada mientras está sucediendo. Puedes ver el detalle en su página comercial y en la documentación técnica oficial de API Voice.

Un detalle técnico que evita disgustos: aunque puedes gestionar API Voice desde API Cloud (crearlo, configurarlo, generar su token), el token de API Voice no es el mismo que el token de seguridad de API Cloud. El primero se genera desde API Cloud pero se usa en operaciones de API Voice. El segundo se envía en la cabecera api-id de API Cloud. Confundirlos es el error clásico en integraciones nuevas.

DECISIÓN TÉCNICA

API Voice se incorpora por necesidad técnica real, no por utilizar API Cloud ni por comprar numeración.

7. Precios y condiciones

Tres detalles operativos que importan:

• Canales por número virtual español: cada número incluye 30 canales entrantes y 30 salientes. Para campañas salientes con IA conviene analizar volumen previo y dimensionar canales según necesidades reales. El aumento se solicita por el sistema de tickets.
• Saldo: la cuenta debe disponer de saldo suficiente para las llamadas entrantes y salientes.

Los desvíos a fijos o móviles se tarifican según destino y las tarifas nacionales de netelip.

8. Prueba gratuita de 30 días

Antes de decidir cuánto quieres apostar, puedes probarlo. La prueba gratuita de netelip incluye:

• 1 número virtual de Madrid o Málaga.
• API Voice y Centralita Virtual con 10 extensiones o puestos de trabajo.
• La numeración mantiene los requisitos habituales de adquisición y verificación.

Es tiempo suficiente para conectar tu arquitectura real, mover una campaña de prueba, revisar grabaciones y transcripciones y decidir con datos si necesitas control de llamadas desde nuestra infraestructura o te basta con gestionar recursos por API Cloud.

9. Buenas prácticas antes de poner la integración en producción

Antes de lanzar, conviene tener en pie unas cuantas cosas:

• El token vive en un gestor de secretos. No en logs, no en capturas, no en tickets.
• La aplicación sale por la IP habilitada. Si cambia, se solicita actualización antes de que la producción se rompa.
• Las peticiones se realizan por HTTPS. Sin excepciones.
• La aplicación trata tanto respuestas correctas como errores y muestra al usuario mensajes comprensibles, sin exponer datos internos o credenciales.
• Las operaciones de compra no se repiten automáticamente sin comprobar su resultado. Una repetición ciega puede generar una solicitud adicional.
• Los archivos de verificación se protegen durante todo su ciclo de vida. Contienen información personal.
• Existe un procedimiento para renovar o sustituir credenciales si algo huele a compromiso.

Y una regla que evita muchos dolores de cabeza: no mantengas listas fijas de países, ciudades o precios en tu aplicación. Consulta esa información desde API Cloud cuando la necesites. Así no se te queda desactualizada.

Conclusión

Si has llegado hasta aquí, probablemente estás construyendo algo. Un SaaS, un CRM, un producto de agentes de voz, una plataforma vertical para un sector concreto.

Nosotros no queremos que construyas la infraestructura de voz. Esa parte ya la tenemos hecha. Lo que queremos es que tu producto sea el que ve tu cliente, con tu marca, tu experiencia y tu manera de trabajar. API Cloud existe para que puedas hacerlo sin tener que replicar por tu cuenta lo que ya funciona en nuestro lado.

Sin coste añadido, con acceso programático a numeración, Centralita Virtual, extensiones, grabaciones, transcripciones, análisis del sentimiento, llamadas y enrutamiento. Y con una regla honesta: solo incorporas API Voice si tu arquitectura la necesita de verdad. No por acumular servicios.

Cuando quieras empezar, el camino es corto: cuenta de empresa, token, IP autorizada y ticket para habilitar el acceso. A partir de ahí, la integración es tuya.