Snippet de Comportamiento del Siguiente Aviso

La información de esta página de ayuda se aplica tanto a Studio como a Desktop Studio.

El snippet del Comportamiento del Siguiente Aviso le permite personalizar los comportamientos para un turno en específico de la conversación. Si desea definir comportamientos predeterminados para todos los turnos de la conversación, use un Default Next Prompt Behaviors snippet. Los comportamientos que usted puede definir son ruido de confort, detección de DTMFClosed Signaling tones that are generated when a contact presses a key on the telephone keypad., retrasos y tiempos límite y conectarse a una llamada existente. Puede obtener más información sobre estos comportamientos en la página de ayuda de Comportamientos de los avisos.

Use este Snippet con acciones que tengan la propiedad nextPromptBehavior, como la Cloud Transcribe acción, o la Intercambio de voicebot acción. Debe crear este Snippet en su script.

Tiempo necesarios por turno de conversación

Asegúrese de calcular el tiempo necesario para cada turno de la conversación. Por ejemplo, decir un número de 14 dígitos puede requerir entre ocho y quince segundos sin pausas, pero responder Sí o No requiere únicamente un segundo o DOs. Para capturar todo el número, el turno de conversación en que se diga el número debe ser más largo que el turno para Sí/No.

En el turno en que se diga el número, debe aumentar maxUtteranceMilliseconds a una cantidad mayor que la configuración predeterminada. Además, es posible que también desee ampliar maxPostEnergySilenceMS para ese turno.Esto ayudará a asegurarse que el contacto tenga tiempo para decir el número.

Para cambiar estos valores durante un turno, coloque una acción SNIPPET antes y después de la acción Intercambio de voicebot para ese turno. En el SNIPPET antes de Intercambio de voicebot, cambie la configuración que necesite. En el SNIPPET después de Intercambio de voicebot, vuelva a cambiar la configuración a sus valores anteriores.

Agregar un Snippet de Comportamientos del Siguiente Aviso

  1. Abra su script en Studio.
  2. Add a Snippet action to your script. The location depends on your use case: 
    • Agente virtual sin Voicebot Gateway: Coloque el Snippet antes de la Intercambio de voicebot acción para la cual desea realizar los comportamientos especificados.
    • Agente virtual con Voicebot Gateway: Coloque el Snippet antes de la Continuous Transcription acción.
    • Casos de uso que no SOn de agente virtual: coloque el Snippet antes de la Cloud Transcribe acción.
  3. Conecte las acciones en el script.
  4. Agregue la siguiente declaración de objeto en el Snippet:

    DYNAMIC nextPromptBehaviors
    <add behaviors as needed>
    ASSIGN nextPromptBehaviorsJson="{nextPromptBehaviors.asjson()}"
  5. Agregue los comportamientos que desee que realice la acción, utilizando esta sintaxis:

    ASSIGN nextPromptBehaviors.[behavior] = [value]

    En esta sintaxis,[behavior] incluye el nombre de la propiedad y todos los nombres de miembros y submiembros asociados. Consulte el código de Snippet de ejemplo en la siguiente sección para obtener más información.

  6. Configure la propiedad nextPromptBehavior de la acción Voicebot Exchange o Cloud Transcribe con la variable utilizada para contener el contenido JSON del objeto nextPromptBehaviors. En el código de ejemplo, esto es nextPromptBehaviorsJson.

    Si trabaja con un agente virtual que utiliza Voicebot Gateway, configure la propiedad nextPromptBehavior de la acción Voicebot Exchange en su script.

Propiedades de Comportamiento de Prompt

La siguiente tabla describe las propiedades disponibles para los fragmentos Next Prompt Behavior . Las propiedades le permiten configurar los Comportamientos del siguiente mensaje. Los comportamientos se describen de manera completa en la página de ayuda de Virtual Agent Prompt Behaviors. Los comportamientos funcionan como se describe cuando se usan con aplicaciones que no SOn de Agente virtual de Turn-by-Turn Transcription.

