Módulo Recursos no Blip 25 de maio de 2023 20:18 Atualizado Índice: Para que serve o módulo de Recursos? Como acessar o módulo de Recursos Criando um conteúdo Conheça a estrutura de roteadores dentro do Blip Aplicações no módulo Recursos Códigos Conteúdos Como criar chaves de configurações? API dos Recursos Para que serve o módulo de Recursos? O módulo de recursos permite que você crie conteúdos para os seus chatbots, que podem ser facilmente utilizados através da variável resource no seu fluxo. Como acessar o módulo de Recursos Para acessar, você precisa acessar o seu chatbot ou roteador, clicar sobre o menu […] > Conteúdos > Recursos: Criando um conteúdo Após acessar o módulo, você poderá adicionar os seus conteúdos através do botão + Adicionar Novo e preencher com o conteúdo desejado: Você precisará informar uma Chave; Essa chave será utilizada no seu fluxo sempre que você quiser usar o conteúdo deste recurso, portanto não crie nomes extensos e com caracteres especiais. Limite-se apenas ao uso de letras. Uma sugestão é utilizar camelCase. Depois, selecione qual o tipo de conteúdo que você está criando. Existe uma lista com vários tipos disponíveis utilizando os componentes do Blip, mas os principais são JSON e Texto. Com estes dois tipos você já conseguirá adicionar qualquer conteúdo. Por último, você precisará adicionar o seu conteúdo de acordo com o tipo selecionado anteriormente. Veja um exemplo de recursos com conteúdo JSON: Uma vez criado um recurso, este pode ser acessado por um ou diversos chatbots dependendo da estrutura do seu chatbot. Acontece que o recursos é uma funcionalidade poderosa quando combinada com uma estrutura de roteador e vários subbots, pois você poderá acessar os conteúdos dos seus recursos em qualquer um dos subbots. Conheça a estrutura de roteadores dentro do Blip Você também pode ter uma estrutura de roteador mas não compartilhar os recursos entre os subbots. Tudo isso dependerá da estrutura do seu chatbot. Por que depende tanto da estrutura do meu chatbot? Para explicar melhor, abaixo será ilustrado alguns cenários possíveis combinando a estrutura aos recursos: 1º Cenário: Note que neste exemplo existe um recurso chamado nome tanto no roteador quanto no subbot. Devido o contexto do roteador está ativado nos subbots, o recurso do roteador que irá prevalecer. 2º Cenário: Neste cenário, a única diferença pro 1º cenário é que o contexto do roteador agora está desativado. Por mais que o roteador possui o recurso chamado nome, será o recurso do subbot que irá prevalecer. Em ambos os dois primeiros cenários, o que vai controlar o conteúdo a ser exibido será: Onde você adicionou o recurso; Se o contexto do roteador está ativado/desativado no subbots. Nessa estrutura você também poderia ter um dos três subbots com o contexto do roteador desativado, enquanto os outros dois estariam com o contexto ativado. 3º Cenário: Neste cenário temos 2 roteadores conectados nos mesmos subbots. Dessa forma você consegue tornar sua solução escalável, podendo ter vários canais conectados em uma única estrutura de subbots. Neste cenário, para que a solução se torne escalável será primordial o contexto do roteador ativado nos subbots. Quem controlará os conteúdos será sempre o roteador e quando você conversar com o WhatsApp conectado no Roteador#1, irá receber o que estiver no conteúdo cadastrado no recurso do Roteador#1; caso converse com o WhatsApp conectado no Roteador#2, será exibido o conteúdo do Roteador#2… e assim vai indo para todos roteadores e canais que você tiver conectado à estrutura. Aplicações no módulo Recursos Como vimos, o módulo Recursos permite que você centralize os conteúdos do seu chatbot, tornando a manutenção mais prática e rápida, além de torná-lo ainda mais escalável. Mas vamos aprender como utilizá-lo na prática? Códigos Você pode adicionar esse código no módulo de recursos e utilizá-lo dentro do scripts, veja só como é fácil: function run() { var date = nowUTC();var data = [formatDay(date.getUTCDate()). formatMonth(date.getUTCMonth()).date.getUTCFullYear()].join("/");var hora = [formatDay(date.getUTCHours()). formatDay(date.getUTCMinutes()).formatDay(date.getUTCSeconds())].join(":");return data + " " + hora;} Recurso chamado gen.dateTime com um script que gera a Data e Hora do Brasil (GMT-3) formatada. Usando o recurso gen.dateTime dentro de um Script no Fluxo. Conteúdos Assim como códigos, seu fluxo pode ter conteúdos que precisam ser atualizados com frequência, e o uso do recursos é super recomendado aqui. E quando eu falo conteúdos, não estou falando somente de texto, pode ser também uma mídia (imagem/vídeo), um documento, um menu, etc… Um exemplo clássico é o nome do assistente virtual que eu apresentei nos cenários acima, que altera de acordo com cada estrutura. Como criar chaves de configurações? Você pode criar chaves de configuração nos seus recursos, e criar jornadas, conteúdos e até mesmo menus de forma dinâmica. Se você precisar ativar ou desativar alguma configuração, é só ir no recurso. Veja um exemplo: Recursos de configuração do fluxo. Script para criação do menu dinâmico baseado nos Recursos de configuração. Ainda sobre configurações, você também pode utilizar o recurso em Condições de Saída: Condição de Saída baseada nos Recursos de configurações. API dos Recursos Por último, mas não menos importante, você pode consultar nossa documentação dos Recursos, clicando aqui. Lá você encontrará mais sobre este módulo e aprenderá como criar, editar e ler um recurso do bot através de API. Para mais informações, acesse a discussão sobre o assunto em nossa comunidade ou os vídeos no nosso canal. 😃 Artigos relacionados Como usar Conteúdo Dinâmico Envio de Mensagens Ativas do WhatsApp no Blip Desk Como configurar o Dialogflow como seu provedor de IA Enviando dados para análise através de Webhooks Dashboard - Métricas de Fluxo Conversacional