.svg?alt=media&token=d4e6f36f-8994-47d0-b855-83e47927012c)
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.
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ó.
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.
O limite de nós sequenciais sem input do usuário é de 20. Qualquer fluxo com mais de 20 nós sequenciais sem input do usuário será travado.
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.
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:
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.
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.
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 |
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.Para facilitar a visualização do builder e otimizar o tempo de trabalho, você pode também utilizar o minimap.
É 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:
.png?alt=media&token=81a1f1a5-016e-46cf-9900-19a49ad90606)
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.
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.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.
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.
Last modified 3mo ago