Adicionar um bot do Amazon Lex ao Amazon Connect - Amazon Connect
Criar um bot do Amazon LexConfigurar o bot do Amazon LexCriar e testar o bot do Amazon LexCriar uma versão de bot (opcional)Criar um alias para o botAdicionar o bot do Amazon Lex à instância do Amazon ConnectCriar um fluxo e adicionar o bot do Amazon LexAtribuir o fluxo a um número de telefoneExperimente!

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

Adicionar um bot do Amazon Lex ao Amazon Connect

Importante

Aviso de fim do suporte: em 15 de setembro de 2025, o suporte para o Amazon Lex V1 AWS será interrompido. Após 15 de setembro de 2025, você não poderá mais acessar o console do Amazon Lex V1 nem os respectivos recursos. Para saber mais sobre a migração para o Amazon Lex V2, consulte Migrar um bot.

Neste artigo, orientamos você pelas etapas para adicionar um bot do Amazon Lex ao Amazon Connect.

Com o Amazon Lex, você pode criar interações conversacionais (bots) que pareçam naturais para os clientes. Os bots do Amazon Connect com o Amazon Lex também podem capturar as informações do cliente como dígitos que os clientes inserem no teclado numérico quando usadas em um fluxo do Amazon Connect. Dessa maneira, os clientes podem escolher como desejam inserir informações confidenciais, como números da conta.

Para acompanhar esta demonstração, é necessário ter o seguinte:

  • Uma AWS conta ativa.

  • Uma instância do Amazon Connect.

dica

Você também pode usar o Amazon Lex para potencializar mensagens interativas para o chat do Amazon Connect. As mensagens interativas são mensagens avançadas que apresentam opções de exibição rápidas e pré-configuradas que o cliente pode escolher. Essas mensagens são fornecidas pelo Amazon Lex e configuradas por meio do Amazon Lex usando um Lambda. Para obter mais informações, consulte Adicionar mensagens interativas do Amazon Lex para clientes no chat.

Criar um bot do Amazon Lex

Nesta etapa, você criará um bot personalizado para demonstrar a integração Pressionar ou Dizer com o Amazon Connect. O bot solicita que os chamadores pressionem ou digam um número que corresponda à opção do menu para que a tarefa seja concluída. Nesse caso, a entrada está verificando o saldo da conta.

Amazon Lex

  1. Abra o console do Amazon Lex.

  2. Escolha Criar bot.

  3. Na página Definir configurações do bot, escolha Criar - Criar um bot em branco e forneça as seguintes informações:

    • Nome do bot — Para este passo a passo, dê um nome ao bot. AccountBalance

    • Permissões do IAM: selecione uma função se você tiver uma criada. Caso contrário, escolha Criar uma função com permissões básicas do Amazon Lex.

    • COPPA: escolha se o bot está sujeito à Child Online Privacy Protection Act (Lei de Proteção à Privacidade Online para Crianças).

    • Tempo limite da sessão: escolha por quanto tempo o bot deve aguardar para obter a entrada de um chamador antes de encerrar a sessão.

  4. Escolha Próximo.

  5. Forneça informações específicas de idioma e voz:

  6. Selecione Concluído. O AccountBalance bot é criado e a página Intent é exibida.

Amazon Lex (Classic)

  1. Abra o console do Amazon Lex.

  2. Se você estiver criando seu primeiro bot, escolha Get Started. Caso contrário, selecione Bots, Create (Bots, Criar).

  3. Na página Create your bot (Criar bot), escolha Custom bot (Bot personalizado) e forneça as seguintes informações:

    • Nome do bot — Para este passo a passo, dê um nome ao bot. AccountBalance

    • Voz de saída: selecione a voz para o bot usar ao falar com os chamadores. A voz padrão do Amazon Connect é a Joanna.

    • Tempo limite da sessão: escolha por quanto tempo o bot deve aguardar para obter a entrada de um chamador antes de encerrar a sessão.

    • COPPA: escolha se o bot está sujeito à Child Online Privacy Protection Act (Lei de Proteção à Privacidade Online para Crianças).

  4. Escolha Criar.

