Functions
Realize integrações dos bots com os sistemas dos clientes diminuindo o tempo de programação.
Last updated
Realize integrações dos bots com os sistemas dos clientes diminuindo o tempo de programação.
Last updated
Com a Functions você consegue processar os dados mais pesados do seu bot, como uma lista de endereços, e exibi-lo no seu chatbot sem a necessidade de utilizar uma API externa.
Ao criar uma ação ou nó no Builder, é possível personalizar uma lista dinâmica e tratar o seu retorno, diminuindo o tempo de programação e melhorando a agilidade no fluxo.
Para acessar a Functions, clique em BUILD no menu lateral da esquerda e, em seguida, em Functions.
A partir de agora, conheça toda a estrutura da Functions que possibilitará você realizar as integrações que deseja.
Para criar uma nova function, basta localizar o sinal de + e criar um Novo arquivo. O nome que você escolher não pode conter caracteres especiais nem números.
Feito isso, clique em Criar novo arquivo e a function estará na lista lateral à esquerda.
Veja o gif de exemplo:
Para inserir logs nas functions e consultá-los posteriormente, basta configurar um console.log() na sua function. Por exemplo:
No menu lateral à esquerda, selecione uma function para visualizá-la e, em seguida, a tela de edição será exibida.
Se você clicar em mais de uma Functions na edição, elas ficarão separadas por abas, como mostra a imagem abaixo:
Para salvar a sua edição, basta clicar na opção Salvar alterações. Caso queira desfazê-la, clique na opção Desfazer:
Lembre-se sempre de salvar, pois as alterações não serão salvas automaticamente.
Os parâmetros setados para o teste poderão ser utilizados pela função através da variável "params". Essa opção ficará disponível na aba Código.
Parâmetros de teste: editor onde os parâmetros devem ser setados no formato JSON;
Resultado do teste: campo de leitura contendo o resultado da ação programada utilizando os parâmetros de teste.
A área de teste fica logo ao lado da opção Publicar. Para utilizá-la, clique no botão Exibir Área de Testes e, em seguida, em Testar. Para retirar a visualização, clique em Ocultar Área de Testes.
Caso você visualize, no momento da sua edição, que existe outro usuário também editando, você não poderá fazer nada além de visualizar.
A estrutura do retorno de uma ação é a seguinte:
Atributos de um evento:
Para uso no builder, acessar através da result_variable
da ação (result_variable.code ou result_variable.result), como no exemplo abaixo:
Todas as alterações feitas nas Functions só terão reflexos em versões de produção caso a respectiva function seja publicada.
Dessa forma, temos um ambiente de homologação melhor definido para testar bastante as suas functions.
No ambiente de desenvolvimento, as Functions serão executadas com todas as mudanças feitas antes mesmo de publicar.
Caso deseje publicar a sua Function, clique na opção Publicar.
Ao publicar uma versão no builder, as functions não serão também publicadas. Isso deve ser feito separadamente.
Para aplicar a Function no seu assistente, siga as instruções abaixo dentro da plataforma do Zenvia NLU:
Clique no nó que deseja adicionar a functions ou crie um novo;
Escolha o componente de Ações </>;
Acesse o Helper;
Busque por Functions;
Mantenha o prefixo "custom" e a partir dele haverá um autocomplete para selecionar a function que deseja utilizar.
Na aba de Versões, é possível visualizar todas as versões existentes com suas respectivas datas e responsáveis pela criação.
Na tela principal, você verá todas as versões presentes e diferentes da Function, separadas por linhas.
Perceba que, em cada linha, há dois botões:
Comparar: ao clicar nessa opção, você poderá comparar um código com o outro. A ferramenta exibirá, lado a lado, as versões.
Enviar para desenvolvimento: ao clicar nessa opção, a versão selecionada da Functions será enviada para a tela de edição, ou seja, para aba de código. Assim, é possível que você crie uma nova versão editada da que acabou de restaurar. Essa funcionalidade é como um backup de versões, por onde poderá recuperá-lo e editá-lo.
Para salvar uma nova versão, basta preencher com um nome no campo Digite um título para a versão e, em seguida, clicar em + Salvar nova versão.
Só é possível manter 20 versões. Logo, a partir da vigésima primeira, apaga-se, automaticamente, a mais antiga.
Na aba de Logs, é possível rastrear todos os registros e informações diversas das requisições de uma API.
Nela, você poderá pesquisar por palavras-chaves no conteúdo dos logs e seu respectivo período.
Componentes: neste filtro, você poderá buscar por duas opções que melhor atenda sua necessidade. São elas:
Http_request: opção mais utilizada para chamar API's diretamente pelo builder, essa busca trará os logs que são gerados a partir das ações http_resquest.
Functions: filtre por uma ou todas as Functions criadas. Mas atenção: é preciso configurar um console.log na Function para gerar logs.
Período: você poderá filtrar até 7 dias, podendo personalizar o período desejado através do calendário exibido nesta opção.
Assistente: nesse filtro, você poderá buscar por um ou todos os assistentes.
Atendimento: utilize o ID do atendimento para filtrar.
Conteúdo do log: nesse filtro, busque dentro do conteúdo do log um termo existente para filtrar mais rápido.
Após realizar os filtros conforme desejado, uma lista de logs será exibida com as seguintes informações:
Atendimento: link para o atendimento que ocorreu a execução da function;
Timestamp: data de execução da function/log;
Assistente: link para o assistente que ocorreu a execução da function.
Com isso, sempre que clicar no item escolhido da lista, uma barra lateral à direita será exibida contendo todo o conteúdo do log.
Atributo
descrição
code
Código de execução da ação:
200 - Em caso de sucesso
404 - Caso a ação não seja encontrada (por erro de escrita ou por não estar publicada, por exemplo)
500 - Caso ocorra erros inesperados de execução.
result
Retorno da função criada. retornará exatamente o que foi programado pelo ser criador no altu