El siguiente ejemplo del snippet Next Prompt Behavior muestra los nombres completos de miembro de objeto y submiembro que se deben usar para cada propiedad.

Propiedad Comportamiento Detalles
audioFilePath Ruido de comodidad durante los retrasos del Agente virtual

Introduzca la ubicación del archivo de audio del ruido de confort. El archivo debe estar ubicado en la estructura de archivos de su sistema. Incluya la ruta completa si el archivo se encuentra en una carpeta. La estructura del archivo se aplica como lo sería para otro comportamiento de solicitud.

Usar con:

  • botResponseDelayTolerance
  • engageComfortSequence
bargeOnUtteranceBeginRatherThanEnd Barge

Controla si la interrupción (barge) se puede activar con la primera palabra o palabras que se detecten, o si no se puede activar hasta que se detecte un enunciado completo.

Configure este parámetro en 1 para habilitar que la interrupción (barge) ocurra en cualquier momento durante el enunciado, o en 0 si desea que el servicio espere hasta el final de un enunciado.

Si su agente virtual utiliza Voicebot Gateway, configure este parámetro en 1.

botResponseDelayTolerance Ruido de comodidad durante los retrasos del Agente virtual

Ingrese la cantidad de tiempo en milisegundos que activa el archivo de audio de ruido de confort.

Usar con:

  • audioFilePath
  • engageComfortSequence

Esta propiedad es únicamente para usarla con el comportamiento de ruido de comodidad. La secuencia de comandos no controla cuándo toma la rama userInputTimeout.. millisecondsToWaitForUserResponse es la propiedad que controla el momento en que se toma esta bifurcación.

clearDigits Recopilación de DTMF

Establezca esta propiedad en verdadero si desea borrar el búfer de tonos DTMF cuando comience la acción. El búfer almacena en caché los tonos DTMF cuando el contacto presiona una tecla en el teclado de su teléfono.

Esta propiedad es similar a la propiedad clearDigits de la acción Menu.

Debe usarse esta propiedad con detectDtmf. Hay opciones adicionales relacionadas con DTMF que puede configurar con propiedades adicionales.

Nota: Su agente virtual debe estar configurado para manejar Entradas dtmf en la consola de gestión del proveedor. Incluso si tiene clearDigits configurado en true, su agente virtual debe poder manejar errores debido a dígitos Dtmf adicionales o retrasos entre entradas. La acción VOICEBOT EXCHANGE pasa la entrada que recopila del contacto al agente virtual.

detectDtmf Recopilación de DTMF

Establezca esta propiedad en verdadero si desea que la acción capture entradas dtmf.

Esta propiedad permite la recopilación de tonos DTMF. Para configurar otras opciones relacionadas con DTMF, debe incluir otras propiedades:

  • clearDigits
  • terminationCharacters
  • stripTerminator
  • interDigitTimeoutMilliseconds
  • maxDigits
enableSpeakerBarge Herramienta de control e interrupción de llamada

Establezca esta propiedad en verdadero para habilitar la barcaza. Esta propiedad debe estar habilitada (verdadero) para la mayoría de las interacciones con bots, pero se puede deshabilitar (falso) cuando el audio contiene información que la persona que llama debe escuchar, como avisos legales.

Puede usarse sola esta propiedad.

engageComfortSequence Ruido de comodidad durante los retrasos del Agente virtual

Establezca la propiedad en verdadero si desea habilitar el ruido de confort para esta acción. Configúralo en falso si no desea que esta acción utilice el ruido de confort.

Usar con:

  • botResponseDelayTolerance
  • audioFilePath
interDigitTimeoutMilliseconds

Recopilación de DTMF

Manejo del Tiempo límite del contacto

Ingrese la cantidad de tiempo en milisegundos que el sistema espera después de que un contacto ingresa un dígito para determinar si el contacto ingresará otro dígito.