Configurar o bot do Amazon Lex

Nesta etapa, você vai determinar como o bot responde aos clientes fornecendo intenções, amostras de enunciados, slots de entrada e tratamento de erros.

Para este exemplo, você vai configurar o bot com duas intenções: uma para pesquisar as informações da conta e outra para falar com um agente.

Crie uma AccountLookup intenção

Amazon Lex

  1. Depois de criar o bot, você está na página Intenções do console do Amazon Lex. Se você não estiver lá, você pode chegar lá escolhendo Bots, Versões de bots AccountBalance, Versão de rascunho, Intents. Escolha Adicionar intenção, Adicionar intenção vazia.

  2. Na caixa Nome da intenção, insira AccountLookup.

  3. Role a página para baixo até Amostra de declarações. Nesta etapa, você insere frases que permitem ao cliente extrair a intenção. AccountLookup Insira as seguintes declarações e escolha Adicionar declaração após cada uma.

    • Verifique o saldo da minha conta

    • Um: Isso atribui a expressão “um” ou o pressionamento de tecla “1" à intenção. AccountLookup

    A imagem a seguir mostra onde adicionar a declaração na seção Amostra de declarações.

    A seção Amostra de declarações da página Intenções.

  4. Role até a seção Slots e escolha Adicionar slot. Preencha a caixa da seguinte forma:

    1. Obrigatório para essa intenção = selecionado.

    2. Nome = AccountNumber.

    3. Tipo de slot = AMAZON.Number.

    4. Prompt = o texto a ser falado quando a chamada é respondida. Por exemplo, peça para os chamadores inserirem o número da conta usando o teclado numérico: Usando o teclado numérico, insira o número da conta. Escolha Adicionar.

    A imagem a seguir mostra uma seção Adicionar slot preenchida.

    A seção Adicionar slot na página Intenções.

  5. Role até a seção Respostas de fechamento. Adicione uma mensagem para o bot dizer aos clientes. Por exemplo: O saldo da sua conta é de 1.234,56 USD. (Para este passo a passo, não vamos realmente obter os dados, que é o que você faria na realidade.)

    A imagem a seguir mostra uma seção Respostas de fechamento preenchida.

    A seção Respostas de fechamento da página Intenções.

  6. Selecione Salvar intenção.

Amazon Lex (Classic)

  1. No console do Amazon Lex, selecione o ícone + ao lado de Intenções e escolha Criar nova intenção.

  2. Nomeie a intenção. AccountLookup

  3. Adicione uma amostra de enunciado, como Check my account balance (Verificar o saldo da minha conta) e selecione o ícone +.

  4. Adicione outro enunciado, como One (Um) e selecione o ícone +. Isso atribui a expressão de “um” ou o pressionamento de tecla “1" à intenção. AccountLookup

    dica

    Você deve adicionar uma expressão de “um” no bot, e não o número “1". Isso ocorre porque o Amazon Lex não oferece suporte à entrada numérica diretamente. Para contornar isso, mais tarde nesta demonstração, você usará a entrada numérica para interagir com um bot do Lex invocado de um fluxo.

  5. Em Slots, adicione um slot chamado AccountNumber.

    A imagem a seguir mostra a localização da seção Slots na página.

    A seção Slot na página Intenções.

  6. Em Slot type (Tipo de slot), use o menu suspenso para selecionar AMAZON.NUMBER.

  7. Em Prompt (Solicitar), adicione o texto a ser falado quando a chamada é respondida. Por exemplo, peça para os chamadores inserirem o número da conta usando o teclado numérico: Usando o teclado numérico, insira o número da conta.

  8. Escolha o ícone +.

  9. Certifique-se de que a caixa de seleção Required (Obrigatório) esteja marcada.

  10. Na seção Response (Resposta), adicione uma mensagem para o bot dizer aos clientes. Por exemplo: O saldo da sua conta é de 1.234,56 USD.

  11. Selecione Save Intent (Salvar intenção).

Crie uma SpeakToAgent intenção

