Inicio Rápido
Integra agentes de voz de inteligencia artificial en tu software en menos de 5 minutos con la API REST de NetVoice.
1. Obtén tu API Key
Inicia sesión en la consola de NetVoice y ve a Ajustes > Claves de API. Crea un nuevo token sk_live_.... Mantén este token seguro; tiene los mismos permisos que tu usuario en el dashboard.
2. Haz tu primera llamada automatizada
curl -X POST https://api.netvoice.co/v1/calls \
-H "Authorization: Bearer sk_live_TuTokenAqui123" \
-H "Content-Type: application/json" \
-d '{
"to": "+573001234567",
"agent_id": "ag_9a8b7c6d5e",
"variables": {
"nombre_cliente": "Juan Perez",
"deuda_total": "150000"
}
}'
Autenticación
Todas las peticiones a la API deben realizarse sobre HTTPS. Peticiones HTTP planas fallarán. Usa Bearer Auth enviando tu clave secreta de API en el header de Authorization.
Authorization: Bearer sk_live_TuTokenSecret
Webhooks
Los webhooks te permiten recibir notificaciones en tiempo real cuando cambia el estado de una llamada o cuando se detecta una intención específica por parte de la IA.
Para escuchar webhooks, configura un endpoint HTTPS público en tu servidor y regístralo en el Dashboard de NetVoice.
{
"event": "call.completed",
"call_id": "call_12345abcde",
"status": "completed",
"duration_seconds": 124,
"recording_url": "https://api.netvoice.co/v1/recordings/rec_888",
"transcription": [
{ "role": "agent", "text": "Hola Juan, te llamo de NetVoice. ¿Tienes un minuto?" },
{ "role": "user", "text": "Sí claro, cuéntame." }
],
"extracted_data": {
"intent": "agreed_to_pay",
"payment_date": "2026-05-25"
}
}
Manejo de Errores
La API utiliza códigos HTTP estándar. Los errores 4xx indican un problema en la petición (como parámetros faltantes o tokens inválidos), mientras que los 5xx indican un problema interno de NetVoice.
El cuerpo de la respuesta incluirá un código de error específico y un mensaje para ayudarte a depurar.
{
"error": {
"code": "invalid_api_key",
"message": "La clave proporcionada ha expirado o es incorrecta."
}
}