Esta propiedad es similar a la propiedad InterDigitTimeout en la acción Menú.

Debe usarse esta propiedad con detectDtmf. Hay opciones adicionales relacionadas con DTMF que puede configurar con propiedades adicionales.

maxDigits Recopilación de DTMF

Ingrese el número máximo de dígitos que el contacto puede ingresar para el aviso de esta acción. Por ejemplo, si el aviso le indica al contacto que ingrese los últimos cuatro dígitos de su número de identificación, establezca esta propiedad en 4. Al alcanzar el valor maxDigits, el script sigue ejecutándose.

Esta propiedad es similar a la propiedad MaxDigits en la acción Menú.

Debe usarse esta propiedad con detectDtmf. Hay opciones adicionales relacionadas con DTMF que puede configurar con propiedades adicionales.

maxPostSilenceMS Espaciado entre turnos

Configure cuánto tiempo, en milisegundos, espera el agente virtual después de que el contacto termina de hablar antes de responder. Esto le permite evitar que el agente virtual hable al mismo tiempo que el contacto.

El valor mínimo es 100 milisegundos (1/10 de segundo) y el valor máximo es 1000 milisegundos (un segundo). El valor predeterminado es 100.

Elija la configuración que le dé al agente virtual la duración de pausa que se sienta más natural para la personalidad del agente virtual. Una pausa más larga puede ser cortés, pero una pausa que dura demasiado puede comenzar a sentirse lenta o hacer que los contactos se preocupen de que la interacción se haya desconectado.

Nota: Esta propiedad solo se puede configurar en el Snippet Comportamientos Predeterminados del Siguiente Aviso. Esto se debe a que los parámetros de script que afectan la transcripción no se pueden modificar después de que Continuous Stream Transcription haya comenzado.

maxPostEnergySilenceMS Manejo del Tiempo límite del contacto

Configure la cantidad de tiempo en milisegundos que el bot espera después de que el contacto hace una pausa mientras habla. El valor predeterminado es 500 milisegundos.

Puede aumentar la duración de la pausa para reducir las posibilidades de que el bot interrumpa los contactos. Cuanto más larga sea la pausa, mayor será la latencia en los intercambios de la interacción. La mejor práctica es aumentar este valor solo cuando espera que la respuesta del contacto sea de dígitos.

Puede usarse sola esta propiedad. No use esta propiedad si su agente virtual utiliza Voicebot Gateway.

maxUtteranceMilliseconds (utteranceConfig)

Manejo del ruido de fondo

Manejo del Tiempo límite del contacto

Solo para utteranceConfig.maxUtteranceMilliseconds.

El agente virtual espera esta cantidad de tiempo, en milisegundos, después de detectar por primera vez el audio del contacto. Esta configuración define la extensión que puede tener una respuesta.

Cuando se llega al límite de maxUtteranceMilliseconds, el agente virtual intenta determinar la intención del contacto a partir del audio captado. Esto es útil si hay mucho ruido de fondo en la línea. Para obtener más detalles sobre cómo funciona esta propiedad, consulte Comportamientos de los avisos del Agente virtual.

De manera predeterminada, esta propiedad tiene la misma configuración que millisecondsToWaitForUserResponse, incluso si ha personalizado millisecondsToWaitForUserResponse. Quizás deba cambiar maxUtteranceMilliseconds, según la extensión que tenga la respuesta prevista del contacto. Por ejemplo, 10 segundos (10,000 milisegundos) es razonable para una respuesta corta de una palabra como sí, no, o soporte técnico. Las respuestas esperadas más largas requerirían más tiempo. El valor máximo es cinco minutos (300,000 milisegundos).

Debe usarse esta propiedad con millisecondsToWaitForUserResponse. No utilice esta propiedad si su agente virtual usa Voicebot Gateway.

maxUtteranceMilliseconds (continuousTranscriptionUtteranceConfig) Rambler Interrupción

