Si conoces Twilio, probablemente sabes que es una de las plataformas de comunicaciones en la nube más populares del mundo. Con Vocals, puedes conectar fácilmente tu número de teléfono de Twilio a un agente de IA conversacional que gestione las llamadas de forma autónoma.
Este tutorial te muestra cómo conectar tu número de Twilio a un agente de voz de Vocals, usando Twilio para gestionar las llamadas telefónicas. Al final de esta guía, tendrás una integración funcional que puede recibir llamadas entrantes en un número de Twilio y enrutarlas a tu agente de Vocals, así como realizar llamadas salientes.
Prerequisitos
Antes de empezar, asegúrate de tener lo siguiente:
- Una cuenta de Twilio — Regístrate gratis aquí
- Un número de Twilio con capacidad de voz — Lee la documentación aquí
- Una cuenta de Vocals — Regístrate aquí
Qué construirás
Esta aplicación de voz enrutará todas las llamadas entrantes de tu número de Twilio a tu agente de Vocals usando la integración nativa de Twilio en Vocals. También podrás realizar llamadas salientes a través de la API REST de Twilio directamente desde el panel de Vocals.
Empezarás creando un agente de voz en Vocals, luego importarás las credenciales de tu cuenta de Twilio, agregarás tu número de teléfono y lo vincularás al agente. Si aún no tienes un agente, te mostraremos cómo crear uno.
Crear un agente en Vocals
Una vez que hayas iniciado sesión en Vocals, dirígete a la sección Agents en el panel de dashboard.usevocals.com.
Haz clic en Crear agente y configura lo siguiente:
- Nombre: Dale un nombre descriptivo a tu agente (ej: "Asistente de atención al cliente").
- Instrucciones del sistema: Define la personalidad y comportamiento del agente. Por ejemplo: "Eres un asistente telefónico amable que ayuda a los clientes con sus consultas."
- Proveedor STT: Selecciona el motor de reconocimiento de voz (ej: Deepgram, OpenAI Whisper).
- Proveedor LLM: Elige el modelo de lenguaje (ej: OpenAI GPT-4, Anthropic Claude).
- Proveedor TTS: Selecciona el sintetizador de voz (ej: ElevenLabs, OpenAI TTS).
Si ya tienes un agente creado, puedes saltarte este paso y usarlo directamente.
Agregar credenciales de Twilio a Vocals
Ahora que tienes un agente para tu aplicación de voz, el siguiente paso es integrarlo con tu número de Twilio. Primero necesitarás obtener tus credenciales de Twilio.
Obtener tus credenciales de Twilio
Abre una nueva pestaña, accede a tu Twilio Console y desplázate hasta la sección Account Info para localizar tu Account SID y tu número de teléfono de Twilio.
Credenciales de la consola de Twilio
| Account SID | ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx |
|---|---|
| Auth Token | (clic en "Show" para revelar y copiar) |
Agregar las credenciales en Vocals
Vuelve a tu panel de Vocals y navega a SIP Providers en el menú lateral. Haz clic en Agregar proveedor y selecciona el tipo "Twilio". Introduce tus credenciales:
Configuración del proveedor Twilio en Vocals
| Nombre (Name) | Twilio (o cualquier nombre descriptivo) |
|---|---|
| Tipo (SIP Type) | Twilio |
| Account SID | Tu Account SID de Twilio |
| Auth Token | Tu Auth Token de Twilio |
Ahora necesitas configurar manualmente el webhook de voz en tu cuenta de Twilio. Ve a Twilio Console → Phone Numbers → tu número → Voice Configuration y en el campo "A call comes in" selecciona Webhook, método HTTP POST, y pega la siguiente URL:
Conectar el agente Vocals a tu número de Twilio
Una vez que tus credenciales han sido importadas, agrega tu número de teléfono de Twilio en la sección Phone Numbers del proveedor SIP que acabas de crear. Introduce el número en formato E.164 (por ejemplo: +34951XXXXXX o +1415XXXXXXX).
El siguiente paso es vincular tu número con tu agente de Vocals. En la sección Phone Numbers del panel, selecciona tu número de Twilio y elige el agente de voz que quieres que atienda las llamadas en el desplegable de agente.
Probar tu integración
Puedes probar tu agente integrado tanto con llamadas entrantes como salientes.
Para una llamada entrante: Simplemente llama a tu número de Twilio desde cualquier teléfono y serás conectado con tu agente de Vocals.
Para una llamada saliente: En el panel de Vocals, navega a la sección Calls, selecciona tu agente y el número de Twilio como origen, introduce el número de destino y haz clic en Iniciar llamada.
En ambos casos, podrás ver el registro detallado de la llamada con la transcripción completa en la sección Calls del panel.
Siguientes pasos
Has integrado con éxito tu número de Twilio con un agente de voz de Vocals. Ahora que tienes un agente funcional vinculado a tu número, puedes mejorar sus capacidades:
- Personaliza la voz: Experimenta con diferentes proveedores de TTS y voces para encontrar la que mejor se adapte a tu marca.
- Configura webhooks: Conecta webhooks para enviar datos de las llamadas a tu CRM, base de datos u otras herramientas en tiempo real.
- Habilita el Voice SDK: Si necesitas que agentes humanos realicen llamadas desde el navegador, puedes configurar opcionalmente el Voice SDK de Twilio en Vocals con una API Key y una TwiML App.
- Monitoriza y optimiza: Usa las analíticas del panel de Vocals para revisar transcripciones, duración de llamadas y métricas de rendimiento de tu agente.
- Escala: Agrega más números de Twilio de diferentes países y asigna agentes especializados a cada uno.