Builder

Nesta seção da documentação, você saberá como acessar seu projeto criacional, conhecer as ferramentas do simulador do assistente virtual e como são feitas as configurações.

Acessando o Builder

O primeiro passo é acessar. Para isso, há duas maneiras:

1. Pela página inicial do assistente clicando no primeiro ícone, em formato de fluxograma:

2. Ou clicando no segundo ícone, de edição do assistente, e em seguida no botão acessar builder localizado do lado esquerdo da tela:

Configurando o builder de um assistente novo

Para criar uma ação, ou nó, basta dar um duplo clique em qualquer lugar da tela, como mostra o gif abaixo:

Em seguida, aparecerá o painel de configuração do nó, à direita, por onde você poderá inserir suas informações necessárias.

Navegando pela barra principal

Na barra principal do builder, você encontrará:

• Versões: todas as versões do builder e opção para adicionar uma nova;

• Variáveis de ambiente: todas as variáveis e opção de adicionar uma nova;

• Templates: todos os templates já criados;

• Exportar builder: ao finalizar o seu assistente, você poderá exportar o arquivo em JSON;

• Configurações: configure o builder como desejar através dos comandos que aparecem;

• Fluxo de inatividade: configure o tempo que o bot aguardará por uma interação do usuário durante a conversa, antes de seguir para o fluxo de abandono. Clique aqui e consulte a documentação.

Simulador

O simulador serve para para testar seu assistente, permitindo acompanhar cada etapa do processo dos nós. Ao clicar nele, o teste será iniciado, conforme demonstrado abaixo:

Na simulação, você pode testar os canais Widget e Whatsapp.

Caso você queira iniciar o teste a partir de um lugar específico do fluxo, clique no nó que deseja iniciar o teste. Acima dele aparecerá uma lista de ícones, o último é "testar a partir deste nó"

Após selecionar essa opção, o teste iniciará, conforme mostra o gif:

Ferramentas do simulador

Breakpoint

O Breakpoint, localizado ao lado do ícone do WhatsApp, serve para pausar a execução e simular o seu fluxo nó a nó, permitindo acompanhar o andamento de cada um por vez.

Para utilizar o recurso, basta ativar a opção breakpoint e seguir o fluxo.

Fluxo de nós

Durante o teste de interação, é possível visualizar o fluxo de nós executados a partir de cada mensagem processada e editá-los um a um. Para isso, siga as instruções:

1. Clique no símbolo > localizado no lado direito do simulador;

2. Uma tela com os nós se expandirá à direita;

3. Ao clicar em cima de um nó específico, as configurações de edição serão exibidas e você pode editar as informações que desejar;

Veja um exemplo abaixo:

Ao lado do fluxo de nós, é possível ver outros recursos disponíveis:

Esses recursos são:

• Contexto: Visualizar variáveis do contexto do atendimento

• Atendimento: Visualizar informações sobre o atendimento

• Eventos: Visualizar informações dos eventos disparados durante a simulação

• Console: Observar os erros de expressões que acontecem ao decorrer de um fluxo. Para acionar e corrigir, basta clicar que será direcionado para o nó do ocorrido.

Alguns exemplos de erros possíveis de acontecer:

• Manipulação de variável não definida;

• Comparações do tipo " $varnaodefinida == 'string' ", pois são retornadas como falso, e não como erro;

• Uso de funções inexistentes;

• Uso de funções em variáveis não definidas;

Teclas de atalho

Expansão e redução da tela

Ao clicar no botão de expansão, você terá muito mais controle sobre a área do grid, podendo expandir uma altura ou largura de 2 nós nas quatro direções (topo, esquerda, direita e inferior).

Minimap

Para facilitar a visualização do builder e otimizar o tempo de trabalho, você pode também utilizar o minimap.

Copia e cola

É possível copiar ou colar nós com destinos dentro de um mesmo grid ou até em instâncias diferentes. Para isso, é preciso permitir o acesso a área de transferência do seu navegador, após a liberação você pode selecionar a seta no canto superior direito do nó e escolher entre as opções "copiar" ou "duplicar". Para colar, basta clicar no local que deseja com o botão direito do mouse e selecionar a opção "colar". Outra alternativa é utilizar os atalhos do teclado:

• Alt + c = para copiar o nó selecionado

• Alt + v = para colar o nó no centro da tela

Obs: certifique-se de que a permissão do clipboard esteja ativa:

Exportar e importar Builder

Você poderá exportar todo o Builder programado. Basta seguir os seguintes passos:

1. Na barra superior, selecione “exportar builder”.

2. Escolha a versão que deseja exportar e aguarde o download.

Exportar fluxo

Caso deseje exportar o fluxo atual, basta clicar no botão de download na barra de ferramentas localizada no canto superior do builder.

Feito isso, irá começar o download de um arquivo json contendo os nós e configurações do fluxo. Isso é particularmente útil para criar modelos e reaproveitá-los em outros assistentes.

Criar fluxos

Além de exportar, você também pode importar o JSON de um outro fluxo que foi exportado anteriormente. Basta adicionar o arquivo no símbolo + localizado no canto superior esquerdo do builder.

Pastas de fluxos

Uma outra funcionalidade são as pastas de fluxos, que ficam visíveis do lado esquerdo da tela. Elas servem para organizar de forma agrupada o conjunto de fluxos que você criar.