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

# Invocar hook de código de diálogo
<a name="paths-code-hook"></a>

Em cada etapa da conversa, quando o Amazon Lex V2 envia uma mensagem ao usuário, você pode usar uma função Lambda como a próxima etapa da conversa. Você pode usar a função para implementar a lógica de negócios com base no estado atual da conversa.

A função do Lambda que é executada está associada ao alias do bot que você está usando. Para invocar a função do Lambda em todos os hooks de código de diálogo em sua intenção, você deve selecionar **Usar uma função Lambda para inicializar e validar** a intenção. Mais informações sobre como escolher uma função do Lambda, ver [Criação de uma AWS Lambda função para seu bot Amazon Lex V2](lambda-attach.md).

Há duas etapas para usar uma função do Lambda. Primeiro, você deve ativar o hook do código de diálogo em qualquer ponto da conversa. Segundo, você deve definir a próxima etapa da conversa para usar o hook de código de diálogo.

A imagem a seguir mostra o hook do código de diálogo ativado.

![\[Mostra que o hook do código de resposta condicional está ativo.\]](http://docs.aws.amazon.com/pt_br/lexv2/latest/dg/images/code-hook-active.png)


Em seguida, defina o hook de código como a próxima ação para a etapa da conversa. Você pode fazer isso configurando a próxima etapa da conversa para Invocar o hook de código de diálogo. A imagem a seguir mostra uma ramificação condicional em que invocar o hook do código de diálogo é a próxima etapa do caminho padrão da conversa.

![\[Ramificação condicional mostrando um hook de código como a próxima etapa da conversa.\]](http://docs.aws.amazon.com/pt_br/lexv2/latest/dg/images/code-hook-choose.png)


Quando os hooks de código estão ativos, você pode definir três respostas para retornar ao usuário:
+ **Sucesso**: enviado quando a função do Lambda foi concluída com sucesso.
+ **Falha**: enviado se houve um problema com a execução da função do Lambda ou se a função do Lambda retornou um valor `intent.state` de `Failed`.
+ **Tempo limite**: enviado se a função do Lambda não for concluída no período de tempo limite configurado.

![\[Fluxograma mostrando as opções disponíveis para mensagens após a execução de uma função do Lambda.\]](http://docs.aws.amazon.com/pt_br/lexv2/latest/dg/images/conditional-code-hook.png)


Escolha o **hook de código de diálogo do Lambda** e, em seguida, escolha **Opções avançadas** para ver as três opções de respostas que correspondem à invocação da função do Lambda. É possível definir valores, configurar as próximas etapas e aplicar condições correspondentes a cada resposta para criar o fluxo de conversação. Na ausência de uma condição ou de uma próxima etapa explícita, o Amazon Lex V2 decide a próxima etapa com base no estado atual da conversa. 

Na página de **opções avançadas**, você também pode optar por ativar ou desativar a invocação da função do Lambda. Quando a função é ativada, o hook do código de diálogo é invocado com a invocação do Lambda, seguida pela mensagem de sucesso, falha ou tempo limite com base nos resultados da invocação do Lambda. Quando a função está desativada, o Amazon Lex V2 não executa a função do Lambda e age como se o hook do código de diálogo tivesse sido bem-sucedido.

Você também pode definir um rótulo de invocação que é enviado para a função do Lambda quando ela é invocada por essa mensagem. Isso pode ajudar a identificar a seção da sua função do Lambda a ser executada.

**nota**  
Em 17 de agosto de 2022, o Amazon Lex V2 lançou uma mudança na forma como as conversas são gerenciadas com o usuário. Essa alteração oferece mais controle sobre o caminho que o usuário percorre na conversa. Para obter mais informações, consulte [Alterações nos fluxos de conversas do Amazon Lex V2](understanding-new-flows.md). Os bots criados antes de 17 de agosto de 2022 não são compatíveis com mensagens de hook de código de diálogo, definição de valores, configuração das próximas etapas e adição de condições.