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

Menu

Expand
Classifique esta página:

TwiML™ Voice: <Say>

O verbo <Say> converte o texto em fala que é lido de volta para o autor da chamada. <Say> é útil para o desenvolvimento ou para dizer texto dinâmico que é difícil de pré‐gravar. O verbo oferece diferentes opções para vozes, cada uma com seu próprio conjunto compatível de idiomas e gêneros, para que você possa configurar seu TwiML dependendo da sua combinação preferida de gênero e idioma.

Atributos do verbo

O verbo <Say> oferece suporte a diferentes atributos, dependendo do valor de voice definido.

voice

O verbo <Say> permite especificar a voz a ser usada para o texto. As vozes man e woman são compatíveis com os idiomas inglês, espanhol, francês, alemão e italiano. A voz alice fala ainda mais idiomas com suporte para vários locais diferentes em uma voz feminina. Você também pode usar uma das mais de 50 vozes do Amazon Polly. Visite a página Text-to-Speech docs (documentos de Texto em fala) para saber mais.

Nome do atributo Valores permitidos Valor padrão
voice (voz) man (homem), woman (mulher), alice ou qualquer outra voz do Amazon Polly man (homem) (para provedor básico); Salli (para provedor do Amazon Polly).
Consulte o console texto em fala (text-to-speech console) para configurar.
loop inteiro >= 0 1
language (idioma) veja abaixo veja abaixo
voice (voz) = man (homem) ou woman (mulher)

Ao definir a voz para man ou woman, você pode usar os seguintes valores para o atributo de idioma:

Nome do atributo Valores permitidos Valor padrão
language (idioma) en, en-gb, es, fr, de en

Usa um ou mais desses atributos em um verbo <Say> da seguinte maneira:

        
        
        
        voice (voz) = alice

        Ao definir a voz como alice, você pode usar os seguintes valores para o atributo de idioma:

        Nome do atributo Valor padrão
        idioma en-US
        Valores permitidos Idioma, localização
        da-DK Dinamarquês, Dinamarca
        de-DE Alemão, Alemanha
        en-AU Inglês, Austrália
        en-CA Inglês, Canadá
        en-GB Inglês, Reino Unido
        en-IN Inglês, Índia
        en-US Inglês, Estados Unidos
        ca-ES Catalão, Espanha
        es-ES Espanhol, Espanha
        es-MX Espanhol, México
        fi-FI Finlandês, Finlândia
        fr-CA Francês, Canadá
        fr-FR Francês, França
        it-IT Italiano, Itália
        ja-JP Japonês, Japão
        ko-KR Coreano, Coreia do Sul
        nb-NO Norueguês, Noruega
        nl-NL Neerlandês, Países Baixos
        pl-PL Polonês-Polônia
        pt-BR Português, Brasil
        pt-PT Português, Portugal
        ru-RU Russo, Rússia
        sv-SE Sueco, Suécia
        zh-CN Chinês (mandarim)
        zh-HK Chinês (cantonês)
        zh-TW Chinês (mandarim taiwanês)

        Use um ou mais desses atributos em um verbo <Say> da seguinte forma:

              
              
              

              language (idioma)

              O atributo language permite especificar um idioma e uma localidade, com o sotaque e as pronúncias afiliados. A Twilio oferece suporte a idiomas separados , dependendo da voz escolhida. As vozes man ou woman trabalham com as seguintes localidades: Inglês com sotaque estadunidense (en), Inglês com sotaque britânico (en-gb), Espanhol (es), Francês (fr), italiano (it) e alemão (de). O padrão é Inglês com sotaque estadunidense (en).

              A voz alice fala 26 dialetos totais (18 idiomas e 14 localidades). Consulte a tabela acima para obter uma descrição de todos os idiomas e localidades compatíveis com a Alice.

              Observação: se você especificar um idioma e uma localidade que apenas Alice fala, mas não especificar uma voz, você obterá a Alice por padrão. Por exemplo, o seguinte TwiML será padronizado para Alice:

                    
                    
                    

                    loop

                    O atributo loop especifica quantas vezes você gostaria que o texto fosse repetido. O padrão é uma vez. Especificar 0 fará com que o verbo <Say> faça loop até que a chamada seja desligada ou 1.000 iterações sejam realizadas.

                    Nouns (Substantivos)

                    O noun de um verbo do TwiML é o conteúdo aninhado no verbo; é o elemento sobre o qual o verbo atua. O único substantivo para o verbo <Say> é o texto sem formatação que será reproduzido.

                    Noun (Substantivo) Descrição
                    texto sem formatação O texto que a Twilio lê para o autor da chamada. As vozes TTS básicas são limitadas a 4.096 caracteres UTF-8 de byte único. As vozes da Polly são limitadas a 3.000 caracteres UTF-8 de byte único, não incluindo tags SSML.

                    Regras de aninhamento

                    Você não pode aninhar nenhum verbo em <Say>. Entretanto, você pode aninhar <Say> no verbo <Gather>.

                    Exemplos

                    Exemplo 1: Hello World (Olá, mundo)

                    Quando uma chamada é direcionada para o seguinte documento do TwiML, o autor da chamada ouve "hello world" (Olá, mundo) falado uma vez em voz masculina.

                          
                          
                          

                          Exemplo 2: Hello, Hello (Olá, Olá)

                          Este documento do TwiML diz "Hello" (Olá) duas vezes em português brasileiro:

                                
                                
                                

                                Dicas e usos avançados

                                • Há um limite de 4.096 caracteres Unicode no texto que <Say> pode processar.
                                • Ao traduzir o texto em fala, o verbo <Say> fará suposições sobre como pronunciar números, datas, horas, quantias de dinheiro e outras abreviações. Teste bem essas situações.
                                • Ao dizer números, "12345" será falado como "twelve thousand three hundred forty-five" (doze mil, trezentos e quarenta e cinco), enquanto "1 2 3 4 5" será falado como "one two three four five." ("um dois três quatro cinco")
                                • A pontuação, como vírgulas e pontos, será interpretada como pausas naturais.
                                • <Say> é útil para dizer texto dinâmico que seria difícil de gravar previamente. Nos casos em que o conteúdo de <Say> é estático, você pode considerar gravar uma pessoa ao vivo dizendo a frase e usando o verbo <Play> em vez disso.
                                • Se desejar inserir uma pausa longa, tente utilizar o verbo <Pause>. <Pause> deve ser colocado fora das tags <Say>, não aninhado dentro delas.
                                Classifique esta página:

                                Precisa de ajuda?

                                Às vezes, todos nós precisamos; a programação é difícil. Receba ajuda agora da nossa equipe de suporte, ou confie na sabedoria da multidão navegando pelo Stack Overflow Collective da Twilio ou buscando a tag Twilio no Stack Overflow.

                                      
                                      
                                      

                                      Obrigado pelo seu feedback!

                                      Selecione o(s) motivo(s) para seu feedback. As informações adicionais que você fornece nos ajudam a melhorar nossa documentação:

                                      Enviando seu feedback...
                                      🎉 Obrigado pelo seu feedback!
                                      Algo deu errado. Tente novamente.

                                      Obrigado pelo seu feedback!

                                      Indique‑nos e obtenha USD10 em 3 etapas simples!

                                      Etapa 1

                                      Obtenha o link

                                      Obtenha um link de indicação pessoal gratuito aqui

                                      Etapa 2

                                      Dê USD10

                                      Seu usuário se inscreve e faz a atualização usando o link

                                      Etapa 3

                                      Obtenha USD10

                                      1.250 mensagens SMS grátis
                                      OU 1.000 min de voz grátis
                                      OU 12.000 chats
                                      OU mais