Builder

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.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.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. 
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.Na barra superior, selecione “exportar builder”.
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.