Taller 12: IVR con Reconocimiento de Voz (ASR) en Issabel PBX 5 usando Vosk Server

Instalación y configuración de Vosk Server para habilitar reconocimiento de voz en el IVR de Issabel PBX 5

🗣️ Taller 12: IVR con ASR (Vosk) en Issabel PBX 5

🏗️ Arquitectura del Sistema

📦 Instalación del Servidor Vosk ASR

1) Preparar repositorio

yum -y install docker-repo

2) Instalar Vosk Server por idioma

Idiomas disponibles por el momento son: español (es), portugués (pt), inglés (en) y farsi (fa).

# Español
yum -y install vosk-server-es

# Ejemplo para portugués (reemplace el código del idioma)
yum -y install vosk-server-pt

3) Reiniciar Issabel/FreePBX

amportal restart

4) Verificar versión de Asterisk

Debe ser ≥ 16.16.1.

asterisk -rx "core show version"

5) Probar que Vosk responde

Por defecto Vosk escucha en http://127.0.0.1:2700.

curl http://127.0.0.1:2700

Si obtiene una respuesta HTTP (generalmente {"result":"ok"} o similar), el servicio está disponible.

🧩 Configuración de voz en el IVR

Tras la instalación, edite o cree un IVR en el panel web de Issabel y verá el campo “Spoken”/“Hablado” en cada opción del IVR.

🧭 Pasos en la GUI

Ruta: PBX → PBX Configuration → IVR → Add a new IVR (o Edit).

En cada opción del IVR aparecerá el campo Hablado/Spoken.
Ingrese el texto exacto que debe reconocer Vosk para esa opción.

🎙️ Ejemplo de IVR

IVR de bienvenida con opciones:

Opción 1: “ventas” → campo Hablado: ventas
Opción 2: “soporte” → campo Hablado: soporte
Opción 3: “contabilidad” → campo Hablado: contabilidad

⚠️ Coincidencia Exacta

El texto devuelto por Vosk debe coincidir exactamente con lo configurado.
Use minúsculas, sin acentos si su modelo así lo devuelve.
Evite frases largas; prefiera palabras únicas y claras.

🔧 Pruebas y Verificación

# Ver logs en Asterisk
tail -f /var/log/asterisk/full

# Aumentar verbosidad temporalmente
asterisk -rx "core set verbose 5"

# Forzar recarga del dialplan
asterisk -rx "dialplan reload"

Llame al número que ingresa al IVR y pronuncie una de las palabras configuradas.
Verifique en los logs que se envía audio al Vosk y se recibe texto.
Compruebe que el IVR enruta a la opción correcta.

🛠️ Solución de Problemas

Servicio Vosk

Si no responde http://127.0.0.1:2700:

systemctl status vosk-server
journalctl -u vosk-server --no-pager -n 100

Firewall

Si Vosk corre en otra máquina, abra el puerto 2700/TCP y permita tráfico entre Issabel y Vosk.

Asterisk

Tras cambios mayores, reinicie servicios:

amportal restart

Idioma

Verifique que instaló el paquete de idioma correcto (vosk-server-es, vosk-server-pt, vosk-server-en, vosk-server-fa).

✅ Checklist de Implementación

Vosk Server instalado y respondiendo en :2700
Asterisk ≥ 16.16.1 confirmado
IVR con campos Hablado configurados
Llamadas prueban y enrutan por voz
Logs sin errores críticos

⚡ Buenas Prácticas

Mantenga frases simples y vocabulario acotado por opción.
Considere modelos optimizados según su acento y idioma.
Documente las palabras admitidas en cada IVR para el equipo.
Monitoree periódicamente la tasa de aciertos y ajuste términos.

🔗 Sección relacionada: Panel FOP2

Para instalar y asegurar FOP2 como panel de operador, consulte la sección dedicada: “Taller 13: Instalación de FOP2 (Flash Operator Panel 2) en Issabel PBX 5”.

📚 Recursos

📖 Vosk

Modelos y documentación oficial: alphacephei.com/vosk

🧩 Issabel PBX

Guías y comunidad: issabel.org

🔎 Asterisk

Referencia de aplicaciones/IVR: docs.asterisk.org

¡IVR con ASR habilitado!

03-voip-protocolos-codecs