ALTU
Search…
Builder

Configurações

É possível acessar o builder de duas maneiras:
  • Pela página inicial do assistente clicando no primeiro ícone, em formato de fluxograma
  • Na aba de edição do assistente, no botão Acessar Builder
Ao acessar o builder de um assistente novo, o grid estará vazio. Para criar uma ação, ou nó, dê um duplo clique em qualquer lugar da tela e em seguida irá aparecer um quadrado, ao clicar nele o painel de configuração será aberto.

Barra Principal

🤖 Assistente
☁️ Versões
🗨️ Debugger
⚙️ Variáveis de Ambiente
🔎 Pesquisa de nós
📂 Templates
📋 Logs
Assistente: Visualize o assistente a ser editado
Versão de referência: Versão de identificação base de publicação
Versão publicada: Ultima versão publicada
Ultima Atualização: Ultima vez que o assistente foi salvo com alterações
Crie uma nova versão do builder:
Utilize as seguintes informações:
  • Título
    • limite de 20 caracteres.
  • Descrição (opcional)
    • limite de 1000 caracteres.
Gerencie as versões publicadas.
  • Descrição: descrição da versão feita ao salvar.
  • Salvar nova versão: a nova versão fica disponível na lista para ser publicada, restaurada ou apagada. Caso a tela pisque é porque a lista de versões foi atualizada.
  • Salvar em Ambiente de homologação: utilize o assistente no formato de homologação.
  • Definir a versão publicada: A versão publicada é a que se encontra em produção. É possível alternar a versão publicada conforme a necessidade.
  • Apagar uma versão: Qualquer versão que não esteja publicada pode ser apagada. Há um limite de 20 versões por builder, portanto é uma boa prática remover as mais antigas ou que não sejam mais necessárias.
  • Restaurar uma versão para desenvolvimento: Essa ação permite trazer uma versão anterior para desenvolvimento novamente. Ao fazer isso a versão de desenvolvimento atual será sobrescrita. Caso você deseja manter a versão atual de desenvolvimento será necessário criar uma nova versão a partir dela para ser restaurada posteriormente.
Há um limite de 20 versões por builder, portanto é uma boa prática remover as mais antigas ou que não sejam mais necessárias.

Ambiente de Homologação

Para o assistente no formato de homologação, segue como deve utilizar:
  • Selecione o botão de homologação na área de versões:
O mesmo botão pode ser utilizado para voltar ao padrão.
  • Acesse a área de edição do widget e realize o teste usando uma das opções em outra aba:
A versão de homologação será exibida apenas para as opções: visualização de widget e visualização do widget em nova aba (caso não tenha versão em homologação será exibida a versão de desenvolvimento)
Para o testar o assistente, você pode usar o debugger que permite acompanhar cada etapa do processamento dos nós no builder e também estão disponíveis 3 abas na área do debugger

Simulação Whatsapp

Realize testes nos canais Widget e Whatsapp

Breakpoint

navegar no seu fluxo nó a nó com a opção 'breakpoint' no debugger. Basta ativar a opção breakpoint e seguir o fluxo.
Essa opção poderá ser ativada ou desativada durante toda a execução, lembrando que é necessário uma interação do usuário com o bot para que a funcionalidade ative ou desative.

Fluxo de nós

É possível visualizar os fluxos de nós a cada mensagem processada. Ao clicar em algum dos nós processados, o usuário pode acessar e editar as informações do nó.

Contexto

É possível visualizar as varáveis do contexto do atendimento.

Contato

É possível visualizar informações sobre o atendimento

Eventos

É possível visualizar informações do evento.

Console

É possível observar os erros de expressões que acontecem ao decorrer de um fluxo, os erros são exibidos com um item clicável, sendo 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 jumps de um nó.
Alguns exemplos de erros possíveis de acontecer:
  • Manipulação de variável não definida
      • Lembrando que uma comparação do tipo " $varnaodefinida == 'string' " é retornado como falso, e não como erro
  • Uso de funções inexistentes
  • Uso de funções em variáveis não definidas
  • Entre outros
