Constructor de IA: tu agente no necesita otro prompt. Necesita un teléfono
Cómo aprovisionar numeración, activar grabaciones y transcripciones, y montar centralitas desde tu propia plataforma con la API Cloud de netelip — la capa que conecta tu agente de voz con la red telefónica de verdad. Sin coste de API. Sin tocar el panel. Sin inventar nada.
¡Qué pasa, constructor de IA!
Sí, tú. El que se ha pasado noches en vela optimizando prompts, peleándose con la latencia de su modelo de voz y presumiendo en LinkedIn de que su agente habla como un ángel desde una pestaña del navegador.
Déjame darte uno de esos bofetones de realidad que tanto nos gustan en este blog:
Un navegador web no es un teléfono.
El cliente final no va a buscar a tu agente abriendo una pestaña de Chrome. Va a llamar por teléfono. Al de toda la vida.
Y ahí es donde la teoría del laboratorio se pega un guantazo contra la calle.
¿Cómo aprovisionas números de teléfono automáticamente para los clientes de tu plataforma SaaS sin volverte loco entrando en un panel y haciendo clic número por número?
¿Cómo activas servicios de grabación y transcripción, recuperas los audios de las llamadas o integras toda esa información dentro de tu propia aplicación?
¿Y cómo haces que todo eso escale sin tener a una persona comprando números, creando extensiones y configurando recursos manualmente cada vez que entra un cliente nuevo?
La respuesta no es magia.
Es la API Cloud v1.0 de netelip.
Una interfaz programática sin coste que te permite gestionar desde el código de tu aplicación buena parte de la infraestructura telefónica de netelip: contratar numeración, administrar recursos, crear centralitas virtuales básicas, gestionar extensiones o recuperar grabaciones en Base64, entre otras operaciones.
En otras palabras: tu plataforma puede dejar de limitarse a crear agentes de voz y empezar a gestionar también la infraestructura telefónica que necesitan para operar en el mundo real.
Pero ojo, porque aquí no vendemos humo.
Antes de lanzarte como un loco a picar código contra la URL base de la API, necesitas conocer tres reglas de oro. Están en la documentación oficial y, si las ignoras, tu flamante sistema automatizado puede terminar pegándose un tiro en el pie.
Las tres reglas de oro (antes de tocar nada)
Están en la documentación oficial. Si las ignoras, tu flamante sistema automatizado puede terminar pegándose un tiro en el pie.
1 · La API no te hace inmune a la ley
Puedes automatizar la contratación de numeración, pero no saltarte los requisitos legales asociados a su adquisición.
Si el número necesita documentación de identidad, domicilio o cualquier otra verificación obligatoria, tendrás que aportarla correctamente. La automatización no elimina este proceso.
Si la documentación no es válida o no se presenta dentro del plazo establecido, la numeración no podrá mantenerse activa y podrá ser retirada de la cuenta.
También cuando detrás hay una API preciosa. Un número comprado sin documentación válida no podrá activarse y acabará siendo eliminado de la cuenta.
2 · No confundas API Cloud con API Voice
API Cloud sirve para contratar, consultar y gestionar los recursos disponibles de tu cuenta de netelip. Es la capa administrativa y operativa de la infraestructura.
API Voice sirve para controlar llamadas en vivo: lanzarlas, recibir eventos, ejecutar instrucciones durante la conversación, reproducir audios, capturar tonos, grabar, desviar o finalizar llamadas. Su precio base es de 9,95 euros al mes (IVA no incluido, con 30 días de prueba) y requiere una arquitectura con URL de control. Estas funciones aparecen recogidas en la documentación oficial de API Voice.
Son dos herramientas distintas. Pueden complementarse, pero contratar una no implica necesitar la otra.
Si conectas tus agentes de voz mediante SIP y tu propia plataforma ya se encarga de controlar la conversación, los eventos y las grabaciones, es posible que no necesites API Voice.
Acabas de ahorrarte una capa que no te hacía falta.
3 · No te flipes inventando recursos
Que API Cloud te permita consultar información sobre determinados elementos de una centralita no significa que puedas crearlos, modificarlos o eliminarlos mediante API.
La versión actual puede mostrar información relacionada con IVRs, filtros o colas de llamadas, pero no documenta endpoints para crear o modificar todos esos recursos.
Y en una integración seria solo existe lo que está documentado.
No lo que parece lógico.
No lo que te gustaría que hiciera.
Y, desde luego, no lo que te hayas imaginado durante uno de esos sueños húmedos de desarrollador en los que todas las APIs tienen el endpoint perfecto.
Ahora sí: saca el bloc de notas, prepárate un café bien cargado y baja conmigo al barro de la integración real.
Vamos a conectar un cerebro artificial con la red telefónica de verdad.
Qué es API Cloud (y qué no es)
Nos quitamos la teoría de encima rápido, que sé que tienes el café enfriándose.
La API Cloud de netelip es una interfaz programática y sin coste que permite gestionar los recursos de una cuenta de netelip —numeración, centralitas virtuales, extensiones, grabaciones, transcripciones, análisis de sentimiento y enrutamiento— desde tu propia aplicación, mediante peticiones HTTP (GET/POST) que responden en JSON. Y netelip, para quien no lo conozca, es el operador de telefonía IP (VoIP) en la nube que hay debajo de todo esto.
Dicho en cristiano: es la interfaz que te permite hacer, desde el código de tu propia aplicación, lo que hasta ahora hacías a mano metiéndote en el panel de control de netelip: consultar recursos, crearlos, configurarlos. Punto.
Su razón de existir es un tridente: automatizar tareas que repites como un pato, integrar netelip con tus otros sistemas y gestionar en remoto tus recursos sin tener a nadie haciendo clic uno por uno.
Ahora la parte que a la gente se le olvida. API Cloud no es un panel bonito alternativo. Y no es una aplicación terminada para tu cliente final.
Es el punto de conexión —el enchufe— que tu software usa para pedir información, actualizar configuraciones o ejecutar las operaciones que netelip tiene documentadas. La aplicación que se conecta la construyes y la mantienes tú. netelip proporciona el acceso a la API y presta los servicios contratados, pero no desarrolla la plataforma del cliente.
¿Y cómo hablan? Tu servidor lanza peticiones GET o POST contra una URL base, mete el token de seguridad en una cabecera llamada api-id y netelip te contesta en JSON. Tú interpretas ese JSON y sigues con tu vida.
API Cloud no tiene coste: no te cuesta un euro usarla. Otra cosa son los servicios que crees o contrates a través de ella —numeración, llamadas, API Voice u otros—, que sí tienen sus propias tarifas y condiciones. La API es gratis; lo que enchufes a la API, no siempre.
A quién le sirve esto de verdad
Si te estás preguntando si esto va contigo, te lo pongo fácil.
API Cloud brilla cuando encajas en alguno de estos perfiles:
- Tienes una aplicación o plataforma propia (un SaaS, un panel, un producto).
- Necesitas incorporar recursos de netelip dentro de tus procesos.
- Quieres automatizar gestiones que ahora haces una y otra vez a mano.
- Necesitas consultar o actualizar configuraciones en remoto.
- Gestionas numeración o comunicaciones desde tu propio entorno.
- Y el caso estrella: montas una plataforma SaaS que usa servicios de voz.
Ahora el aviso para navegantes: esto pide capacidad técnica. Alguien tiene que desarrollar la conexión, custodiar las credenciales como si fueran las llaves de casa, interpretar bien las respuestas y —esto se olvida siempre— atender a los usuarios de tu plataforma. netelip te presta la infraestructura; el producto es tuyo, y también lo es su soporte.
Qué puedes gestionar
El inventario de lo que la versión documentada te deja tocar. No es una lista de deseos: es lo que está sobre la mesa.
API Voice
Crear, listar, consultar, configurar, eliminar el recurso y generar su token.
Línea SIP
Consultar identificadores de llamada y la información de crédito y saldo.
Numeración
Listar números, consultar su información y configurar el destino de sus llamadas.
Compra de numeración
Consultar países y ciudades, requisitos, enviar documentación y solicitar la compra.
vDrive
Crear y activar el servicio para el usuario principal de la cuenta.
Centralita Virtual
Crear una centralita básica y consultar su estado, capacidad y recursos.
Extensiones
Listar, crear, consultar, modificar y eliminar; contraseña SIP e identificador.
Grabaciones
Activar, buscar y descargar grabaciones (contenido en Base64).
Transcripciones
Activar y consultar transcripciones; buscar dentro del texto transcrito.
Sentimiento
Activar el análisis y consultar estado y puntuación de las llamadas.
Llamadas
Consultar llamadas realizadas, recibidas y entre extensiones, con filtros.
Enrutamiento
Consultar y modificar cómo trata la Centralita las llamadas de un número.
Cada grupo trae operaciones distintas: unas consultan información, otras crean servicios, modifican configuraciones o completan procesos como la compra de numeración. No todas hacen lo mismo ni se comportan igual — y esa diferencia importa cuando construyes encima.
Cómo funciona una integración
Toda operación, por dentro, sigue el mismo baile. Cambian los datos, pero el recorrido es este.
El token vive en tu servidor, jamás en el navegador. La conexión sale desde un sistema que controlas tú y desde la IP que netelip tiene autorizada. Si el token acaba en el front, en una app instalada en el móvil de un cliente o en una captura de pantalla, la has liado.
Y no todas las operaciones pesan igual. Hay tres familias:
- Consultas. Te devuelven información para pintar paneles, buscadores o inventarios.
- Cambios de configuración. Modifican un recurso que ya existe. Valida antes y enséñale al usuario qué va a pasar.
- Creación de servicios. Dan de alta un API Voice, un vDrive o una Centralita básica. Aquí comprueba antes si la cuenta ya tiene ese recurso, porque la documentación contempla errores cuando ya está activado.
Ojo con la compra de numeración: no es una sola petición, es un proceso de varios pasos. No pintes un número como activo hasta que el proceso termine de verdad.
Enchúfala: activación en 6 pasos
Antes de picar la primera línea contra la URL base, hay que dejar la cuenta lista.
Esto es lo que necesitas tener a mano:
- Una cuenta de empresa en netelip.
- El token de seguridad de la cuenta.
- El ID de cliente.
- Una IP desde la que se realizarán las peticiones.
- Una aplicación o sistema capaz de conectarse con API Cloud.
- Un método seguro para custodiar el token.
- Acceso al sistema de tickets de netelip (tu punto de contacto con el asesor de la cuenta).
Crea una cuenta de empresa
Regístrate a nombre de la empresa titular y completa los datos fiscales, de contacto y facturación antes de empezar la integración.
Genera el token de seguridad
En el panel, entra en «Editar perfil», pulsa el botón para generar el token y guárdalo en un sistema seguro.
Obtén el ID de cliente
Se obtiene pulsando sobre el avatar del panel de control. netelip lo necesitará para habilitar el acceso.
Identifica la IP de acceso
Indica la IP de salida desde la que tu sistema realizará las peticiones y asegúrate de que permanezca disponible.
Solicita la habilitación
Abre un ticket indicando la IP a autorizar, el token de seguridad y el ID de cliente. Es también tu canal de contacto con el asesor de la cuenta.
Prepara la conexión
Una vez habilitado, tu aplicación ya puede usar las operaciones documentadas contra la URL base indicada.
Ni en páginas públicas, ni en aplicaciones instaladas en dispositivos de usuarios, ni en repositorios de código, ni en capturas, ni en tickets. El token identifica tu cuenta entera: trátalo como una contraseña, porque lo es. Y todas las peticiones, por HTTPS.
El catálogo, recurso a recurso
Aquí está el barro. Lo que puedes hacer de verdad con cada recurso, según la versión documentada.
Numeración
Listas los números de la cuenta y sacas de cada uno su país, provincia, fechas de alta y caducidad, formato del identificador y destino. De un número concreto puedes tirar más info: su enrutamiento y su configuración de SMS.
¿Qué configuras? Puedes desactivar la recepción de llamadas, desviarlas a otro número, enrutarlas hacia tu Línea SIP o hacia un servidor SIP externo (por IP, dominio, subdominio o URI SIP), montar un Fax2Mail, o mandar el número hacia una Centralita Virtual o hacia API Voice. También cambias el formato del identificador entrante entre E.164 (país + área + número) y local (área + número). Eso sí, la documentación avisa: la conversión puede no salir bien cuando la llamada se origina fuera del país del número. Y, cuando el número lo admite, activas la recepción de SMS por correo o por URL.
La recepción de SMS no está disponible en todos los números. Consulta la información del número antes y no muestres esta función como si fuera universal.
Comprar numeración
Comprar un número por API no es «elegir y pagar». Es un proceso: seleccionas país, seleccionas ciudad, consultas la disponibilidad cuando toca, obtienes los requisitos, recoges y envías la documentación, guardas la referencia que te devuelven, solicitas la compra y procesas el resultado.
La consulta de países te da identificador, prefijo, nombre y código ISO; la de ciudades, identificador, nombre, prefijo y datos de tarifa o activación. No mantengas una lista fija de países, ciudades o precios en tu aplicación: usa la que devuelve la API para que no se te quede vieja.
Elegir un número concreto solo está documentado para numeración española. Para otros países, la compra va por cantidad de números, no por selección. Y el número pasa por varios estados —seleccionado, documentación enviada, compra solicitada, compra completada, número activado o solicitud con incidencia—: no enseñes un número como operativo hasta que esté de verdad activado.
vDrive
Una operación crea y activa vDrive para el usuario principal de la cuenta: cuota de 1 GB, cuota de usuario de 1 GB, en modo gratuito y con un grupo asociado. Antes de ofrecer la activación, comprueba si la cuenta ya lo tiene y trata el error por si el servicio no puede crearse. ¿Para qué lo quieres? Entre otras cosas, para integrar ahí las grabaciones de las extensiones.
Centralita Virtual
Puedes crear una Centralita Virtual básica e indicar cuántas extensiones iniciales quieres —entre una y diez—. La respuesta te devuelve lo necesario para usarlas: número, nombre, usuario SIP, contraseña y servidor. Esas contraseñas se guardan y se muestran de forma segura, no en un log a la vista de todos.
Y puedes consultar una foto completa del servicio: cuenta SIP, fechas, estado, servicios de grabación, transcripción, sentimiento e integraciones, punto de presencia, límites de capacidad, extensiones, extensiones virtuales, IVR, colas, numeración, filtros y franjas horarias. Sirve para pintar un panel de administración y para saber cuánta capacidad te queda antes de crear nada.
Que la consulta te devuelva información sobre IVRs, colas o filtros no significa que puedas crearlos por API. Solo existe lo que está documentado.
Extensiones
Aquí hay chicha. Listas, creas, consultas, modificas y eliminas extensiones. Al crearlas defines número, nombre, identificador de llamada saliente, idioma de las locuciones (español o inglés; español por defecto), qué pasa si no contesta, comunica o no está disponible, destino del desvío, cuánto suena antes de desviar o cortar (entre 1 y 60 segundos), y si activas grabación, transcripción, sentimiento e integración con vDrive. Si no das número, se usa el siguiente disponible; si no das nombre, se genera a partir del número.
Renovar la contraseña SIP puede dejar sin servicio a los dispositivos configurados con la anterior. Avisa de las consecuencias, confirma la extensión y actualiza de forma segura los sistemas que usen esas credenciales. Y el identificador de llamada no te lo inventes: elígelo entre los valores válidos, no metas cualquier número de la cuenta.
Grabaciones
Activas o desactivas la grabación en la Centralita y buscas grabaciones por tipo de llamada, día, mes, año, origen, destino o extensión, con paginación. Los tipos documentados: realizadas, recibidas, entre extensiones, sala de conferencias y Click to Call.
Para descargar una grabación, la respuesta te llega con su tipo MIME, extensión, tamaño y el contenido del archivo codificado en Base64. Traducción: tú conviertes y proteges ese contenido antes de ofrecer reproducirlo o descargarlo. No es un MP3 servido en bandeja; es Base64 que tienes que decodificar.
Transcripciones y sentimiento
Activas o desactivas la transcripción y consultas los resultados con filtros por tipo, fecha, origen, destino, texto transcrito, valor del sentimiento, condición y paginación. Cada resultado puede traer estado de la transcripción, texto, estado del análisis de sentimiento, puntuación y su detalle.
El sentimiento se puntúa entre 0 y 10, y puedes filtrar con condiciones «igual», «mayor o igual» y «menor o igual». Con eso construyes listados de llamadas por puntuación o pantallas que mezclan transcripción y nota.
La transcripción de llamadas entrantes necesita que estén activos, a la vez, la transcripción y la grabación. Y no le cuelgues a esa puntuación un significado que la documentación no define: un 7 es un 7 según la API, no según lo que tú imagines.
Llamadas y enrutamiento
Consultas llamadas realizadas, recibidas y entre extensiones, con filtros por número, extensión, usuario SIP, origen, destino y fechas, más paginación. La información varía según el tipo de llamada: fecha y hora, origen, destino, nombre del destino, extensión, causa de finalización, duración, importe facturable y el agente que atendió. No asumas que todos los tipos traen los mismos campos. Y de una llamada recibida en una cola puedes sacar su traza de eventos, para entender cómo se distribuyó dentro de la cola.
En el enrutamiento consultas y modificas cómo trata la Centralita las llamadas de un número. Los destinos documentados: una extensión, una extensión virtual, un número de teléfono, una locución, una cola, un IVR, una aplicación API DTMF, una sala de conferencias o directamente el colgado.
Comprueba que el destino existe en la cuenta y usa su identificador válido — la consulta de la Centralita te da esos listados justo para eso. Inventarte un identificador es la receta perfecta para un error feo.
API Cloud vs. API Voice
Esto lo mezcla todo el mundo, así que vamos a clavarlo. Están emparentadas, pero no hacen lo mismo.
| Aspecto | API Cloud | API Voice |
|---|---|---|
| Finalidad | Administrar recursos y configuraciones de la cuenta desde una aplicación propia. | Controlar llamadas entrantes y salientes. |
| Funciones | Crear y configurar API Voice, consultar Línea SIP y crédito, gestionar y comprar numeración, crear vDrive, crear y consultar la Centralita Virtual, gestionar extensiones, consultar llamadas y grabaciones, activar transcripciones y sentimiento y configurar enrutamientos. | Lanzar llamadas, recibir información y eventos, ejecutar acciones durante una llamada y utilizar URL de control e informes. |
| Coste | Sin coste | 9,95 €/mes* |
* API Voice: 9,95 €/mes (IVA no incluido), con prueba gratuita de 30 días, según la información comercial vigente.
Que desde API Cloud puedas crear y configurar un API Voice no significa que estés controlando llamadas. Administrar el recurso ≠ mover la conversación. Para controlar llamadas de verdad —lanzarlas, meter eventos, ejecutar acciones en vivo— usas API Voice y su documentación, aparte.
¿Cuándo te basta solo con API Cloud? Para gestionar numeración, consultar crédito, crear o administrar una Centralita Virtual, gestionar extensiones, consultar llamadas o grabaciones e integrar todas esas tareas en tu propia plataforma.
¿Y cuándo puedes ahorrarte API Voice en una plataforma de agentes? Si conectas tus agentes por SIP, tu plataforma ya gestiona la conversación, tu infraestructura controla los eventos y tú te encargas de las grabaciones y los datos, puede que no la necesites. Solo tirarías de netelip para la numeración y los servicios de voz asociados. La decisión se toma por necesidad técnica, no por comprar numeración ni por usar API Cloud.
Seis casos de uso reales
Procesos que puedes construir con las capacidades documentadas. Sin ciencia ficción.
SaaS que incorpora numeración
Que los administradores de tu plataforma soliciten numeración sin salir de tu aplicación: consultar, documentar, comprar y configurar el destino.
Agentes de voz por SIP
Tu plataforma de agentes de voz integra numeración de netelip, la dirige a tu servidor SIP y tu infraestructura conecta y gestiona la conversación.
Portal de administración de Centralita
Una interfaz propia para consultar y configurar parte de la Centralita: extensiones, contraseñas SIP, identificadores, enrutamientos y grabación.
Panel de calidad de llamadas
Activar grabación, transcripción y sentimiento; consultar y buscar dentro de las transcripciones; filtrar por puntuación y descargar una grabación.
Administración centralizada de API Voice
Listar los API Voice, consultar su configuración, actualizar las URL de control e informes y generar el token cuando haga falta.
Supervisión de saldo e identificadores
Consultar saldo y moneda, avisar cuando el saldo requiere atención y usar los identificadores válidos al configurar extensiones.
El caso 02 es el tuyo, constructor de IA, así que lo abro. Una empresa con su propia plataforma de agentes de voz quiere integrar numeración de netelip. El recorrido posible:
API Voice puede no ser necesaria si tu plataforma gestiona por sí misma la conversación, los eventos, las grabaciones y los datos. Se valora solo si la arquitectura necesita el control de llamadas que ofrece API Voice.
Buenas prácticas y errores que escuecen
Protege la integración, evita operaciones duplicadas y muestra errores que se entiendan.
El resumen que yo pegaría en la pared del equipo:
- Protege el token. Úsalo desde un servidor controlado, guárdalo en un gestor de secretos, no lo metas en código público ni lo muestres en el navegador, no lo envíes a servicios de analítica ni lo copies en tickets, limita el acceso al personal necesario y sustitúyelo si hay riesgo de exposición.
- Usa la IP autorizada. netelip habilita una IP junto con el token y el ID de cliente. Si cambia tu IP de salida, solicita la actualización antes de poner el cambio en producción. Con varios servidores, confirma cuál hace realmente las peticiones.
- Valida los datos antes de enviarlos. Identificadores, país y ciudad, cantidades, números, IPs y URLs, correos, fechas, valores permitidos, dependencias entre opciones y tamaño de la documentación. Validar en tu aplicación no sustituye la validación de API Cloud, pero te ahorra errores y mensajes crípticos.
- Evita operaciones duplicadas. Cuidado especial al crear API Voice, vDrive, una Centralita o extensiones, al comprar numeración, al eliminar recursos y al cambiar contraseñas. Si una petición se interrumpe, comprueba el estado o los recursos existentes antes de repetirla.
Y estos son algunos de los mensajes de error documentados que te vas a cruzar — con lo que toca hacer, no con un «reintenta y reza»:
Comprueba que el token es correcto, la cabecera es correcta, la IP está autorizada, el ID del recurso pertenece a la cuenta y el recurso sigue existiendo. No muestres al usuario final el token ni datos internos durante la comprobación.
Trata el mensaje tal como se recibe. Informa al administrador de que la operación no está disponible en la situación actual de la cuenta y dirige la incidencia a netelip si necesita una aclaración.
En lugar de repetir la creación: consulta el listado, identifica el recurso, obtén su información y utiliza la operación adecuada para modificarlo.
La numeración no se activará sin la documentación válida requerida. Muestra qué documentos solicita API Cloud, comprueba que se han adjuntado, conserva la referencia recibida y no prometas la activación hasta que se complete la validación.
Token de seguridad, token de API Voice, contraseñas SIP, el contenido completo de documentos personales, ni grabaciones o transcripciones — salvo que netelip las solicite por un canal adecuado. Para pedir ayuda, incluye el ID de cliente, fecha y hora, la operación, el recurso afectado, el identificador implicado, la referencia de compra si aplica y el estado y la descripción del error.
Preguntas frecuentes
Las dudas que me llegan cada vez que hablo de esto con alguien que está montando su plataforma.
¿Qué es la API Cloud de netelip?
La API Cloud de netelip es una interfaz programática y sin coste que permite gestionar desde tu propia aplicación —sin entrar al panel— la numeración, las centralitas virtuales, las extensiones, las grabaciones, las transcripciones, el análisis de sentimiento y el enrutamiento de una cuenta de netelip.
¿En qué se diferencian API Cloud y API Voice?
API Cloud administra los recursos y configuraciones de la cuenta (numeración, centralita, extensiones, grabaciones, enrutamiento) y no tiene coste. API Voice controla las llamadas en vivo —lanzarlas, recibir eventos y ejecutar acciones durante la conversación mediante una URL de control— y cuesta 9,95 € al mes (IVA no incluido). Usar una no obliga a usar la otra.
¿La API Cloud tiene coste?
No. Los servicios y recursos gestionados a través de ella pueden tener sus propias tarifas y condiciones vigentes, pero la API en sí no cuesta nada.
¿Necesito conocimientos técnicos?
Sí. La empresa debe desarrollar y mantener una aplicación capaz de autenticarse, hacer peticiones, interpretar las respuestas y proteger las credenciales.
¿Qué necesito para empezar?
Una cuenta de empresa, el token de seguridad, el ID de cliente y la IP desde la que se accederá. Después contactas con netelip para que habilite esa IP junto con los datos de la cuenta.
¿Puedo elegir un número de teléfono concreto?
La selección directa está documentada actualmente solo para numeración española. Para otros países, la compra utiliza la cantidad de números solicitada.
¿Comprar numeración por API evita la verificación documental?
No. Debes aportar la documentación solicitada y completar la verificación. Un número no podrá activarse sin documentación válida y acabaría siendo eliminado de la cuenta.
¿En qué formato se descargan las grabaciones?
En Base64. La respuesta incluye tipo MIME, extensión, tamaño y el contenido del archivo codificado en Base64, que tu aplicación debe decodificar antes de reproducirlo o descargarlo. No es un MP3 servido directamente.
¿Puedo crear IVR, colas o filtros mediante API Cloud?
La consulta general devuelve información sobre esos recursos, pero la documentación no incluye operaciones para crearlos o editarlos. No debe asumirse que pueden administrarse mientras no exista una operación documentada.
¿Puedo conectar agentes de voz por SIP sin API Voice?
Sí, cuando tu propia plataforma gestiona la conversación, los eventos, las grabaciones y los datos. En ese caso solo necesitas de netelip la numeración y los servicios de voz asociados. La necesidad de API Voice depende de la arquitectura.
¿Qué hago si cambia la documentación técnica?
Utiliza siempre la versión vigente de la referencia. Este artículo explica el recorrido funcional, pero los métodos, parámetros y respuestas válidos son los publicados en la documentación técnica.
Recursos oficiales
Los enlaces que trae la documentación. Para implementar, la referencia técnica manda; este artículo solo explica el recorrido.
La opción «Editar perfil» para generar el token es una página privada dentro del panel de netelip, con la sesión iniciada. No la publiques ni la compartas.
La barrera nunca fue el prompt. Fue el cableado.
Montar un agente que hable bonito hace tiempo que dejó de ser el reto. El reto es el otro lado del cristal: la numeración, la centralita, las grabaciones, el enrutamiento — la fontanería aburrida que separa una demo de un producto que atiende llamadas reales.
La API Cloud de netelip no te resuelve el negocio. Pero pone esa fontanería dentro de tu código, para que tu plataforma deje de depender de que alguien entre a un panel a hacer clic. Y eso, cuando escalas, no es un detalle: es la diferencia entre crecer y ahogarte. Y cuando de verdad escalas el volumen de llamadas, el siguiente cuello de botella no es la IA: es tu propia red.
Ahora ya sabes qué se puede tocar, qué no, y por dónde entra el cable. El resto es picar contra la referencia técnica — con las tres reglas de oro pegadas en la pared.
Cada semana, desde las trincheras
Sistemas de voz IA, telefonía e infraestructura contados como se viven en producción. Desde las trincheras, sin asteriscos.
Contacto
¿Estás montando una plataforma de voz y no sabes por dónde meter la telefonía?
Si tienes un producto de agentes de voz, un SaaS que necesita numeración o simplemente quieres entender cómo encaja esta infraestructura en tu operativa, hablemos.
Escríbeme directo. Sin formularios. Sin intermediarios.
Si tienes proyecto, dame contexto. Si no encajamos, te lo digo.