API del buzón de voz
Last updated
Last updated
Voice Box API es un conector con una API pública diseñada para desplegar el Agente en canales de voz, por ejemplo, creando un Bot que funcione a través de llamadas telefónicas.
Debe crear y configurar un canal final con un conector API de buzón de voz.
Vaya a la pestaña Canales del proyecto dentro de la Carpeta.
2. Pulse el botón Crear canal.
Se abrirá el panel de selección de canal final.
Seleccione Voice Box API.
Se abrirá el panel de creación del Canal Proyecto.
Opcionalmente, introduzca un título para este Canal de Proyectos en el campo Nombre con el marcador de posición Nuevo canal.
El token del campo Channel token es necesario para desplegar la carpeta en el canal de voz. Puedes copiarlo haciendo clic en el botón Copiar este token.
Vaya a la pestaña Configuración ASR. En esta pestaña se establecen los ajustes para recibir la voz del Usuario Bot.
a. Elija un proveedor ASR en el campo Proveedor ATS. Puede ser Graphlogic o Google.
b. Si elige Graphlogic, rellene los siguientes campos:
i. Elija el idioma que el Bot reconocerá en el campo Idioma
ii. Elige la frecuencia de muestreo de la voz en el campo Frecuencia de muestreo, Hz.
c. Si eliges Google:
i. En primer lugar, debes crear una cuenta de servicio de Google.
ii. Después de crear una cuenta, tienes que habilitar la API para TTS y STT en ella. Para ello, sigue los enlaces y haz clic en Habilitar.
iii. Obtener un json, que le permite ponerse en contacto con la API de Google. Para obtener json, vaya a la pestaña Claves en la configuración de la cuenta de servicio, haga clic en AÑADIR CLAVE -> Crear nueva clave -> JSON.
iv. A continuación, vuelva a la Plataforma y rellene los siguientes campos:
Sube el json recibido en el campo de credenciales de Google.
Elige el idioma que reconocerá el Bot en el campo Idioma.
3. Elige la frecuencia de muestreo de la voz en el campo Frecuencia de muestreo, Hz.
4. En el campo Modelo ASR:
a. Corto: utilice este modelo para enunciados cortos de unos segundos de duración. Resulta útil para capturar órdenes u otros casos de uso del habla dirigida de una sola vez.
b. Largo: utilice este modelo para cualquier tipo de contenido largo, como medios de comunicación o discursos y conversaciones espontáneas.
Vaya a la pestaña Configuración TTS. Esta pestaña contiene los ajustes de generación de voz del bot.
a. Si ha elegido Graphlogic, rellene los siguientes campos:
i. Elige la voz que hablará el Bot en el campo Voz.
Las mujeres pueden optar por el inglés;
Árabe es una opción para la lengua árabe;
UK Lada es una opción para el idioma ucraniano.
i. Elige la frecuencia de muestreo de la voz en el campo Frecuencia de muestreo, Hz.
b. Si ha elegido Google, rellene los siguientes campos:
i. Sube el json recibido en el campo de credenciales de Google.
Elige el idioma que hablará el Bot en el campo Idioma.
2. Elige la frecuencia de muestreo de la voz en el campo Frecuencia de muestreo, Hz.
Para guardar el Canal Proyecto sin activarlo, pulse el botón CREAR.
Para guardar y activar el Canal Proyecto, haga clic en el botón CREAR Y ACTIVAR.
a. El Canal Proyecto se guardará y activará si:
i. Se publica el proyecto;
ii. La dirección del canal es accesible;
iii. El webhook del canal se ha registrado correctamente.
b. El Canal Proyecto se guardará pero no se activará si no se cumplen una o varias condiciones.
Para cancelar la creación del Canal Proyecto, pulse el botón CANCELAR.
Para editar un Canal de Proyectos, haga clic en su ficha en la lista de Canales de Proyectos.
Para editar cualquier campo, haga clic en él e introduzca un nuevo valor.
Para aplicar los cambios a un Canal Proyecto activado, pulse el botón APLICAR.
a. Los cambios se aplicarán si:
i. Se publica el proyecto;
ii. La dirección del canal es accesible;
iii. El webhook del canal se ha registrado correctamente.
b. Los cambios no se aplicarán si no se cumplen una o varias condiciones.
Para desactivar el Canal Proyecto, pulse el botón DESACTIVAR.
Para aplicar los cambios a un Canal Proyecto no activado, pulse el botón GUARDAR.
Para aplicar los cambios y activar el Canal Proyecto, pulse el botón GUARDAR Y ACTIVAR.
a. Los cambios se aplicarán y el Canal Proyecto se activará si:
i. Se publica el proyecto;
ii. La dirección del canal es accesible;
iii. Se puede registrar el webhook del canal.
b. Los cambios se aplicarán pero el Canal Proyecto no se activará si no se cumplen una o varias condiciones.
Para cancelar los cambios, pulse el botón CANCELAR.
Para eliminar el Canal Proyecto, pulse el botón ELIMINAR.
Existen algunas características de comunicación en el canal API del Buzón de Voz:
Sólo se admiten mensajes de texto de las ranuras de texto y llenado de ranuras;
El paso por las ranuras de botones y archivos adjuntos en el script se registra en los análisis, pero ninguna de estas ranuras se envía al canal.
Cambiar Modo Chat Slot sólo cierra el Diálogo y no hace nada en el canal.
Actualmente no se admite la asignación de variables de canal desde el canal API del buzón de voz.
Para obtener información sobre la API del buzón de voz, consulte