O aviso não sairá apos corrigir o erro, só durante a execução do próximo teste no debugger, quando passar no nó onde o erro acontecia.
Configure para visualizar os valores das variáveis em Homol e em Produção.
Todas as variáveis de sistema criadas, são como parâmetros de uma variável chamada $env_vars. Na prática, para acessar o valor de uma variável específica, basta fazer o seguinte: $env_vars.nome_variavel. No exemplo da imagem ficaria $env_vars.apiEndpoint.
Pesquise os nós que deseja de forma mais prática:
Você pode realizar a pesquisa de três maneiras diferentes:
  • palavra ou expressão
  • palavra-chave
  • palavra-chave + palavra
As palavras-chave são opções pré-definidas, ao realizar a busca usando uma dessas opções a pesquisa será baseada em um nó contendo apenas o tipo de seção, por exemplo se é um input ou output.
Opções de palavra-chave:
  • has:output
  • has:input
  • has:variables
  • has:actions
  • has:events
  • has:entry_point
Exemplos:
  • bom dia: é uma expressão que pode ser encontrada apenas em um nó especifico
  • has:output: pode ser utilizado para encontrar apenas nós contendo outputs
  • has:output loop: pode ser utilizado para encontrar conteúdo especifico para aquela seção, neste casos os outputs que possuem loops

Busca em comentários

Ao acionar a funcionalidade de busca, é possível procurar por palavras ou mensagens adicionada utilizando a tag has:commentcomo comentário para os nós, você também pode visualizar todos os nós comentados.

busca por termo exato

Ao manter acionado o botão para busca de termo exato, a pesquisa é realizada de maneira mais precisa sobre o termo informado.
Ao acionar a busca, serão apresentados apenas os nós correspondentes a frase informada mesmo que estejam no mesmo nó.
Salvetemplates de nó para ser reutilizado futuramente sem precisar criar o nó do zero.
Ao clicar na seta no canto superior direito de um nó, a opção Criar template pode ser usada para criar salvar o mesmo nó como um template.
Um modal com os campos nome e descrição deverão ser preenchidos para, efetivamente, salvar o nó. O nome não poderá conter caracteres especiais ou acentos e deve ter no mínimo 4 caracteres.
Todos os templates salvos poderão ser resgatados ao clicar com o botão direito em qualquer lugar do Builder (paper). Um menu com a opção Criar novo nó a partir de template poderá ser usada para resgatar qualquer template salvo e também deletar caso necessário.
Ao clicar nessa opção, um modal com todos os templates será aberto e o usuário poderá selecionar qual deseja adicionar.
Ao selecionar o template, o nó será criado no mesmo lugar em que o clique foi feito.
Também é possível apagar qualquer template ao selecionar a listagem no ícone em formato de pasta ao lado dos ícones de variáveis de ambiente, pesquisar nós e debugger.
Nessa listagem, a opção de Selecionar é desativada:
Visualize todas as ações realizadas no grid, com sua respectiva data e autor:
  • Publicação de versão
  • Criar, apagar e restaurar uma versão
  • Salvar variáveis de ambiente
  • Criar, salvar, apagar e renomear um novo fluxo (aba)

Teclas de atalho

ctrl + shift + s Salva todas as abas do Builder
ctrl + s Salva a aba que está sendo editada
ctrl + d Abre ou recarrega a tela do debugger
ctrl + f Abre a pesquisa de nós
alt e + Zoom: para aproximar
alt e - Zoom: para distanciar
alt e 0 Zoom: para voltar ao padrão
alt + C Copiar nó
alt + V Colar nó copiado anteriormente
delete Deleta um nó

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, direta e inferior). E dar o crop ou "corte" no grid.
O crop reajusta os elementos e a área do grid, possibilitando muito mais controle sobre a posição deles.
Segue exemplo:
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, navegar pelo builder através do minimap.

Copia e cola

É possível copiar ou colar nós com jumps 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:
Essa funcionalidade está disponível apenas para os navegadores Google Chrome e Microsoft Edg

Exportar builder

Para exportar basta seguir os seguintes passos:
  • No builder que deseja extrair as informações, selecione o ícone
    na barra principal e exporte a versão que desejar:
Apos clicar em uma das versões, sera feito um download da versão em questão com o nome export_builder_{assistant_id}_{assistant_version_id}
Exemplo:
Last modified 4mo ago