You are viewing the Spanish (Mexico) site, but your language preference is set to English. Switch to English site →

Menu

Expand
Calificar esta página:

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:

        
        
        

        Using attributes in a Say verb

        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:

              
              
              

              Using a specific language as an attribute in a Say verb

              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:

                    
                    
                    

                    Say verb defaulting on Alice's voice

                    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.

                          
                          
                          

                          Hello World

                          Ejemplo 2: hola, hola

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

                                
                                
                                

                                Hello, Hello in Brazilian Portuguese

                                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.
                                Calificar esta página:

                                ¿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.

                                      
                                      
                                      

                                      Gracias por tus comentarios.

                                      Selecciona los motivos de tus comentarios. La información adicional que nos brindas nos ayuda a mejorar nuestra documentación:

                                      Enviando tus comentarios…
                                      🎉 Gracias por tus comentarios.
                                      Se produjo un error. Inténtalo de nuevo.

                                      Gracias por tus comentarios.

                                      thanks-feedback-gif