Amazon Lex

  1. Navegue até a página Intenções: escolha Voltar à lista de intenções.

  2. Escolha Adicionar intenção, Adicionar intenção vazia.

  3. Na caixa Nome da intenção SpeakToAgent, insira e escolha Adicionar.

  4. Role para baixo até a seção Amostra de declarações. Insira os seguintes enunciados, que permitem ao cliente extrair a intenção: SpeakToAgent

    • Falar com um atendente

    • Dois

  5. Role para baixo até a seção Respostas de fechamento. Adicione uma mensagem para o bot dizer aos clientes. Por exemplo: OK. Um atendente atenderá você em breve.

  6. Selecione Salvar intenção.

Amazon Lex (Classic)

  1. No console do Amazon Lex, selecione o ícone + ao lado de Intenções e escolha Criar nova intenção.

  2. Nomeie a intenção. SpeakToAgent

  3. Selecione SpeakToAgent.

  4. Adicione uma amostra de enunciado, como Speak to an agent (Falar com um agente) e selecione +.

  5. Adicione outro enunciado, como Two (Dois), e selecione +.

  6. Adicione uma mensagem que permita aos chamadores saberem que a chamada está sendo conectada a um atendente. Por exemplo: "OK. Um atendente atenderá você em breve".

  7. Selecione Save Intent (Salvar intenção).

Criar e testar o bot do Amazon Lex

Após criar o bot, verifique se ele está funcionando conforme pretendido.

Amazon Lex

  1. Na parte inferior da página, escolha Criar. Isso pode levar um ou dois minutos. A imagem a seguir mostra onde o botão Criar está localizado.

    A localização do botão Criar na página.

  2. Quando a criação for concluída, selecione Testar.

  3. Vamos testar a AccountLookupintenção: no painel Versão do rascunho de teste, na caixa Digite uma mensagem, digite 1 e pressione Enter. Em seguida, digite um número de conta fictício e pressione Enter. A imagem a seguir mostra onde você insere a intenção.

    A caixa em que você digita a intenção a ser testada.

    1. Desmarque a caixa de teste.

    2. Digite as intenções que deseja testar.

  4. Para confirmar se a SpeakToAgentintenção está funcionando, desmarque a caixa de teste, digite 2 e pressione Enter. A imagem a seguir mostra a aparência do teste depois que você a desmarca e insere 2.

    A caixa de teste.

  5. Feche o painel Testar versão de rascunho.

Amazon Lex (Classic)

  1. Escolha Criar. Isso pode levar um ou dois minutos.

  2. Quando a criação estiver concluída, escolha Testar chatbot, conforme mostrado na imagem a seguir.

    O botão Testar chatbot, no lado direito da página.

  3. Vamos testar a AccountLookupintenção: no painel Testar o Chatbot, na caixa Converse com seu bot, digite 1. Em seguida, digite um número de conta fictício. Na imagem a seguir, a seta aponta para a caixa onde você digita 1.

    O bot de teste, a caixa para digitar sua mensagem.

  4. Selecione Clear chat history (Limpar histórico do chat).

  5. Para confirmar se a SpeakToAgentintenção está funcionando, digite 2.

Criar uma versão de bot (opcional)

Nesta etapa, você cria uma nova versão do bot para usar em um alias. É assim que você cria um alias que pode ser usado em um ambiente de produção. Os aliases de teste estão sujeitos a limites menores de controle de utilização. Embora esse seja um passo a passo de teste, criar uma versão é uma prática recomendada.

Amazon Lex

  1. Se estiver na página Intenções, escolha Voltar à lista de intenções.

  2. No menu à esquerda, escolha Versões do bot.

  3. Escolha Criar versão.

  4. Revise os detalhes do AccountBalancebot e escolha Criar.

    Isso cria uma versão do seu bot (Versão 1). Você pode alternar versões em um alias que não seja de teste sem precisar rastrear qual versão está sendo publicada.

    A página Versões com a Versão 1 listada.

Criar um alias para o bot

