VoiceAgent
Docs
Primeros pasos

Quickstart

Desde cero hasta tu primer agente de voz activo en menos de 10 minutos.

Requisitos previos

  • Una cuenta de VoiceAgent (puedes registrarte gratis en usvoiceagent.com)
  • Una cuenta de Twilio con al menos un número de teléfono activo
  • Tu Account SID y Auth Token de Twilio a mano
1

Crea tu cuenta

Dirígete a usvoiceagent.com/register y completa el formulario de registro con tu nombre, correo electrónico y contraseña. También puedes autenticarte con Google o GitHub para mayor comodidad.

Una vez dentro del dashboard, recibirás un correo de bienvenida con tu API Key personal. Guárdala en un lugar seguro — la necesitarás para autenticar las llamadas a la API REST.

Importante

Nunca compartas tu API Key ni la incluyas en código del lado del cliente (frontend). Úsala siempre desde tu servidor o variables de entorno seguras.

2

Conecta tu número de Twilio

En el dashboard, ve a Configuración → Integraciones → Twilio e ingresa tu Account SID y Auth Token. VoiceAgent validará las credenciales y cargará automáticamente la lista de números disponibles en tu cuenta.

Selecciona el número que deseas usar para tu agente. VoiceAgent configurará automáticamente las URLs de webhook en Twilio. Si prefieres hacerlo manualmente, usa las siguientes URLs:

URLs de webhook para Twilio

Ve a tu número en la consola de Twilio y configura los siguientes campos:

A CALL COMES IN (Voice Webhook)

https://usvoiceagent.com/api/twilio/voice

CALL STATUS CHANGES

https://usvoiceagent.com/api/twilio/status

Asegúrate de que el método HTTP esté configurado en HTTP POST en ambos campos.

3

Configura tu agente

Ve a Agentes → Nuevo agente en el dashboard. Completa la configuración básica:

Nombre del agente

Identificador interno (ej. "Soporte Técnico", "Recepción Hotel Central").

Saludo inicial

El mensaje que el agente pronunciará al inicio de cada llamada. Ej: "Hola, bienvenido a TuEmpresa. ¿En qué puedo ayudarte hoy?"

Instrucciones del sistema

El "prompt" base que define la personalidad, limitaciones y conocimiento del agente. Cuanto más detallado, mejor el comportamiento.

Voz

Selecciona entre más de 40 voces neurales de Azure: españolas, latinoamericanas, masculinas y femeninas.

Idioma

Español (es-ES, es-MX, es-AR), Inglés (en-US, en-GB) y más de 20 idiomas adicionales.

Número Twilio

Asocia el número que configuraste en el paso anterior.

Haz clic en Guardar agente. Tu agente quedará en estado

Activo
de inmediato.

4

Realiza una llamada de prueba

Con el agente activo, simplemente llama al número de Twilio que configuraste. El agente responderá con el saludo definido y podrás mantener una conversación completa.

Alternativamente, puedes lanzar una llamada de prueba desde la API:

curl -X POST https://usvoiceagent.com/api/calls/outbound \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agentId": "agent_xxxxxxxxxxxx",
    "to": "+34600000000",
    "from": "+12125551234"
  }'

Recibirás una respuesta con el callId y el estado inicial. Podrás seguir el estado de la llamada en tiempo real desde el dashboard o mediante webhooks.

Logs de la llamada

Ve a Llamadas en el dashboard para ver la transcripción en tiempo real, el audio de la llamada y los metadatos (duración, sentimiento, intención detectada).

Próximos pasos

Ahora que tienes tu primer agente funcionando, te recomendamos explorar:

  • Cómo funciona — entiende la arquitectura técnica bajo el capó.
  • Webhooks — recibe notificaciones en tiempo real sobre tus llamadas.
  • Llamadas salientes — automatiza campañas de llamadas vía API.
Anterior: IntroducciónSiguiente: Cómo funciona