TwiML™ Voice: <Say>

El verbo <Say> convierte el texto en voz que se lee al agente de llamada. <Say> es útil para el desarrollo o decir el texto dinámico que es difícil de grabar de forma previa. El verbo ofrece diferentes opciones para las voces, cada una con su propio conjunto de idiomas y géneros compatibles, por lo que puedes configurar tu TwiML dependiendo de tu género y combinación de idiomas preferida.

Atributos del verbo

El verbo <Say> admite diferentes atributos, dependiendo del valor de voice que establezcas.

voice

El verbo <Say> te permite especificar la voz que se utilizará en el texto. Las voces man (hombre) y woman (mujer) son compatibles con los idiomas de inglés, español, francés, alemán e italiano. La voz alice habla aún más idiomas y admite distintas variantes en una voz femenina. También puedes utilizar una de las más de 50 voces de Amazon Polly. Visita la página de documentos Texto a voz para obtener más información.

voice = hombre o mujer

Cuando ajustes voice (voz) en man (hombre) o woman (mujer) puedes utilizar los siguientes valores en el atributo de idioma:

Usa uno o más de estos atributos en un verbo <Say>, de la siguiente forma:

voice = alice

Cuando establezcas la voz en alice, puedes utilizar los siguientes valores para el atributo de idioma:

Utiliza uno o más de estos atributos en un verbo <Say>, de esta manera:

language

El atributo language te permite especificar un idioma y una localidad, con el acento y las pronunciaciones asociadas. Twilio admite diferentes idiomas dependiendo de la voz que elijas. Las voces de man o woman funcionan con las siguientes variantes: Inglés con acento estadounidense (en), inglés con acento británico (en-gb), español (es), francés (fr), italiano (it) y alemán (de). El valor predeterminado es el inglés con acento estadounidense (en).

La voz alice habla 26 dialectos en total (18 idiomas y 14 variantes). Consulta la tabla anterior para obtener una descripción de todos los idiomas y variantes compatibles con Alice.

Nota: Si especificas un idioma y una localidad en la que solo habla Alice, pero no especificas una voz, obtendrás Alice de forma predeterminada. Por ejemplo, el siguiente TwiML será Alice de forma predeterminada:

loop

El atributo loop especifica cuántas veces deseas que se repita el texto. El valor predeterminado es una vez. Especificar 0 hará que el verbo <Say> se ejecute en bucle hasta que se cuelgue la llamada o se realicen 1000 iteraciones.

Sustantivos

El sustantivo de un verbo TwiML es el contenido anidado dentro del verbo; es aquello sobre lo que actúa el verbo. El único sustantivo para el verbo <Say> es el texto sin formato que se reproducirá.

Reglas de anidamiento

No puedes anidar ningún verbo dentro de <Say>. Sin embargo, puedes anidar <Say> dentro del verbo <Gather>.

Ejemplos

Ejemplo 1: hola a todos{#examples-1}

Cuando se dirige una llamada al siguiente documento TwiML, el agente de llamada escucha "hello world" (hola a todos) una vez en voz masculina.

Ejemplo 2: hola, hola

En este documento de TwiML, se dice dos veces "Hello" (Hola) en portugués brasileño:

Consejos y usos avanzados

• Hay un límite de 4096 caracteres Unicode en el texto que <Say> puede procesar.
• Cuando se convierte el texto en voz, el verbo <Say> hará suposiciones acerca de cómo pronunciar números, fechas, horas, cantidades de dinero y otras abreviaciones. Prueba bien estas situaciones.
• Cuando dice números, "12345" se pronunciará como "doce mil trescientos cuarenta y cinco!", mientras que "1 2 3 4 5" se pronunciará como "uno dos tres cuatro cinco" .* La puntuación, como comas y puntos, se interpretarán como pausas naturales.
• <Say> es útil para decir texto dinámico que sería difícil de grabar de forma previa. En los casos en que el contenido de <Say> sea estático, puedes considerar grabar a una persona en vivo diciendo la frase y usando el verbo <Play> en su lugar.
• Si deseas insertar una pausa larga, intenta usar el verbo <Pause>. <Pause> debería ser ubicado fuera de las etiquetas <Say>, no anidado dentro de ellas.