API de Nuvoz
Lleve las conversaciones de su negocio a sus propios sistemas. La API de Nuvoz permite iniciar llamadas grabadas, consultar el análisis de cada llamada y su resumen, y aprovechar los compromisos y fechas que la IA detecta en cada conversación.
- URL base
https://api.nuvoz.net/api/v1- Formato
- REST con JSON
- Autenticación
- Token de acceso (Bearer)
- Acceso
- Socios y clientes habilitados
- Actualizado
- 20 de noviembre de 2026
Introducción
#Qué puede construir
Nuvoz convierte llamadas, reuniones y audios en información accionable. Con la API, su aplicación usa las mismas capacidades que la app y la plataforma web, con la identidad y el plan de una cuenta autorizada.
| Capacidad | Para qué sirve |
|---|---|
| Llamadas grabadas | Iniciar una llamada desde su sistema y obtener su grabación sin instalar nada en el teléfono. |
| Transcripción y resumen | Texto completo de la conversación, resumen, sentimiento y palabras clave. |
| Compromisos y fechas | Tareas acordadas y citas detectadas en la conversación, listas para su agenda o CRM. |
| Contactos | Vincular cada conversación con el cliente correspondiente. |
| Calendario | Enviar las citas detectadas al calendario conectado del usuario. |
Introducción
#Cómo funciona
- AutenticaSu integración obtiene un token de acceso con las credenciales de una cuenta habilitada.
- Inicie o envíeInicie una llamada grabada o registre la información de su cliente.
- Consulte el estadoEl procesamiento es asíncrono: consulte el estado hasta que el resultado esté listo.
- Use el resultadoLea el análisis de la llamada, el resumen, los compromisos y las fechas, y llévelos a sus sistemas.
Seguridad
#Acceso y autenticaciónDisponible
El acceso a la API se habilita por solicitud. Al aprobar su integración, el equipo de Nuvoz le entrega la guía técnica de su caso de uso y una cuenta de pruebas.
- Cada solicitud protegida envía el token en el encabezado
Authorization: Bearer <access_token>. - Los tokens vencen y pueden renovarse; al terminar, cierre la sesión.
- La integración actúa con la identidad, el plan y los permisos de la cuenta autorizada: nunca puede leer datos de otra cuenta.
curl -sS "https://api.nuvoz.net/api/v1/contacts" \
-H "Authorization: Bearer $NUVOZ_TOKEN"Contrato
#Convenciones
La API usa JSON sobre HTTPS y códigos de estado HTTP estándar. Las guías de cada integración documentan los campos de entrada y salida de cada operación.
| Tema | Convención |
|---|---|
| Identificadores | Cada recurso tiene un identificador estable para enlazarlo con sus sistemas. |
| Fechas | ISO 8601 en UTC, por ejemplo 2026-11-05T14:02:11Z. |
| Teléfonos | Formato internacional E.164, por ejemplo +573001234567. |
| Compatibilidad | Use solo los campos documentados en su guía. Pueden aparecer campos nuevos sin previo aviso. |
Contrato
#Manejo de errores
Cada error incluye un código y un identificador de solicitud. Programe contra el estado HTTP y el código de error, nunca contra el texto del mensaje.
| HTTP | Significado | Qué hacer |
|---|---|---|
| 400 | Solicitud inválida | Corrige los datos enviados. No reintentes igual. |
| 401 | Sesión ausente o vencida | Renueve el token o vuelva a iniciar sesión. |
| 403 | Operación no habilitada para la cuenta | Verifique la habilitación con Nuvoz. |
| 404 | Recurso no encontrado | Revise el identificador. |
| 409 | Conflicto de estado | Espere a que termine la operación en curso y reintente. |
| 429 | Demasiadas solicitudes | Espere antes de reintentar. |
| 5xx | Error temporal | Reintente con espera progresiva. |
Operación
#Buenas prácticas
- Consulte los estados con intervalos de varios segundos y deténgase al recibir un estado final.
- Reintente solo errores temporales, con espera progresiva.
- Conserva el identificador de solicitud de los errores para agilizar el soporte.
- Mantenga los tokens y los datos de clientes en su servidor, nunca en el navegador ni en la app.
Seguridad
#Privacidad y responsabilidades
- Los datos de cada cuenta están aislados y solo los consulta un token de esa cuenta.
- Las grabaciones se almacenan de forma privada y se cifran en tránsito.
- Toda llamada grabada exige registrar el consentimiento correspondiente.
Soporte
#Acceso y soporte
Para habilitar una integración o reportar un incidente, escriba a soporte@nuvoz.net con su caso de uso o con el identificador de solicitud, el endpoint y la hora aproximada (UTC). Nunca envíe tokens, contraseñas ni códigos de verificación.
Socios habilitados: API de llamadas para agendamiento (acceso restringido).