# Ação {% hint style="danger" %} **A partir de 1º de outubro de 2024, todos os clientes da Chatlayer serão migrados para o novo widget da web, Web V2.** Para saber mais sobre as diferenças entre V1 e V2, confira [esta página.](https://docs.chatlayer.ai/chatlayer-documentation-pt-br/channels/all-channels/web/web-v2/from-web-v1-to-v2) Para um mergulho técnico mais profundo, confira [esta página](https://docs.chatlayer.ai/chatlayer-documentation-pt-br/channels/all-channels/web/web-v2/web-v2-methods-and-options). {% endhint %}

Você pode usar o construtor JSON em combinação com o [Canal Web](https://docs.chatlayer.ai/chatlayer-documentation-pt-br/channels/all-channels/webhook-api) para receber [eventos da janela](https://developer.mozilla.org/en-US/docs/Web/API/Window#events) na sua página. Esses eventos conterão os dados conforme configurado na sua ação do construtor JSON. Para fazer isso, você precisará marcar a opção **Enviar configuração para a janela pai** Isso permitirá enviar dados para o local onde o widget está, de forma estruturada. Aqui está um exemplo: 1. Configure sua ação do construtor JSON para enviar uma **idioma** chave, com uma variável recuperada da sessão. 2. Ative a chave **Enviar configuração para a janela pai** ligado.

Adicione um **Ação** bloco por [arrastar e soltar](https://docs.chatlayer.ai/buildabot/bot-navigation/bot-builder/flows/canvas-functionalities#drag-and-drop) no seu fluxo.

**Ação** blocos permitem integrar serviços de terceiros, implementar lógica de codificação personalizada ou realizar operações especializadas dentro do seu bot

## Etapas de codificação ### Código O editor de código permite que desenvolvedores construam rapidamente lógica personalizada sobre o bot escrevendo seus próprios blocos de código Javascript. Normalmente, o editor de código é usado para fazer solicitações a sistemas externos ou para realizar operações com variáveis. Você pode encontrar mais informações sobre o editor de código aqui: {% content-ref url="../../../integrateandcode/code-action" %} [code-action](https://docs.chatlayer.ai/chatlayer-documentation-pt-br/integrateandcode/code-action) {% endcontent-ref %} Também há dois tutoriais nos quais mostramos como o editor de código pode ser usado: {% content-ref url="../../../integrateandcode/code-action/retrieving-data-from-airtable-get" %} [retrieving-data-from-airtable-get](https://docs.chatlayer.ai/chatlayer-documentation-pt-br/integrateandcode/code-action/retrieving-data-from-airtable-get) {% endcontent-ref %} {% content-ref url="../../../integrateandcode/code-action/airtable" %} [airtable](https://docs.chatlayer.ai/chatlayer-documentation-pt-br/integrateandcode/code-action/airtable) {% endcontent-ref %} ### API A [etapa de API ](https://docs.chatlayer.ai/chatlayer-documentation-pt-br/integrateandcode/custom-back-end-integrations)é uma integração onde você integra o Chatlayer com seu back-end ou serviços de terceiros para compartilhar dados coletados na conversa com o bot, ou enriquecer o bot com dados capturados.

### Construtor JSON Se o seu bot estiver publicado no [Webhook API](https://docs.chatlayer.ai/chatlayer-documentation-pt-br/channels/all-channels/webhook-api) canal, você pode usar a ação Construtor JSON para enviar mensagens para a conversa que não precisam resultar em uma mensagem real para o usuário. Normalmente, é usado para enviar informações sobre o usuário ou a conversa do bot para o site onde o bot está publicado. ![](https://181262846-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LLTwFwbOqJj4dDhg8Ju%2F-M1dw5eMqNDrpjDngOe6%2F-M1dx9mzFppiXljhS6k-%2Fimage.png?alt=media\&token=3ef5dcd0-6d98-4e2d-9d95-631beacaa858) #### Eventos de janela do site **Você pode usar a ação do construtor JSON** **em combinação com o canal do webwidget** para receber eventos de janela na sua página. Esses eventos conterão os dados conforme configurado na sua ação do construtor JSON. Aqui está um exemplo: \ Configure sua ação do construtor JSON para enviar uma **idioma** chave, com uma variável recuperada da sessão, e com "Enviar configuração para a janela pai" ativado. ![Ação do construtor JSON com um campo de idioma](https://181262846-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LLTwFwbOqJj4dDhg8Ju%2F-MKa3vnvkdS2-AigosWt%2F-MKa57sjNNmEoWB6CO2l%2Fimage.png?alt=media\&token=c4e9711d-7541-4f47-8ff3-4db02a33cd6b) Seu widget acionará um evento para essa configuração à sua janela pai como um MessageEvent. O MessageEvent conterá um campo \`data\` que contém o resultado em string da configuração do construtor JSON. Aqui está um exemplo de como escutar esses eventos: ```javascript // Manipulador de Evento do Construtor JSON da Chatlayer window.addEventListener('message', (event) => { const data = event && event.data && JSON.parse(event.data) || {} const { type, payload } = data if (type !== 'CL_DISPATCH_EVENT') return; console.log('Idioma do Chatlayer recebido: ' + payload.language) }) ``` ## Etapas de pausa ### Pausar bot A **Pausar bot** etapa vai pausar seu bot quando alcançar este bloco.

### Atraso Às vezes você precisa de um pequeno atraso entre mensagens do bot, seja para criar uma pausa natural ou para fazer uma chamada de API sem que o bot fique em silêncio. Essas pausas podem melhorar significativamente a experiência do usuário.

Você pode [por exemplo, usar Atraso antes de Fechar conversa](#example-delay-before-close-conversation) etapa. ## Etapas de variáveis ### Limpar dados da sessão: variáveis e contexto Use uma **Limpar sessão** etapa para limpar [variáveis](https://docs.chatlayer.ai/chatlayer-documentation-pt-br/navegacao/settings/secure-variables-gdpr)

e/ou [contexto](https://docs.chatlayer.ai/chatlayer-documentation-pt-br/nlp/natural-language-processing-nlp/using-context)

que você não precisa mais.

### Definir variáveis A **Definir variável** etapa facilita a criação, formatação e atribuição de valores a [variáveis](https://docs.chatlayer.ai/bot-answers/settings/secure-variables-gdpr). {% hint style="warning" %} Recentemente, introduzimos uma [nova sintaxe de expressões](https://docs.chatlayer.ai/chatlayer-documentation-pt-br/integrateandcode/expression-syntax). Para explorar toda a gama de expressões e funções disponíveis, confira a documentação abrangente fornecida [aqui](https://docs.chatlayer.ai/chatlayer-documentation-pt-br/integrateandcode/expression-syntax). {% endhint %}

Adicione uma operação dentro do valor da sua variável.

Operações permitem realizar cálculos como adição, subtração, multiplicação, divisão ou encontrar o resto de dois números. {% hint style="info" %} Para uma lista abrangente de operações disponíveis, como adição (+), multiplicação (\*), divisão (/), e mais, consulte a documentação detalhada fornecida [aqui](https://docs.chatlayer.ai/chatlayer-documentation-pt-br/integrateandcode/expression-syntax). {% endhint %} ### Ir para diálogo de variável do bot Use a **Ir para diálogo de variável do bot** etapa para navegar para um bloco que está contido dentro de uma variável.

Etapa Ir para diálogo de variável do bot.

## Etapas de e-mail ### Enviar e-mail A **Enviar e-mail** etapa envia um e-mail com uma mensagem.

### Relatório por e-mail A **Relatório por e-mail** etapa envia 2 coisas: * um e-mail com uma mensagem * a conversa do bot no momento em que a mensagem foi enviada Tudo o que você precisa fazer é definir o título do e-mail, destinatários e corpo. Aqui você também pode usar variáveis entre chaves, se precisar.

## Etapas de voicebot ### Iniciar gravação da chamada A partir da **Iniciar gravação da chamada** etapa, a [conversa com seu voicebot está sendo gravada](https://docs.chatlayer.ai/chatlayer-documentation-pt-br/voz/phone-and-voice).

### Parar gravação da chamada A partir da **Parar gravação da chamada** etapa, a conversa com seu [voicebot](https://docs.chatlayer.ai/chatlayer-documentation-pt-br/voz) parará de ser gravada.

### Encaminhar chamada Você pode [encaminhe a chamada do seu voicebot para um número de telefone](https://docs.chatlayer.ai/voicebots/phone-and-voice#forwarding-and-closing-a-call) usando a **Encaminhar chamada** etapa.

{% hint style="info" %} O número de telefone deve conter um código do país, mas sem zeros à esquerda, apenas o sinal '+'.\ Por exemplo: 0800 55 800 torna-se +32 800 55 80 {% endhint %} Após configurar o número para o qual você deseja encaminhar sua chamada, o bot desligará automaticamente ao transferir. Para alcançar o bot novamente, desligue a chamada e ligue uma segunda vez. ## Outras etapas ### Rastrear evento Uma **Rastrear evento** etapa pode ser usada para [criar painéis e funis personalizados para melhorar a análise do desempenho do seu bot](https://docs.chatlayer.ai/chatlayer-documentation-pt-br/bot-answers/track-events-for-analytics).

### iFrame Um iFrame é um elemento personalizado que pode ser usado para mostrar uma página da web diferente na conversa do chat. Ele também pode ser usado para se comunicar com a janela pai usando a [postMessage API](https://developer.mozilla.org/en-US/docs/Web/API/Window/postMessage). Dê uma olhada neste exemplo básico: ```markup ``` Se esse bloco de código estiver hospedado e incorporado em nosso plugin de iframe, ele enviará ao usuário uma mensagem de chat quando ele clicar no botão. A postMessage API também pode lidar com `UPDATE_SESSION` e `GO_TO_DIALOGSTATE` eventos. ### Obter hora A [**Obter hora** etapa](#get-time) é sobre orientar seu fluxo com base no momento atual. Você pode reutilizar essas [variáveis de tempo](#get-time-variables) dentro da sua conversa. Quando você fornece um **deslocamento de fuso horário**, o resultado do plugin conterá propriedades de tempo iguais a UTC+`deslocamento`.

Obter variáveis de hora

Se você não fornecer um deslocamento de fuso horário, o momento atual será salvo no **Variável de destino** campo. No nosso exemplo, essa variável será chamada `time`. Nesse caso, seu **Variável de destino** ficará acessível com as seguintes variáveis: * `(target).utc.year` * `(target).utc.month` * `(target).utc.dayOfMonth` * `(target).utc.dayOfWeek` * `(target).utc.hours` * `(target).utc.minutes` * `(target).utc.seconds` * `(target).utc.ISO` Por padrão, o resultado do plugin conterá propriedades relacionadas ao horário UTC. Quando você fornece um `deslocamento de fuso horário`, o resultado também conterá propriedades de tempo iguais a UTC+\. * `(target).offset.year` * `(target).offset.month` * `(target).offset.dayOfMonth` * `(target).offset.dayOfWeek` * `(target).offset.hours` * `(target).offset.minutes` * `(target).offset.seconds` * `(target).offset.ISO` Dentro de uma mensagem, você pode usar essas variáveis, por exemplo, assim: *Hoje é `{time.offset.dayOfMonth}`/`{time.offset.month}`/`{time.offset.year}`*

{% content-ref url="../../tips-and-best-practices/route-your-flow-depending-on-the-time" %} [route-your-flow-depending-on-the-time](https://docs.chatlayer.ai/chatlayer-documentation-pt-br/buildabot/tips-and-best-practices/route-your-flow-depending-on-the-time) {% endcontent-ref %} ### Fechar conversa O bot fechará a conversa ativa quando a **Fechar conversa** etapa for alcançada. Isso significa que as variáveis da sessão são apagadas.

Exemplo: Atraso antes de Fechar conversa

Você pode, por exemplo, usar a **Fechar conversa** etapa junto com uma [**Atraso**](#delay) etapa. Isso é útil em uma situação em que o usuário não responde por alguns minutos e você quer fechar a conversa a partir daí. ![](https://181262846-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LLTwFwbOqJj4dDhg8Ju%2Fuploads%2FIq8QY3yGhUdrrCY0j0YN%2FScreenshot%202024-09-24%20at%2010.40.14.png?alt=media\&token=9b049378-6830-4561-8045-055c0d111272)

{% hint style="success" %} **Fechar conversa** está agora disponível no [Web](https://docs.chatlayer.ai/channels/channels/web-v2) canal, [Voz](https://docs.chatlayer.ai/voicebots/phone-and-voice#set-up-voice-channel) canal, e [Sinch Conversation API](https://docs.chatlayer.ai/channels/sinch-conversation-api-beta) canal. {% endhint %} ### Operação de tabela A **Operação de tabela** etapa é sobre usar suas [Tabelas](https://docs.chatlayer.ai/chatlayer-documentation-pt-br/navegacao/tables).

### Base de conhecimento IA A **Base de conhecimento IA** etapa é sobre usar sua [Base de conhecimento IA](#knowledge-base-ai).

### Enviar para provedor de offload Um usuário que chegar a esta ação será encaminhado para um agente humano de suporte ao cliente. {% hint style="warning" %} Para conseguir ver esta etapa no seu bot, você precisará [configurar um provedor de offload.](https://docs.chatlayer.ai/chatlayer-documentation-pt-br/integrateandcode/human-offloading-live-chat) {% endhint %} Dependendo do seu provedor de offload selecionado, pode ser necessária configuração adicional.