Amazon Lex

  1. No menu esquerdo, selecione Aliases.

  2. Na página Aliases, escolha Criar alias.

  3. Na caixa Nome do alias, insira um nome, como Teste. Posteriormente neste passo a passo, você usará esse alias para especificar essa versão do bot em seu fluxo.

    Importante

    Em um ambiente de produção, sempre use um alias diferente TestBotAliaspara o Amazon Lex e $LATEST para o Amazon Lex classic. TestBotAliase $LATEST oferecem suporte a um número limitado de chamadas simultâneas para um bot do Amazon Lex. Para obter mais informações, consulte Cotas de runtime.

  4. Em Versão associada, escolha a versão que você acabou de criar, como a Versão 1.

  5. Escolha Criar.

Amazon Lex (Classic)

  1. Selecione Publish.

  2. Forneça um alias para o bot. Use o alias para especificar essa versão do bot no fluxo, por exemplo, Teste.

    Importante

    Em um ambiente de produção, sempre use um alias diferente TestBotAliaspara o Amazon Lex e $LATEST para o Amazon Lex classic. TestBotAliase $LATEST oferecem suporte a um número limitado de chamadas simultâneas para um bot do Amazon Lex. Para obter mais informações, consulte Cotas de serviço de runtime.

  3. Selecione Publish.

Adicionar o bot do Amazon Lex à instância do Amazon Connect

Amazon Lex

  1. Abra o console do Amazon Connect.

  2. Selecione a instância do Amazon Connect que você deseja integrar ao bot do Amazon Lex.

    Página Instâncias da central de atendimento virtual do Amazon Connect e o alias da instância.

  3. No menu de navegação, escolha Fluxos.

  4. Em Amazon Lex, use o menu suspenso para selecionar a região do seu bot Amazon Lex e, em seguida, selecione seu bot Amazon Lex,. AccountBalance

  5. Selecione o nome do alias do bot Amazon Lex no menu suspenso (Teste) e escolha + Adicionar bot do Lex. A imagem a seguir mostra a seção do Amazon Lex depois de configurada.

    A seção Amazon Lex da página Fluxos.
nota

O Amazon Connect usa políticas baseadas em recursos do Amazon Lex para fazer chamadas para o bot do Amazon Lex. Quando você associa um bot do Amazon Lex à instância do Amazon Connect, a política baseada em recursos do bot é atualizada para dar permissão ao Amazon Connect para invocar o bot. Para obter mais informações sobre as políticas baseadas em recursos do Amazon Lex, consulte Como o Amazon Lex funciona com o IAM.

Amazon Lex (Classic)

  1. Abra o console do Amazon Connect.

  2. Selecione a instância do Amazon Connect que você deseja integrar ao bot do Amazon Lex.

  3. No menu de navegação, escolha Fluxos de contato.

  4. No Amazon Lex, selecione a região do bot do Amazon Lex Classic no menu suspenso e, em seguida, selecione o bot do Amazon Lex Classic. O nome terá o sufixo “(Classic)”. Em seguida, escolha Adicionar bot do Lex.

Criar um fluxo e adicionar o bot do Amazon Lex

Importante

Se você estiver usando um bot do Amazon Lex V2, o atributo de idioma no Amazon Connect deve corresponder ao modelo de idioma usado para criar o bot do Lex. Isso é diferente do Amazon Lex (Classic). Use um bloco Definir voz para indicar o modelo de idioma do Amazon Connect ou use um bloco Set contact attributes (Definir atributos do contato).

