Telefonía y Voice AI
El módulo Telefonía de GoWeBa transforma su navegador web en un sistema telefónico empresarial completo. Gracias a la integración con Twilio y la tecnología WebRTC, puede realizar y recibir llamadas, enviar SMS e incluso desplegar un agente Voice AI que responde automáticamente a sus clientes — todo sin salir de la plataforma.
Arquitectura de telecomunicaciones
GoWeBa utiliza una arquitectura de telecomunicaciones híbrida que combina:
- Twilio como proveedor de conectividad telefónica (PSTN)
- WebRTC para llamadas directamente desde el navegador (no se requiere teléfono físico)
- Voice AI basado en Twilio Gather + LLM para respuestas automáticas inteligentes
- SMS bidireccional para comunicaciones de texto
- IVR (Respuesta de Voz Interactiva) configurable para el enrutamiento de llamadas entrantes
Números GoWeBa
GoWeBa asigna números telefónicos canadienses a cada organización:
Los números se provisionan mediante Twilio y se facturan al costo del proveedor × 1.30 (margen de telecomunicaciones).
Llamadas VoIP — Click-to-Call
Realizar una llamada saliente
GoWeBa permite realizar llamadas directamente desde el navegador sin teléfono físico:
- Hacer clic en el botón de llamada — Desde una ficha de contacto, la bandeja de entrada o el marcador
- Seleccionar el número de origen — Elegir entre los números de la organización
- Conexión WebRTC — El navegador establece una conexión de audio segura
- Comunicación — Hablar directamente por el micrófono/altavoz de la computadora
- Fin de la llamada — Colgar mediante el botón o cerrar el panel 💡 Use audífonos con micrófono para una calidad de audio óptima durante las llamadas WebRTC.
Recibir una llamada entrante
Cuando llega una llamada a un número GoWeBa, el sistema sigue este flujo:
- Llamada entrante detectada — Twilio enruta la llamada hacia GoWeBa
- ¿Voice AI activado? — Si sí → el agente Voice AI responde automáticamente (sección 4)
- ¿IVR configurado? — Si sí → el menú vocal guía al llamante
- Notificación del navegador — El usuario recibe una notificación de timbre en GoWeBa
- Respuesta — El usuario acepta la llamada — conexión WebRTC establecida
- Grabación — Si está activada, la llamada se graba con consentimiento
Parámetros de llamada
Registro de llamadas (Call Log)
Todas las llamadas se registran en la sección Inbox → Llamadas con la siguiente información:
Funcionalidades post-llamada IA
Transcripción
GoWeBa transcribe automáticamente las llamadas grabadas en segmentos numerados:
- Transcripción segmentada: cada intervención es un segmento distinto con marca de tiempo
- Identificación del hablante: distinción entre CALLER (llamante) y AGENT (usuario)
- Texto final vs parcial: el texto parcial se muestra en tiempo real, el final después del procesamiento
- Idioma detectado: la transcripción se adapta al idioma de la conversación
Resumen automático de llamada
Después de una llamada, WEBA puede generar un resumen inteligente con un clic:
- El usuario hace clic en «Resumen» — Desde el registro de llamadas o la ficha de la llamada
- Recuperación de la transcripción — Los segmentos se ensamblan en texto completo
- Análisis por GPT-4.1 — El modelo IA analiza la conversación
- Generación del resumen — Puntos clave, decisiones tomadas, próximos pasos
- Guardado — El resumen se almacena con la llamada para referencia futura El resumen incluye: los participantes, el tema principal, las decisiones tomadas, los compromisos de cada parte y las acciones de seguimiento recomendadas.
Elementos de acción (Action Items)
Además del resumen, WEBA extrae automáticamente las acciones concretas mencionadas durante la llamada:
- Tareas a crear: «Le voy a enviar la cotización para el viernes»
- Recordatorios a programar: «Llámeme la semana que viene para confirmar»
- Documentos a preparar: «Voy a preparar el contrato de servicio»
- Seguimiento a realizar: «Verificar la disponibilidad de la sala de conferencias» 💡 Los elementos de acción se pueden convertir en tareas GoWeBa con un clic, directamente desde el resumen.
Grabación y reproducción
Las llamadas grabadas se almacenan de forma segura:
- Formato: MP3 o WAV según la configuración
- Almacenamiento: Nube segura con cifrado en reposo
- Acceso: Reproducción directamente en GoWeBa, descarga con un clic
- Retención: Configurable (30, 60, 90 días o ilimitado)
- Cumplimiento: Aviso de consentimiento antes de la grabación ⚠️ En Canadá (Ley C-36) y en Quebec (Código Civil), se requiere el consentimiento de al menos una de las partes para la grabación de una conversación telefónica.
Voice AI — Agente vocal inteligente
Concepto
Voice AI es el agente vocal inteligente de GoWeBa que responde automáticamente a las llamadas entrantes. Utiliza el reconocimiento de voz (STT), un modelo de lenguaje (LLM) y la síntesis de voz (TTS) para tener una conversación natural con el llamante — en francés, inglés o español. A diferencia de un IVR clásico que ofrece un menú rígido («presione 1 para...»), Voice AI comprende las solicitudes en lenguaje natural y responde de forma inteligente y contextual.
Configuración
Cada número de teléfono puede tener su propia configuración de Voice AI:
Voces disponibles (Amazon Polly)
Modo multilingüe
Cuando voiceAiMultiLang está activado, Voice AI propone un menú de selección de idioma al inicio de la llamada: «Bonjour! Hello! ¡Hola! Pour le français, dites français ou appuyez sur 1. For English, say English or press 2. Para español, diga español o presione 3.» Cada idioma puede tener:
- Su propio mensaje de bienvenida personalizado
- Su propio prompt de sistema (instrucciones de IA específicas)
- Su propia voz de síntesis
Fallback (respaldo)
Cuando Voice AI no puede responder (tiempo excedido, error, solicitud de transferencia), se activa la acción de respaldo:
SMS bidireccional
Envío de SMS
GoWeBa permite enviar SMS desde los números de la organización:
- Envío individual: desde una ficha de contacto o la Webabox
- Envío masivo: mediante las campañas de marketing (Módulo 15)
- SMS automatizados: activados por workflows o WEBA
- Templates: modelos de SMS reutilizables con variables
Recepción de SMS
Los SMS entrantes aparecen en la Webabox como mensajes normales:
- Notificación instantánea en el navegador
- Asociación automática al contacto (si el número es conocido)
- Historial conversacional: los SMS se muestran en el hilo del contacto
- Respuesta directa: responder al SMS desde la Webabox
Facturación SMS
El margen de telecomunicaciones del 30% (1.30×) se aplica a todos los costos de comunicación.
IVR — Respuesta de Voz Interactiva
Configuración del IVR
El IVR (Interactive Voice Response) permite configurar un menú vocal automatizado:
- Mensaje de bienvenida personalizado para cada número de teléfono
- Opciones de menú: «Presione 1 para ventas, 2 para soporte...»
- Enrutamiento hacia usuarios o grupos específicos
- Horarios: mensajes diferentes según las horas de atención
IVR vs Voice AI
Administración de telefonía
Gestión de números
Accesible mediante Admin → Telefonía. Permite:
- Ver los números activos — Lista de todos los números de la organización con estado
- Configurar el IVR — Modificar el mensaje de bienvenida de cada número
- Activar/desactivar Voice AI — Configurar el agente vocal IA por número
- Provisionar un nuevo número — Solicitar un número local o gratuito mediante Twilio
- Liberar un número — Desactivar un número que ya no se utiliza
Estadísticas de llamadas
La API /api/phone/call-stats proporciona estadísticas consolidadas:
Buzón de voz
Los mensajes de voz son accesibles mediante la sección Inbox → Voicemails:
- Reproducción directa: reproducir el mensaje de audio en el navegador
- Transcripción automática: el mensaje de voz se transcribe en texto
- Notificación: alerta cuando se recibe un nuevo mensaje de voz
- Asociación al contacto: el mensaje se vincula al contacto llamante
- Marcado leído/no leído: gestión del estado de lectura
Integración con WEBA
Agente telefónico WEBA
El agente telefónico de WEBA (Agente #15 — Phone Agent) puede:
- Realizar una llamada por chat: «Llama a Jean-Pierre al 514-555-1234»
- Resumir una llamada reciente: «Resume mi última llamada»
- Extraer acciones: «¿Cuáles son las acciones pendientes de mi llamada con Acme?»
- Programar un recordatorio: «Llama de vuelta a Acme el jueves a las 10h» → crea evento + tarea
Flujo Voice AI → WEBA
Cuando Voice AI está activo, el flujo de procesamiento es el siguiente:
- Llamada entrante — Twilio enruta hacia el número GoWeBa
- Voice AI activado — Detección de voiceAiEnabled = true
- Bienvenida vocal — Se pronuncia el mensaje de bienvenida (TTS Polly)
- Escucha (Gather) — Twilio STT transcribe el habla del llamante
- Análisis LLM — El texto transcrito se envía a GPT-4.1 con el prompt del sistema
- Respuesta — La respuesta del LLM se pronuncia mediante TTS
- Bucle — Regreso al paso 4 hasta el fin de la conversación o timeout
- Post-procesamiento — Transcripción completa, resumen y elementos de acción generados
Facturación de telecomunicaciones
La facturación de telecomunicaciones sigue la Ley 1.30× (margen del 30% sobre el costo del proveedor):
Los costos de Voice AI combinan los cargos de telecomunicaciones (1.30×) y los cargos de IA (1.40×) que se suman.
Casos de uso concretos
Escenario: Soporte al cliente Voice AI 24/7
Situación: Una PYME quiere ofrecer soporte telefónico fuera del horario de oficina.
- Configuración — Activar Voice AI en el número gratuito con un prompt orientado a soporte
- Bienvenida — «Hola, gracias por llamar a [Empresa]. ¿En qué puedo ayudarle?»
- El cliente llama — El cliente pregunta: «Tengo un problema con mi pedido #12345»
- Voice AI responde — El LLM consulta la base de conocimientos y responde con la información pertinente
- Fallback — Si el problema es complejo, Voice AI propone dejar un mensaje de voz
- Seguimiento — Al día siguiente, el equipo ve la transcripción, el resumen y las acciones pendientes
Escenario: Click-to-Call desde el CRM
- El usuario abre una ficha de contacto — Se muestra el número de teléfono
- Clic en el icono de teléfono — Se abre el marcador con el número pre-llenado
- Llamada mediante WebRTC — La llamada se realiza desde el navegador, sin teléfono necesario
- Durante la llamada — El usuario toma notas en GoWeBa en paralelo
- Fin de la llamada — Resumen IA + elementos de acción generados automáticamente
- Las tareas se crean — Los elementos de acción se convierten en tareas en el pipeline
Escenario: Menú multilingüe Voice AI
- Llamada entrante — El cliente llama al número principal
- Menú multilingüe — «Bonjour! Para español, presione 3. For English, press 2. Pour le français, appuyez sur 1.»
- Selección — El cliente dice «English» o presiona 2
- Cambio de idioma — Voice AI pasa a inglés con la voz Joanna
- Conversación — El agente IA responde en inglés con el prompt del sistema en inglés
- Fin de la llamada — Transcripción en inglés, resumen en inglés
Escenario: Toma de citas por voz
- Un cliente llama — Voice AI responde con el mensaje de bienvenida
- El cliente solicita — «Me gustaría programar una cita para una consulta»
- Voice AI verifica — Consulta el calendario para los horarios disponibles
- Propuesta — «Tengo disponibilidad el martes a las 10h o el miércoles a las 14h. ¿Cuál prefiere?»
- Confirmación — El cliente elige, el evento se crea automáticamente
- SMS de confirmación — Se envía un SMS con los detalles de la cita
Solución de problemas y FAQ
Problemas frecuentes
FAQ
P: ¿Puedo usar mi propio número de teléfono? R: No, GoWeBa provisiona números mediante Twilio. Sin embargo, puede transferir su número existente a Twilio (porting) — contacte al soporte para el procedimiento. P: ¿Voice AI puede tomar pedidos? R: Actualmente, Voice AI puede responder preguntas y programar citas. La toma de pedidos por voz está prevista en una futura actualización. P: ¿Cuánto cuesta una llamada Voice AI de 5 minutos? R: Aproximadamente $0.15 en cargos de telecomunicaciones (5 min × $0.029/min) + aproximadamente $0.10 en cargos de IA (~3-4 turnos de conversación). Total estimado: ~$0.25 por llamada de 5 minutos. P: ¿Las llamadas están cifradas? R: Sí. Las llamadas WebRTC están cifradas de extremo a extremo (SRTP). Las grabaciones se almacenan cifradas en reposo en la nube. P: ¿Se puede configurar Voice AI para que solo responda fuera del horario de oficina? R: Sí, mediante la configuración de horarios del IVR. Voice AI puede activarse únicamente durante las horas especificadas (ej: 17h-9h y fines de semana). P: ¿Cuántos idiomas soporta Voice AI simultáneamente? R: Hasta 3 idiomas con el modo multilingüe (francés, inglés, español). Cada idioma tiene su propia voz e instrucciones. P: ¿Cómo mejorar la calidad de las respuestas de Voice AI? R: Tres palancas:
- Optimice el prompt del sistema con instrucciones precisas
- Alimente la Knowledge Base con las FAQ frecuentes
- Pruebe y ajuste el nivel de formalidad y el estilo de comunicación
Buenas prácticas
- Use voces neuronales — Gabrielle (FR) y Joanna (EN) ofrecen la mejor calidad
- Mantenga los prompts concisos — Un prompt de sistema de 200-300 palabras es ideal para Voice AI
- Configure el fallback — Siempre prevea una opción de respaldo (buzón de voz o transferencia)
- Pruebe regularmente — Llame a su propio número para verificar la experiencia del cliente
- Monitoree los costos — Use las estadísticas de llamadas para optimizar la duración de las conversaciones
- Grabe con consentimiento — Siempre informe al llamante si la llamada se está grabando
— Fin del Módulo 04 —
GoWeBa — Biblia de Operaciones Documento generado el 06 May 2026
| Componente | Tecnología | Rol |
|---|---|---|
| Conectividad PSTN | Twilio Programmable Voice | Enrutamiento de llamadas hacia/desde la red telefónica |
| Llamadas por navegador | WebRTC via Twilio Client SDK | Softphone integrado en el navegador web |
| Voice AI | Twilio Gather + GPT-4.1 | Agente vocal IA que comprende y responde en lenguaje natural |
| SMS | Twilio Programmable SMS | Envío/recepción de mensajes de texto |
| IVR | TwiML + IVR configurable | Menú vocal automatizado para el enrutamiento |
| Grabación | Twilio Recording | Grabación de llamadas con consentimiento |
| Transcripción | Twilio STT + post-procesamiento | Transcripción en tiempo real y post-llamada |
| Síntesis de voz | Amazon Polly (via Twilio) | Voz neuronal de alta calidad en FR/EN/ES |
| Tipo | Formato | Ejemplo | Uso |
|---|---|---|---|
| Local | (XXX) XXX-XXXX | +1 (839) 246-9322 | Llamadas locales, SMS, Voice AI — costo reducido |
| Gratuito | 1-877-XXX-XXXX | +1 (877) 846-9322 | Imagen profesional, llamadas gratuitas para el cliente |
| Parámetro | Descripción | Defecto |
|---|---|---|
| record | Grabar la llamada | false (opt-in) |
| browserCall | Usar WebRTC (navegador) | true |
| fromPhoneNumberId | Número de origen específico | Primer número disponible |
| maxDuration | Duración máxima de la llamada | 60 minutos |
| Campo | Descripción |
|---|---|
| Dirección | INBOUND (entrante) o OUTBOUND (saliente) |
| Número llamante/llamado | Formato E.164 con visualización formateada |
| Duración | En segundos, con formato mm:ss |
| Estado | COMPLETED, NO_ANSWER, BUSY, FAILED, VOICEMAIL |
| Grabación | Enlace a la grabación de audio (si está activada) |
| Transcripción | Transcripción completa de la llamada (si está disponible) |
| Resumen IA | Resumen automático generado por WEBA |
| Elementos de acción | Lista de tareas extraídas de la conversación |
| Contacto asociado | Enlace a la ficha de contacto (si fue reconocido) |
| Fecha/hora | Marca de tiempo completa con zona horaria |
| Parámetro | Tipo | Defecto | Descripción |
|---|---|---|---|
| voiceAiEnabled | Boolean | false | Activar/desactivar Voice AI en este número |
| voiceAiGreeting | Texto | null | Mensaje de bienvenida pronunciado al inicio de la llamada |
| voiceAiSystemPrompt | Texto | null | Instrucciones para el LLM (personalidad, conocimientos, límites) |
| voiceAiLanguage | Código | fr-CA | Idioma principal (fr-CA, en-US, en-CA, es-MX, es-ES) |
| voiceAiVoice | Identificador | Polly.Lea | Voz de síntesis (Amazon Polly via Twilio) |
| voiceAiMaxTurnsSec | Número | 180 | Duración máxima de un turno de habla (30-600 seg) |
| voiceAiFallback | Enum | VOICEMAIL | Acción si Voice AI no puede responder |
| voiceAiMultiLang | Boolean | false | Activar el menú multilingüe |
| voiceAiConfig | JSON | null | Configuración multilingüe avanzada |
| Identificador | Nombre | Idioma | Género | Tipo |
|---|---|---|---|---|
| Polly.Lea | Léa | Francés | Mujer | Estándar |
| Polly.Gabrielle | Gabrielle | Francés | Mujer | Neural (HD) |
| Polly.Mathieu | Mathieu | Francés | Hombre | Estándar |
| Polly.Joanna | Joanna | Inglés | Mujer | Neural (HD) |
| Polly.Matthew | Matthew | Inglés | Hombre | Neural (HD) |
| Polly.Mia | Mia | Español | Mujer | Estándar |
| Polly.Lucia | Lucia | Español | Mujer | Neural (HD) |
| Polly.Sergio | Sergio | Español | Hombre | Estándar |
| Acción | Descripción |
|---|---|
| VOICEMAIL | El llamante es dirigido al buzón de voz |
| TRANSFER | La llamada se transfiere a un número de teléfono humano |
| HANGUP | La llamada se termina cortésmente con un mensaje de disculpa |
| Tipo | Dirección | Costo bruto (~) | Costo usuario (×1.30) |
|---|---|---|---|
| SMS local | Saliente | ~$0.0075 CAD | ~$0.01 CAD |
| SMS local | Entrante | ~$0.0075 CAD | ~$0.01 CAD |
| SMS gratuito | Saliente | ~$0.0075 CAD | ~$0.01 CAD |
| SMS gratuito | Entrante | ~$0.0075 CAD | ~$0.01 CAD |
| MMS (imagen) | Saliente | ~$0.02 CAD | ~$0.026 CAD |
| Criterio | IVR clásico | Voice AI |
|---|---|---|
| Tipo de interacción | Menú por tonos (DTMF) | Conversación en lenguaje natural |
| Inteligencia | Fija, basada en reglas | IA adaptativa, comprende el contexto |
| Configuración | TwiML / IVR Greeting | Prompt de sistema + Knowledge Base |
| Idiomas | Pre-grabados | Detección y adaptación automática |
| Costo | Gratuito (incluido) | Créditos IA por conversación |
| Caso de uso | Enrutamiento simple, horarios de atención | Soporte al cliente, citas, FAQ |
| Métrica | Descripción |
|---|---|
| Total de llamadas | Número total de llamadas (entrantes + salientes) |
| Llamadas entrantes | Número de llamadas recibidas |
| Llamadas salientes | Número de llamadas realizadas |
| Duración promedio | Duración promedio de las llamadas en segundos |
| Tasa de respuesta | Porcentaje de llamadas contestadas vs perdidas |
| Llamadas Voice AI | Número de llamadas atendidas por el agente vocal |
| Buzones de voz | Número de mensajes de voz recibidos |
| SMS enviados | Total de SMS salientes |
| SMS recibidos | Total de SMS entrantes |
| Elemento | Costo bruto | Margen | Costo usuario |
|---|---|---|---|
| Número local / mes | ~$2.00/mes | ×1.30 | ~$2.60/mes |
| Número gratuito / mes | ~$3.00/mes | ×1.30 | ~$3.90/mes |
| Minuto de llamada local | ~$0.013/min | ×1.30 | ~$0.017/min |
| Minuto de llamada gratuita | ~$0.022/min | ×1.30 | ~$0.029/min |
| Voice AI: costo LLM | Variable | ×1.40 | Ley IA estándar |
| SMS | ~$0.0075/msg | ×1.30 | ~$0.01/msg |
| Problema | Causa probable | Solución |
|---|---|---|
| Sin sonido durante la llamada | Micrófono/altavoz no autorizado | Verificar los permisos del navegador (chrome://settings/content/microphone) |
| La llamada no se conecta | Número inválido o no provisionado | Verificar el formato E.164 (+1XXXXXXXXXX) |
| Voice AI no responde | voiceAiEnabled = false | Activar Voice AI en Admin → Telefonía |
| Voz robótica | Voz estándar en uso | Cambiar a una voz neuronal (Gabrielle, Joanna) |
| SMS no recibido | Número no habilitado para SMS | Verificar que el número soporta SMS (Twilio) |
| Transcripción vacía | Llamada demasiado corta o ruido de fondo | Asegurarse de que la grabación está activada y que la llamada dura > 5 seg |
| Resumen IA no disponible | Créditos insuficientes | Recargar la billetera de créditos |
| Eco durante la llamada | Altavoz demasiado fuerte | Usar audífonos, bajar el volumen |
| Llamada cortada después de 3 minutos | voiceAiMaxTurnsSec demasiado bajo | Aumentar la duración máx. (180 → 600 seg) |
| Costos elevados | Llamadas largas con Voice AI | Optimizar el prompt del sistema para respuestas más cortas |