Como soluciono falhas de integração do Amazon Lex na minha instância do Amazon Connect?

Breve descrição

Veja os motivos mais comuns pelos quais a integração de bots do Amazon Lex em fluxos de trabalho de contato pode falhar:

• A cota de recursos foi excedida.
• Não é possível associar o bot Amazon Lex V2 usando a AWS Command Line Interface (AWS CLI).
• Você está tentando acessar o AWS Lex no Amazon Connect.
• A intenção do Amazon Lex não é identificada nos fluxos de contato ou a opinião do cliente não é reconhecida.
• A sessão do Amazon Lex expira.
• O fluxo de contato está executando o fluxo de erro.

Resolução

Para solucionar problemas de integração do Amazon Lex com o Amazon Connect, primeiro valide se o bot Amazon Lex funciona de forma independente. Por exemplo, confirme se ele funciona no console Amazon Lex. Isso ajuda você a determinar se o problema vem do bot subjacente do Amazon Lex ou do Amazon Connect.

Em seguida, ative os logs de fluxo e os logs de conversas do Amazon Lex para solucionar outros problemas de integração.

Por fim, solucione os motivos mais comuns pelos quais a integração de bots do Amazon Lex em fluxos de trabalho de contato pode falhar.

A cota de recursos foi excedida

Você recebe a seguinte mensagem de erro: "Resource quota exceeded" (Cota de recursos excedida).

Isso ocorre porque você excedeu o limite em pelo menos um dos seguintes serviços do Amazon Connect:

• A cota padrão de bots do Amazon Lex por instância é 70. Para dar suporte a mais de 70 bots do Amazon Lex, migre para o Amazon Lex V2. Para obter mais informações, consulte o Amazon Lex V1 to V2 migration guide (Guia de migração do Amazon Lex V1 para V2).
• O padrão de aliases de bot do Amazon Lex V2 por instância é 100.
• O tempo limite do chat de integração do bot Amazon Lex é de 6 segundos. Esse é o tempo máximo em que o bot Amazon Lex deve responder à solicitação de bate-papo do cliente. Esse número não pode ser aumentado.

Para obter mais informações, consulte Amazon Connect service quotas (Cotas de serviço do Amazon Connect).

Não é possível associar o bot Amazon Lex V2 usando a AWS CLI

O associate-lex-bot da AWS CLI não funciona com o Amazon Lex V2, mas o bot associado do AWS CLI funciona tanto para o Amazon Lex V1 quanto para o Amazon Lex V2. Portanto, se você estiver usando o Amazon Lex V2, use o bot associado da AWS CLI.

Observação: se receber erros ao executar comandos da AWS Command Line Interface (AWS CLI), verifique se está usando a versão mais recente da AWS CLI.

Você está tentando acessar o AWS Lex no Amazon Connect

O acesso entre contas não é suportado. O Amazon Connect e o bot Amazon Lex devem estar na mesma conta da AWS para que a integração funcione. No entanto, o bot Amazon Lex pode estar em uma região diferente da AWS.

Observação: é uma prática recomendada ter seu bot Amazon Lex na mesma região da instância de conexão. Se você usa um bot Amazon Lex de outra região, isso pode resultar em um desempenho abaixo do ideal.

A intenção do Amazon Lex não é identificada nos fluxos de contato ou a opinião do cliente não é reconhecida

Se você estiver usando o Amazon Lex V2, certifique-se de definir o atributo de idioma correto. É uma prática recomendada usar o bloco set Voice em seu fluxo de contato. Coloque-o na frente do bloco Get User input. Por exemplo, se seu bot Amazon Lex estiver na localidade en,GB, defina o idioma no bloco set Voice como English, British. Em seguida, no bloco set Voice, ative o atributo set language.

Importante: para bots Amazon Lex V2, seu atributo de idioma no Amazon Connect deve corresponder ao modelo de idioma usado para criar seu bot Amazon Lex. Isso é diferente do Amazon Lex V1. Use um bloco set Voice para indicar o modelo de idioma do Amazon Connect ou use um bloco set contact attributes (Definir atributos de contato).

A sessão do Amazon Lex expira

Ao configurar valores de tempo limite para contatos de voz, certifique-se de usar os atributos de sessão apropriados no bloco Get customer input (Obter entrada do usuário) que chama seu bot Amazon Lex. Para obter mais informações sobre como controlar a funcionalidade de tempo limite, consulte Configuration tips (Dicas de configuração).

O fluxo de contato está executando o fluxo de erro

Certifique-se de fornecer um alias para seu bot Amazon Lex que corresponda ao alias fornecido no campo obrigatório Get Customer Input (Obter informações do cliente) do seu fluxo de contato.

Importante: certifique-se de que o bot Amazon Lex esteja associado ao alias correto no Instance Contact Flow (Fluxo de contato da instância). Além disso, certifique-se de que o alias corresponda à versão correta do alias que você pretende usar para seu bot Amazon Lex.

Se você ainda tiver problemas após concluir as etapas anteriores, entre em contato com o AWS Support. Para obter instruções sobre como acessar o AWS Support, consulte Get administrative support for Amazon Connect (Obter suporte administrativo para o Amazon Connect).

É uma prática recomendada fornecer as seguintes informações com seu tíquete:

• O ID/ARN da sua instância da central de atendimento. Para encontrar o ARN da sua instância, consulte Find your Amazon Connect instance ID/ARN (Encontre o ID/ARN da sua instância do Amazon Connect).
• Uma descrição detalhada do problema.
• Qualquer mensagem de erro que você receber.
• Capturas de tela do erro.
• Logs de fluxo de contato, se aplicável.

---