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.
Nombre de atributo | Valores permitidos | Valor predeterminado |
---|---|---|
voice | man, woman, alice o cualquiera de las voces de Amazon Polly | man (para el proveedor básico); Salli (para el proveedor de Amazon Polly). Consulta la consola de texto a voz para realizar la configuración. |
loop | número entero >= 0 | 1 |
language | ver a continuación | ver a continuació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:
Nombre de atributo | Valores permitidos | Valor predeterminado |
---|---|---|
language | en, en-gb, es, fr, de | en |
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:
Nombre de atributo | Valor predeterminado |
---|---|
language | en-US |
Valores permitidos | Idioma, localidad |
da-DK | Danés, Dinamarca |
de-DE | Alemán, Alemania |
en-AU | Inglés, Australia |
en-CA | Inglés, Canadá |
en-GB | Inglés, Reino Unido |
en-IN | Inglés, India |
en-US | Inglés, Estados Unidos |
ca-ES | Catalán, España |
es-ES | Español, España |
es-MX | Español, México |
fi-FI | Finés, Finlandia |
fr-CA | Francés, Canadá |
fr-FR | Francés, Francia |
it-IT | Italiano, Italia |
ja-JP | Japonés, Japón |
ko-KR | Coreano, Corea |
nb-NO | Noruego, Noruega |
nl-NL | Neerlandés, Países Bajos |
pl-PL | Polaco, Polonia |
pt-BR | Portugués, Brasil |
pt-PT | Portugués, Portugal |
ru-RU | Ruso, Rusia |
sv-SE | Sueco, Suecia |
zh-CN | Chino (mandarín) |
zh-HK | Chino (Cantonés) |
zh-TW | Chino (Mandarín taiwanés) |
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á.
Sustantivo | Descripción |
---|---|
Texto sin formato | El texto que Twilio lee al agente de llamada. Las voces TTS básicas están limitadas a 4096 caracteres UTF-8 de un solo byte. Las voces Polly están limitadas a 3000 caracteres UTF-8 de un solo byte, sin incluir las etiquetas SSML. |
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.
¿Necesitas ayuda?
Todos la necesitamos a veces; la programación es difícil. Obtén ayuda ahora de nuestro equipo de soporte, o recurre a la sabiduría de la multitud visitando Stack Overflow Collective de Twilio o navegando por la etiqueta de Twilio en Stack Overflow.