ALTU
Search…
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. 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:
Caso você crie um novo assistente, o grid estará vazio. Veja na próxima seção como proceder para criar uma ação ou nó.

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;

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.
É necessário uma interação com o bot para que a funcionalidade ative ou desative.

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. 1.
    Clique no símbolo > localizado no lado direito do simulador;
  2. 2.
    Uma tela com os nós se expandirá à direita;
  3. 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.
Serão considerados erros de expressões aqueles que são executados pelo builder, ou seja, erros de programação em geral: códigos colocados dentro de <? ?> ou nos pontos de entradas e destinos de um nó.
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;
O aviso não sairá após corrigir o erro, só durante a execução do próximo teste no simulador, quando passar no nó onde o erro acontecia.

Teclas de atalho

Atalhos
Função
ctrl + shift + s
Salva todas as abas do Builder
ctrl + s
Salva a aba que está sendo editada
ctrl + d
Abrir ou recarregar a tela do simulador
ctrl + f
Abre a pesquisa de nós
ctrl e +
Zoom: para aproximar
ctrl e -
Zoom: para distanciar
ctrl e 0
Zoom: para voltar ao padrão
alt + C
Copiar nó
alt + V
Colar nó copiado anteriormente
delete
Deleta um nó
ctrl + b
Ocultar/exibir menu de fluxos
ctrl + alt + q
Ocultar/exibir fluxo ativo
ctrl + alt + w
Ocultar/exibir simulador
ctrl + alt + e
Ocultar/exibir Zoom
ctrl + alt + r
Ocultar/exibir pesquisa de nós
ctrl + q
Ocultar tudo

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).
Utilize o crop para reajustar os elementos e a área do grid, assim você tem muito mais controle sobre a posição. O crop respeitará sempre a disposição dos elementos, ele nunca irá cortar qualquer elemento do usuário.

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. 1.
    Na barra superior, selecione “exportar builder”.
  2. 2.
    Escolha a versão que deseja exportar e aguarde o download.
Após clicar em uma das versões, será feito um download da versão em questão com o nome export_builder_{assistant_id}_{assistant_version_id}. A extensão do arquivo exportado é JSON.

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.
Ao criar um fluxo a partir de um arquivo exportado, as condições de saída que apontavam para o fluxo original ficarão sem a definição do destino, e será preciso reconfigurar.

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.