Biblioteca de funções: crie e compartilhe funções globais em seus bots 16 de janeiro de 2025 13:44 Atualizado Índice: O que é a Biblioteca de Funções? Vantagens da Biblioteca de Funções Como criar uma função? Parâmetros configuráveis de uma função Editando uma função Excluindo uma função Avisos de impacto Como utilizar uma função criada? O que é a Biblioteca de Funções? A Biblioteca de Funções está localizada na seção Ações dos blocos do Builder. Ela permite que botmakers criem funções JavaScript globais, que podem ser acessadas por todos os bots de um contrato conectados. Com a Biblioteca de Funções, você centraliza e reaproveita lógicas comuns entre bots, reduzindo o retrabalho e aumentando a consistência. Imagem 01: Localização da Biblioteca de funções no Builder Vantagens da Biblioteca de Funções Centralização e reutilização: Crie funções em um único lugar e use-as em diversos bots. Manutenção simplificada: Atualize uma função centralizada e propague as alterações para todos os bots que a utilizam. Redução de erros: Diminua a duplicidade de código e os riscos de inconsistências. Facilidade de gerenciamento: Interface simples e intuitiva para criar, editar e excluir funções. Como criar uma função? Existem três maneiras de criar uma nova função na Biblioteca de Funções: Dentro de um bloco no Builder: Acesse a aba Ações. Clique no botão Criar função. Pelo Gerenciamento da Biblioteca de Funções: Acesse a Biblioteca de Funções diretamente. Clique no botão Criar função. Em uma ação "Função da Biblioteca": Ao configurar uma ação Função da Biblioteca, clique no botão Criar função. Parâmetros configuráveis de uma função Chave: Nome da função. Pode conter caracteres em caixa alta ou baixa, mas não deve incluir espaços ou caracteres especiais. Descrição (Opcional): Uma breve explicação para auxiliar no entendimento da função. Variáveis de Entrada: Parâmetros que a função JavaScript receberá. Conteúdo da Função: O código JavaScript que será associado à função. Dica: Utilize o botão Expandir conteúdo para abrir um editor de código maior e mais prático. Imagem 02: Parâmetros configuráveis de uma função Editando uma função Vá até a listagem das funções. Clique no ícone de três pontos ao lado da função desejada. Escolha a opção Editar. Faça os ajustes necessários nos parâmetros da função. Clique no botão Salvar alterações para aplicar as mudanças. Excluindo uma função Vá até a listagem das funções. Clique no ícone de três pontos ao lado da função desejada. Escolha a opção Excluir. Avisos de impacto Ao editar ou excluir uma função, o sistema exibirá um aviso para evitar impactos não intencionais: Exclusão: Se a função for utilizada por outros bots: O sistema listará os bots afetados. Fornecerá links para acessar esses bots. A exclusão será bloqueada até a remoção manual da função nesses bots. Se a função não estiver em uso: O sistema permitirá a exclusão sem restrições. Edição: Se a função for utilizada por outros bots: O sistema listará os bots afetados e permitirá a edição. Se a função não estiver em uso: A edição será liberada sem restrições. Imagem 03: Aviso de impacto ao editar função Como utilizar uma função criada? Existem dois caminhos principais para utilizar uma função criada na Biblioteca de Funções: Usando em uma ação “Executar Script 2.0”: Crie uma ação de entrada/saída do tipo Executar Script 2.0. Para invocar a função, use o formato:{{blipfunction.chave}} blipfunction: Prefixo padrão da Biblioteca de Funções (não pode ser alterado). chave: Nome da função criada. Complete a configuração da ação conforme necessidade. Imagem 04: Chamando uma função da Biblioteca na ação ‘Executar Script 2’ Usando em uma ação “Função da biblioteca”: Crie uma ação de entrada/saída do tipo Função da Biblioteca. Na lista de funções disponíveis, selecione a função desejada. Configure os demais parâmetros conforme necessidade. Imagem 05: Selecionando uma função na ação ‘Função da biblioteca’ Para mais informações, acesse a discussão sobre o assunto em nossa comunidade ou os vídeos no nosso canal. 😃 Artigos relacionados Extensão TabMonitor Variáveis do Builder Como enviar notificações WhatsApp via API do Blip Envio de Mensagens Ativas do WhatsApp no Blip Desk Ação: Executar script