Em seguida, crie um novo fluxo que usa o bot do Amazon Lex. Ao criar o fluxo, você configura a mensagem reproduzida aos chamadores.

  1. Faça login na instância do Amazon Connect com uma conta que tenha permissões para fluxos de contato e bots do Amazon Lex.

  2. No menu de navegação, escolha Roteamento, Fluxos, Criar fluxo e digite um nome para o fluxo.

  3. Em Interagir, arraste um bloco Obter entrada do cliente até o designer e conecte-o ao bloco Ponto de entrada.

  4. Escolha o bloco Obter informações do cliente para abri-lo. Escolha Conversão de texto em fala ou texto de chat, Insira texto.

  5. Digite uma mensagem que informe os chamadores sobre o que eles podem fazer. Por exemplo, use uma mensagem que corresponda às intenções usadas no bot, como "Para verificar o saldo da conta, pressione ou diga 1. Para falar com um atendente, pressione ou diga 2". A imagem a seguir mostra essa mensagem na página Propriedades do bloco Obter informações do cliente.

    A página Propriedades do bloco Obter informações do cliente.

  6. Selecione a guia Amazon Lex, conforme mostrado na imagem a seguir.

    A guia Amazon Lex na página Propriedades do bloco Obter informações do cliente.

  7. No menu suspenso Nome, selecione o AccountBalancebot que você criou anteriormente.

    1. Se você selecionou um bot do Amazon Lex, em Alias, use o menu suspenso para selecionar o alias do bot, Teste.

    2. Os bots do Amazon Lex Classic têm o sufixo “(Classic)” anexado aos nomes. Se você selecionou um bot Classic, insira o alias que deseja usar no campo Alias.

    3. Para bots do Amazon Lex V2, você também tem a opção de definir manualmente o ARN de um alias de bot. Escolha Definir manualmente e digite o ARN do alias do bot que você deseja usar ou defina o ARN usando um atributo dinâmico.

  8. Em Intents (Intenções), selecione Add an intent (Adicionar uma intenção).

  9. Digite AccountLookupe escolha Adicionar outra intenção. A imagem a seguir mostra a seção Intenções configurada com essas informações.

    A seção Intenções da guia Amazon Lex.

  10. Digite SpeakToAgente escolha Salvar.

Concluir o fluxo

Nesta etapa, você conclui a adição de partes ao fluxo que são executadas depois que o chamador interage com o bot:

  1. Se o chamador pressionar 1 para obter o saldo da conta, use um bloco Prompt (Solicitação) para reproduzir uma mensagem e desconectar a chamada.

  2. Se o chamador pressionar 2 para falar com um atendente, use um bloco Definir fila para definir a fila e transferir o chamador para a fila, o que finaliza o fluxo.

Estas são as etapas para criar o fluxo:

  1. Em Interact, arraste um bloco de prompt do Play até o designer e conecte o AccountLookupnó do bloco Obter entrada do cliente a ele. Depois que o cliente receber o saldo da conta do bot do Amazon Lex, a mensagem no bloco Reproduzir mensagem será reproduzida.

  2. Em Terminar/Transferir, arraste um bloco Desconectar/desligar até o designer e conecte o bloco Reproduzir mensagem a ele. Depois que a mensagem de solicitação for reproduzida, a chamada será desconectada.

Para completar a SpeakToAgentintenção:

  1. Adicione um bloco Definir fila de trabalho e conecte-o ao SpeakToAgentnó do bloco Obter entrada do cliente.

  2. Adicione um bloco Transfer to queue (Transferir para a fila).

  3. Conecte o nó Êxito do bloco Definir fila do cliente a Fila de transferência.

  4. Selecione Save (Salvar) e Publish (Publicar).

O fluxo finalizado se parecerá com a imagem a seguir. O fluxo começa com o bloco Obter informações do cliente. Isso bloqueia ramificações para Reproduzir mensagem ou Definir fila do cliente.

O fluxo finalizado no designer de fluxo.
dica

Se sua empresa usar várias localidades em um único bot, adicione um bloco Set contact attributes (Definir atributos do contato) ao início do fluxo. Configure esse bloco para usar o $. LanguageCodeatributo do sistema.

Atribuir o fluxo a um número de telefone

Quando os clientes ligam para a central de atendimento, o fluxo ao qual eles são enviados é aquele atribuído ao número de telefone discado. Para tornar o novo fluxo ativo, atribua-o a um número de telefone para a instância.

  1. Abra o console do Amazon Connect.

  2. Escolha Roteamento, Números de telefone.

  3. Na página Gerenciar números de telefone, selecione o número de telefone a ser atribuído ao fluxo.

  4. Adicione uma descrição.

  5. No menu Fluxo/IVR, selecione o fluxo que você acabou de criar.

  6. Escolha Salvar.

Experimente!

Para testar o bot e o fluxo, chame o número atribuído ao fluxo. Siga os prompts.