As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá. # Criar prompts no Amazon Connect Avisos são arquivos de áudio reproduzidos em fluxos de chamadas. Por exemplo, a música de espera é um prompt. O Amazon Connect vem com um conjunto de prompts que você pode adicionar aos fluxos. Ou você pode adicionar suas próprias gravações. Recomendamos que você alinhe seus prompts e políticas de roteamento entre si para garantir um fluxo de chamadas estável para os clientes. Você pode criar e gerenciar solicitações usando o site de Amazon Connect administração, conforme descrito nos tópicos desta seção. Ou você pode usar as [Ações de prompt](https://docs.aws.amazon.com/connect/latest/APIReference/prompts-api.html) documentadas no *Guia de referência da API do Amazon Connect *. **Topics** + [Como criar prompts](#howto-prompts) + [Tipos de arquivos compatíveis](#supported-file-types-for-prompts) + [Tamanho máximo para prompts](#max-length-for-prompts) + [O upload em massa de prompts não é compatível com a interface do usuário, API ou CLI](#bulk-upload-prompts) + [Adicione text-to-speech aos prompts em blocos de fluxo no Amazon Polly](text-to-speech.md) + [Criar strings de texto dinâmicas nos blocos Reproduzir mensagem](create-dynamic-text-strings.md) + [Selecionar dinamicamente quais prompts reproduzir no Amazon Connect](dynamically-select-prompts.md) + [Configurar prompts a serem reproduzidos de um bucket do S3 no Amazon Connect](setup-prompts-s3.md) + [Escolha a text-to-speech voz e o idioma para as instruções de áudio no Amazon Connect](voice-for-audio-prompts.md) + [Use tags SSML para personalizar text-to-speech no Amazon Polly](ssml-prompt.md) + [Tags SSML em uma conversa de chat do Amazon Connect](chat-and-ssml-tags.md) + [Tags SSML compatíveis com o Amazon Connect](supported-ssml-tags.md) ## Como criar prompts Este tópico explica como usar o site de administrador do Amazon Connect para criar prompts. Para criar solicitações de forma programática, consulte o Guia de [CreatePrompt](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreatePrompt.html)referência da *Amazon Connect API*. 1. Faça login Amazon Connect usando uma conta que tenha a seguinte permissão de perfil de segurança: + **Números e fluxos**, **Prompts - Criar** 1. No painel de navegação, escolha **Roteamento**, **Prompts**. 1. Na página **Solicitações**, escolha **Adicionar prompt**. 1. Na página **Adicionar prompt**, insira um nome para o prompt. 1. Na caixa **Descrição**, descreva a mensagem. É recomendável usar essa caixa para fornecer uma descrição detalhada da solicitação. É útil para acessibilidade. 1. Escolha as seguintes ações: + **Carregar**: selecione **Escolher arquivo** para carregar um arquivo.wav que você tenha permissão legal para usar. + **Gravar**: escolha **Iniciar gravação** e fale ao microfone para gravar uma mensagem. Escolha **Parar gravação** quando terminar. Você pode escolher **Recortar** para recortar o prompt gravado ou **Limpar gravação** para gravar um novo prompt. 1. Na seção **Configurações do prompt**, insira as etiquetas que você deseja usar para gerenciar o prompt. Por exemplo, você pode ter um departamento que gerencia prompts de saudações. Você pode marcar esses prompts para que os usuários possam se concentrar apenas nas gravações que dizem respeito a eles. 1. Se desejar, adicione tags para identificar, organizar, procurar, filtrar e controlar quem pode acessar esse prompt. Para obter mais informações, consulte [Adicionar tags a recursos no Amazon Connect](tagging.md). Use os filtros na página **Prompts** para filtrar a lista de prompts por **Nome**, **Descrição** e **Etiquetas**. Para copiar o nome do recurso da Amazon (ARN) completo de um prompt com apenas um clique, escolha o ícone **Copiar**. Ao [configurar prompts dinâmicos em um fluxo](dynamically-select-prompts.md), você precisará inserir o ARN completo do prompt. ![\[A página de prompts, as opções de filtro, a opção copiar ARN.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/prompts-filter.png) ## Tipos de arquivos compatíveis Você pode fazer upload de um arquivo .wav pré-gravado para usar em seu aviso ou gravar um no aplicativo web. Recomendamos usar 8 KHz arquivos.wav com menos de 50 MB e menos de 5 minutos de duração. Se você usa bibliotecas de áudio com classificação mais alta, como 16 KHz arquivos, o Amazon Connect precisa reduzi-las para 8 KHz amostras devido às limitações da PSTN. Isso pode resultar em áudio de baixa qualidade. Para obter mais informações, consulte o seguinte artigo da Wikipedia: [G.711](https://en.wikipedia.org/wiki/G.711). ## Tamanho máximo para prompts O Amazon Connect é compatível com prompts com menos de 50 MB e menos de 5 minutos de duração. ## O upload em massa de prompts não é compatível com a interface do usuário, API ou CLI Atualmente, o upload em massa de prompts não tem suporte por meio do console do Amazon Connect ou de forma programática usando a API ou CLI. # Adicione text-to-speech aos prompts em blocos de fluxo no Amazon Polly Você pode inserir text-to-speech solicitações nos seguintes blocos de fluxo: + [Obter entrada do cliente](get-customer-input.md) + [Loop prompts (Avisos em loop)](loop-prompts.md) + [Play prompt (Reproduzir aviso)](play.md) + [Armazenar entradas do cliente](store-customer-input.md) ## Amazon Polly converte text-to-speech Para converter text-to-speech, o Amazon Connect usa o Amazon Polly, um serviço que converte texto em fala realista usando SSML. + As vozes padrão do Amazon Polly, como as vozes neurais e padrão do Amazon Polly, são **gratuitas**. + Você será cobrado pelo uso das vozes generativas do Amazon Polly. Para ver mais detalhes sobre a definição de preços, consulte [Definição de preço do Amazon Polly](https://aws.amazon.com/polly/pricing/). + Se você estiver integrado à [próxima geração do Amazon Connect](https://docs.aws.amazon.com/connect/latest/adminguide/enable-nextgeneration-amazonconnect.html), as vozes generativas serão incluídas como parte dos preços da solução. + Você paga apenas pelo uso de vozes personalizadas, como [vozes de marca](https://aws.amazon.com/blogs/machine-learning/build-a-unique-brand-voice-with-amazon-polly/) exclusivas, associadas à sua conta. ## A voz com melhor som do Amazon Polly O Amazon Polly lança periodicamente vozes e estilos de fala aprimorados. Você pode optar por resolver automaticamente sua text-to-speech voz para a variante de voz mais realista e natural. Por exemplo, se os fluxos usam Joanna, o Amazon Connect automaticamente se adapta ao estilo de conversação de Joanna. **nota** Se nenhuma versão neural estiver disponível, o Amazon Connect usará a voz padrão. **Para usar automaticamente a voz com melhor som** 1. Abra o console do Amazon Connect em [https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/). 1. Se solicitado a fazer login, insira as credenciais AWS da sua conta. 1. Escolha o nome da instância na coluna **Alias da instância**. ![\[Página Instâncias da central de atendimento virtual do Amazon Connect e o alias da instância.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/instance.png) 1. No painel de navegação, escolha **Fluxos**. 1. Na seção Amazon Polly, escolha **Use a melhor voz disponível**. ## Como adicionar text-to-speech 1. Em um fluxo, adicione o bloco que reproduzirá o prompt. Por exemplo, adicione um bloco [Play prompt (Reproduzir aviso)](play.md). 1. Em **Propriedades**, escolha **ext-to-speechT.** 1. Insira texto sem formatação. Por exemplo, a imagem a seguir mostra *Obrigado por ligar*. ![\[Uma mensagem na text-to-speech caixa.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/play-prompt-sample-tts.png) Ou insira SSML, conforme mostrado na imagem a seguir: ![\[Uma mensagem formatada com SSML na caixa. text-to-speech\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/play-prompt-sample-ssml.png) O uso de um texto de entrada aprimorado por SSML permite exercer mais controle sobre como o Amazon Connect gera fala com base no texto fornecido. É possível personalizar e controlar aspectos de fala, como pronúncia, volume e velocidade. Para obter uma lista de tags SSML que você pode usar com o Amazon Connect, consulte [Tags SSML compatíveis com o Amazon Connect](supported-ssml-tags.md). Para obter mais informações sobre o Amazon Polly, consulte [Usar SSML](https://docs.aws.amazon.com/polly/latest/dg/ssml.html) no Guia do desenvolvedor do Amazon Polly. # Criar strings de texto dinâmicas nos blocos Reproduzir mensagem no Amazon Connect Use um bloco [Play prompt (Reproduzir aviso)](play.md) para reproduzir um arquivo de áudio como saudação ou mensagem para os clientes. Você também pode usar atributos de contato para especificar a saudação ou mensagem que é reproduzida para os clientes. Para usar os valores de um atributo de contato para personalizar uma mensagem para um cliente, inclua referências a atributos de contato armazenados ou externos na text-to-speech mensagem. Por exemplo, se você recuperou o nome do cliente de uma função Lambda e ela retorna valores do seu banco de dados de clientes FirstName para LastName e, você pode usar esses atributos para dizer o nome do cliente text-to-speech no bloco incluindo um texto semelhante ao seguinte: + Olá \$1.External. FirstName \$1.Externo. LastName, obrigado por ligar. Essa mensagem é mostrada na imagem a seguir da text-to-speech caixa do [Play prompt (Reproduzir aviso)](play.md) bloco. ![\[Uma mensagem que contém atributos na text-to-speech caixa.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/play-prompt-attribute.png) Como alternativa, você pode armazenar os atributos retornados da função Lambda usando um bloco **Definir atributos de contato** e, em seguida, referenciar o atributo definido pelo usuário criado na string. text-to-speech Se você estiver fazendo referência a um atributo definido pelo usuário que foi definido anteriormente como um atributo de contato no fluxo usando a API, poderá referenciar o atributo usando \$1.Attributes. nameOfAttribute sintaxe. Por exemplo, se o contato em questão tiver os atributos "" e FirstName "LastName" definidos anteriormente, faça referência a eles da seguinte forma: + Olá \$1.Attributes. FirstName \$1.Atributos. LastName, obrigado por ligar. ## Resolução usando cravos Você também pode usar backticks (`) para resolver chaves dinamicamente. Por exemplo, suponha que você recupere o nome de um cliente de uma função Lambda que FirstName retorna valores LastName e valores do seu banco de dados de clientes. Se a preferência do cliente pelo nome a ser usado estiver armazenada em \$1.Attributes. NameToPlay, você pode selecionar dinamicamente o nome apropriado colocando a chave dinâmica entre acentos cravos (`). + Olá \$1.External. ['`\$1.Attributes. NameToPlay`'], obrigado por ligar. # Selecionar dinamicamente quais prompts reproduzir no Amazon Connect Você pode selecionar o prompt a ser reproduzido usando um atributo. 1. Adicione blocos [Set contact attributes (Definir atributos do contato)](set-contact-attributes.md) ao seu fluxo. Configure cada um para reproduzir o prompt de áudio apropriado. Por exemplo, o primeiro pode reproduzir o arquivo .wav quando a central de atendimento estiver aberta. O segundo pode reproduzir o arquivo .wav para quando estiver fechada. A imagem a seguir mostra como você pode configurar um bloco [Set contact attributes (Definir atributos do contato)](set-contact-attributes.md). Neste exemplo, o atributo definido pelo usuário é nomeado **CompanyWelcomeMessage**. Você pode nomear o atributo como quiser. ![\[A página Propriedades do bloco Definir atributos de contato.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/play-prompt-properties-2-a-new.png) 1. No bloco [Play prompt (Reproduzir aviso)](play.md), escolha **Definido pelo usuário** e, em seguida, insira o nome do atributo que você criou na etapa 1, conforme mostrado na imagem a seguir. ![\[A página Propriedades do bloco Reproduzir mensagem.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/play-prompt-properties2.png) 1. Conecte os blocos [Set contact attributes (Definir atributos do contato)](set-contact-attributes.md) ao bloco **Reproduzir mensagem**. O exemplo a seguir mostra como seria se você adicionasse um de cada bloco para testar como isso funciona. ![\[Um fluxo com o bloco Definir atributos de contato conectado a Reproduzir mensagem.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/play-prompt-properties-2-b.png) # Configurar prompts a serem reproduzidos de um bucket do S3 no Amazon Connect Ao configurar prompts nos blocos[Obter entrada do cliente](get-customer-input.md), [Loop prompts (Avisos em loop)](loop-prompts.md), [Play prompt (Reproduzir aviso)](play.md) ou [Armazenar entradas do cliente](store-customer-input.md), você pode escolher um bucket do S3 como local de origem. Você pode armazenar quantos prompts de voz forem necessários em um bucket do S3 e acessá-los em tempo real usando atributos de contato. Para exemplos, veja o bloco [Play prompt (Reproduzir aviso)](play.md). ## Requisitos + **Formatos suportados**: o Amazon Connect oferece suporte a arquivos .wav para serem usados no prompt. Você deve usar arquivos.wav que sejam 8 KHz e áudio de canal mono com codificação U-Law. Caso contrário, o prompt não será reproduzido corretamente. Você pode usar ferramentas de terceiros disponíveis publicamente para converter os arquivos .wav em codificação U-Law. Depois de converter os arquivos, carregue-os no Amazon Connect. + **Tamanho**: o Amazon Connect é compatível com prompts com menos de 50 MB e menos de cinco minutos de duração. + **Para regiões que estão desabilitadas por padrão** (também chamadas de regiões [opcionais](https://docs.aws.amazon.com/general/latest/gr/rande-manage.html)), como África (Cidade do Cabo), o bucket deve estar na mesma região. ## Atualizar a política do bucket do S3 Para permitir que o Amazon Connect reproduza prompts de um bucket do S3, ao configurar o bucket do S3, você deve atualizar a política do bucket para conceder a permissão `connect.amazonaws.com` (a entidade principal do serviço Amazon Connect) para chamar `s3:ListBucket` e `s3:GetObject`. **Para atualizar a política do bucket do S3:** 1. Acesse o console de administrador do Amazon S3. 1. Escolha o bucket que tem os prompts. 1. Escolha a aba **Permissões**. 1. Na caixa **Política do bucket**, escolha **Editar** e cole a política a seguir como seu modelo. Substitua o nome do bucket, a região, o ID da Conta da AWS e o [ID da instância](find-instance-arn.md) pelas suas próprias informações e escolha **Salvar alterações**. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "statement1", "Effect": "Allow", "Principal": { "Service": "connect.amazonaws.com" }, "Action": [ "s3:ListBucket", "s3:GetObject" ], "Resource": [ "arn:aws:s3:::amzn-s3-demo-bucket1", "arn:aws:s3:::amzn-s3-demo-bucket1/*" ], "Condition": { "StringEquals": { "aws:SourceAccount": "123456789012", "aws:SourceArn": "arn:aws:connect:region:123456789012:instance/instance-id" } } } ] } ``` ------ 1. Criptografia: o Amazon Connect não poderá baixar e reproduzir prompts de um bucket do S3 se uma Chave gerenciada pela AWS estiver habilitada nesse bucket do S3. No entanto, você pode usar uma chave gerenciada pelo cliente para permitir que a entidade principal do serviço Amazon Connect (“connect.amazonaws.com”), que habilita a instância do Amazon Connect, acesse o bucket do S3. Veja o snippet de código a seguir: ``` { "Sid": "Enable Amazon Connect", "Effect": "Allow", "Principal": { "Service": "connect.amazonaws.com" }, "Action": "kms:decrypt", "Resource": [ "arn:aws:kms:region:account-ID:key/key-ID" ] } ``` A imagem a seguir mostra onde você coloca o código na guia **Política de chaves** no AWS Key Management Service console. ![\[A página do KMS na qual você adiciona a política de chaves.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/contact-flow-prompts-s3.png) Para obter informações sobre como encontrar o ID da chave, consulte [Encontrar o ID da chave e o ARN](https://docs.aws.amazon.com/kms/latest/developerguide/find-cmk-id-arn.html) no *Guia do desenvolvedor do AWS Key Management Service *. Depois de configurar o bucket do S3 com a política de bucket necessária, configure [Obter entrada do cliente](get-customer-input.md), [Loop prompts (Avisos em loop)](loop-prompts.md), [Play prompt (Reproduzir aviso)](play.md) ou [Armazenar entradas do cliente](store-customer-input.md) para reproduzir um prompt do bucket. **dica** Para obter mais informações sobre buckets do S3, incluindo exemplos e limitações, consulte o bloco [Play prompt (Reproduzir aviso)](play.md). # Escolha a text-to-speech voz e o idioma para as instruções de áudio no Amazon Connect Você seleciona a text-to-speech voz e o idioma no [Set voice (Definir voz)](set-voice.md) bloco. Você também pode usar SSML em bots do Amazon Lex para modificar a voz usada por um bot de chat ao interagir com os clientes. Para obter mais informações sobre como usar SSML em bots do Amazon Lex, consulte [Gerenciar mensagens](https://docs.aws.amazon.com/lex/latest/dg/howitworks-manage-prompts.html#msg-prompts-response) e [Gerenciar contexto da conversa](https://docs.aws.amazon.com/lex/latest/dg/context-mgmt.html#special-response) no Amazon Lex. **dica** Se você inserir texto que não seja compatível com a voz do Amazon Polly que está usando, ele não será reproduzido. No entanto, qualquer outro texto compatível no aviso será reproduzido. Para obter uma lista de idiomas compatíveis, consulte [Idiomas compatíveis com o Amazon Polly](https://docs.aws.amazon.com/polly/latest/dg/SupportedLanguage.html). # Use tags SSML para personalizar text-to-speech no Amazon Polly Quando você adiciona um aviso a um fluxo, pode usar tags SSML para oferecer uma experiência mais personalizada aos clientes. As tags SSML são uma forma de controlar como o Amazon Polly gera fala usando o texto que você fornece. A configuração padrão em um bloco de fluxo para interpretação text-to-speech é **Texto**. Para usar SSML para converter texto em fala em blocos de fluxo, defina o campo **Interpretar como** como **SSML**, conforme mostrado na imagem a seguir. ![\[Imagem das configurações para um bloco de fluxo mostrando o campo Interpretar como da conversão de texto em fala definido como SSML.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/connect-interpret-as-ssml.png) # Tags SSML em uma conversa de chat do Amazon Connect Se você criar text-to-speech texto e aplicar tags SSML, elas não serão interpretadas em uma conversa de bate-papo. Por exemplo, na imagem a seguir, o texto **e as tags** serão impressos na conversa de bate-papo. ![\[Tags SSML em uma caixa de conversão de texto em fala.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/ssml-tags-in-prompt.png) # Tags SSML compatíveis com o Amazon Connect O Amazon Connect oferece suporte às seguintes tags SSML. **dica** Se você usar uma tag incompatível em seu texto de entrada, ela será automaticamente ignorada quando for processada. | Tag | Use para... | | --- | --- | | speak | Todos os textos aprimorados por SSML devem estar entre tags speak. | | break | Adicione uma pausa ao seu texto. A duração máxima de uma pausa é 10 segundos. | | lang | Especifique outro idioma para palavras específicas. | | mark | Coloque uma tag personalizada no texto. | | p | Adicione uma pausa entre parágrafos no seu texto. | | phoneme | Crie uma pronúncia fonética para um texto específico. | | prosody | Controle o volume, a velocidade ou o tom da voz selecionada. | | s | Adicione uma pausa entre linhas ou frases no seu texto. | | say-as | Combine com o atributo interpret-as para orientar o Amazon Polly como dizer certos caracteres, palavras e números. | | sub | Combine com o atributo alias para substituir uma palavra (ou pronúncia) diferente do texto selecionado, como um acrônimo ou abreviação. | | w | Personalize a pronúncia de palavras especificando a parte do discurso da palavra ou significado alternativo. | | amazon:effect name="whispered" | Indique que o texto de entrada deve ser falado em uma voz sussurrada, em vez da fala normal. | Se você usar uma tag incompatível em seu texto de entrada, ela será automaticamente ignorada quando for processada. Para saber mais sobre as tags SSML, consulte [Tags SSML compatíveis](https://docs.aws.amazon.com/polly/latest/dg/supportedtags.html) no Guia do desenvolvedor do Amazon Polly. ## Estilo de fala conversacional e neural Para as vozes neurais **Joanna** e **Matthew** em inglês americano (en-US), também é possível especificar um [Estilo de fala de apresentador](https://docs.aws.amazon.com/polly/latest/dg/ntts-speakingstyles.html).