NuvozTecnología de voz que conecta.
Hablemos
Ir al contenido de la documentación
Documentación técnicaREST API · v1

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.

CapacidadPara qué sirve
Llamadas grabadasIniciar una llamada desde su sistema y obtener su grabación sin instalar nada en el teléfono.
Transcripción y resumenTexto completo de la conversación, resumen, sentimiento y palabras clave.
Compromisos y fechasTareas acordadas y citas detectadas en la conversación, listas para su agenda o CRM.
ContactosVincular cada conversación con el cliente correspondiente.
CalendarioEnviar las citas detectadas al calendario conectado del usuario.

Introducción

#Cómo funciona

  1. AutenticaSu integración obtiene un token de acceso con las credenciales de una cuenta habilitada.
  2. Inicie o envíeInicie una llamada grabada o registre la información de su cliente.
  3. Consulte el estadoEl procesamiento es asíncrono: consulte el estado hasta que el resultado esté listo.
  4. 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.
Ejemplo de solicitud autenticadabash
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.

TemaConvención
IdentificadoresCada recurso tiene un identificador estable para enlazarlo con sus sistemas.
FechasISO 8601 en UTC, por ejemplo 2026-11-05T14:02:11Z.
TeléfonosFormato internacional E.164, por ejemplo +573001234567.
CompatibilidadUse 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.

HTTPSignificadoQué hacer
400Solicitud inválidaCorrige los datos enviados. No reintentes igual.
401Sesión ausente o vencidaRenueve el token o vuelva a iniciar sesión.
403Operación no habilitada para la cuentaVerifique la habilitación con Nuvoz.
404Recurso no encontradoRevise el identificador.
409Conflicto de estadoEspere a que termine la operación en curso y reintente.
429Demasiadas solicitudesEspere antes de reintentar.
5xxError temporalReintente 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).