Solo para continuousTranscriptionUtteranceConfig. maxUtteranceMilliseconds.

Configure la cantidad de tiempo en milisegundos que el agente virtual espera mientras el contacto habla. Cuando se alcanza este límite, el bot interrumpirá al contacto. Esto le permite evitar que el contacto hable durante demasiado tiempo. Por ejemplo, si establece esta propiedad en 120000, el contacto puede hablar durante DOs minutos antes de que el agente virtual actúe.

El rango para esta propiedad es de 1000 milisegundos (un segundo) a 180000 milisegundos (tres minutos). El valor predeterminado es 6000.

Nota: Esta propiedad solo se puede configurar en el Snippet Comportamientos Predeterminados del Siguiente Aviso. Esto se debe a que los parámetros de script que afectan la transcripción no se pueden modificar después de que Continuous Stream Transcription haya comenzado.

millisecondsToWait
ForUserResponse

Manejo de Tiempo límite del contacto

Manejo del ruido de fondo

Ingrese la cantidad de tiempo en milisegundos que la acción espera una respuesta del contacto antes de alcanzar el tiempo límite. Cuando se alcanza este tiempo límite, el script sigue la ramificación userInputTimeout.

Puede usarse sola esta propiedad.

Al configurar su agente virtual para manejar entornos ruidosos, esta propiedad debe utilizarse con maxUtteranceMilliseconds.

Si su agente virtual usa Voicebot Gateway, cuando el contacto no dice nada durante el tiempo configurado en esta propiedad, se activa la solicitud SILENCE que se envía al agente virtual. El script debe tomar la rama userInputTimeout.

numberOfWordsTo
TriggerUtteranceBegin
Interrupción

Configure la cantidad de palabras que el contacto debe decir antes de que el agente virtual permita que se lo interrumpa. Por ejemplo, si esta propiedad se establece en 3 y el contacto dice "Wait, I'm confused," el agente virtual dejará de hablar. Pero si el contacto dice "Wait", el agente virtual continuará hablando.

El rango para esta propiedad es de 1 a 10 palabras. El valor predeterminado es 1.

Este parámetro se ignora si bargeOnUtteranceBeginRatherThanEnd está configurado como 0.

Nota: Esta propiedad solo se puede configurar en el Snippet Comportamientos Predeterminados del Siguiente Aviso. Esto se debe a que los parámetros de script que afectan la transcripción no se pueden modificar después de que Continuous Stream Transcription haya comenzado.

stripTerminator Recopilación de DTMF

Establezca esta propiedad en verdadero si desea eliminar el valor del carácter de terminación de los tonos DTMF capturados.

Debe usarse esta propiedad con detectDtmf. Hay opciones adicionales relacionadas con DTMF que puede configurar con propiedades adicionales.

terminationCharacters Recopilación de DTMF

Ingrese el carácter que desea que ingresen los contactos para indicar que terminaron de ingresar los dígitos. Por ejemplo, es posible que desee que los contactos presionen la tecla de almohadilla (#) cuando terminen de ingresar un número de cuenta.

Esta propiedad es similar a la propiedad Termination en la acción Menu.

Debe usarse esta propiedad con detectDtmf. Hay opciones adicionales relacionadas con DTMF que puede configurar con propiedades adicionales.

trimSilence Manejo del Tiempo límite del contacto

Defina como verdadero si desea quitar el silencio al comienzo del enunciado del audio que se envía al agente virtual. Esto es útil para reducir la cantidad de tiempo necesaria para procesar cada enunciado. Puede ayudar a reducir la latencia.

El valor predeterminado para trimSilence es false.

Puede usarse sola esta propiedad.

useContinuousTranscription Herramienta de control e interrupción de llamada Configure esta propiedad en 1 (verdadero) al habilitar la interrupción (barge in) cuando su agente virtual esté configurado con Voicebot Gateway. Continuous Stream Transcription es una parte obligatoria de Voicebot Gateway.