Extensão Gerenciador de Recursos 25 de agosto de 2023 13:20 Atualizado Índice Introdução Como funciona? Instalação Manual de Uso Suporte Vídeos demonstrativos Introdução O Gerenciador de Recursos chegou para facilitar e auxiliar os usuários do Blip a criar recursos personalizados dentro da plataforma. A criação desses recursos é feita de forma bem simples e intuitiva, sem a necessidade de ter contato com nenhum JSON. Ainda com a tamanha vantagem e a possibilidade de ter recursos dentro da plataforma Blip para organizar, padronizar e criar conteúdos que podem ser facilmente utilizados no builder, o processo de desenvolver um JSON muitas das vezes pode ser chato, demorado e cansativo a depender do tamanho do mesmo. Mas já pensou se com ações simples e básicas você pudesse criar um recurso para utilizar na construção do seu contato inteligente sem necessidade de mexer com JSON, aproveitando melhor a ferramenta, economizando tempo e energia? É aí que surge o Gerenciador de Recursos, agora você pode contar com ele para ganhar tempo, agilidade e organização, Além disso, ele ainda te permite importar, exportar e gerenciar seus recursos de forma fácil e simples. Como funciona? A extensão Gerenciador de Recursos foi desenvolvida visando facilitar, auxiliar e organizar a construção dos conteúdos de recursos da plataforma Blip, sendo possível criar diversos tipos de conteúdo e sem ser necessário se preocupar com JSON, já que através de alguns cliques, o próprio gerenciador fará isso para você. As seguintes funcionalidades são oferecidas: Cadastro de recursos únicos personalizados: Cadastro de coleção de recursos personalizados; Possibilidade de cadastro de recursos de diferentes tipos, como: texto, seleção, lista de texto, lista de objetos, on/off e arquivos; Importação de recursos e itens através de um arquivo JSON; Listagem de recursos cadastrados; Listagem dos itens de cada um dos recursos; Importação de novos itens a um recurso; Exportação de itens e/ou estrutura dos recursos cadastrados. Instalação Para utilizar a extensão Gerenciador de Recursos, é necessário acessar o contrato ao qual deseja instalá-la, entrar na Blip Store, acessar a aba de extensões, e buscar por Gerenciador de Recursos. Assim que encontrar, será necessário ativá-la e fazer a sua instalação. Após ativada e instalada, a extensão já estará pronta para uso. Manual de uso Usuários com permissão de administrador conseguem fazer todas as funções da extensão, sendo elas o cadastro de recursos personalizados de diversos tipos, importação e exportação de recursos, itens e estruturas. Assim que a extensão Gerenciador de Recursos for instalada e ativada, tendo o usuário permissões de administrador, quando acessá-la, já conseguirá utilizar a extensão e irá se deparar com a seguinte tela: Logo na tela inicial da extensão, todos os recursos cadastrados serão exibidos em uma lista, através dessa tela você já conseguirá realizar várias ações, como: cadastrar um recurso, copiar suas chaves primárias, editá-los, deletá-los ou acessar os dados de cada um, além de conseguir importar novos recursos ou até mesmo usar um deles como referência para o cadastro de um novo, através da exportação. É importante que tome cuidado na edição dos dados e, principalmente, na exclusão dos itens. As ações são permanentes. Mas não se preocupe, neste tutorial, vamos passar por todas elas. Inclusive, assista este vídeo de apresentação da extensão para que você possa entender um pouco mais sobre ela antes de seguir com o manual de uso: Extensão Gerenciador de Recursos - Blip - Apresentaçao Cadastro de Recursos e Itens Nessa etapa, você irá visualizar como cadastrar um novo recurso, personalizado sob medida à sua necessidade. Após a criação, ele será exibido na lista de recursos e você poderá acessá-lo para gerenciar seus itens, havendo também a possibilidade de cadastro de novos itens. Cadastrando recursos Passo 1) Na tela principal da extensão Gerenciador de Recursos, você deverá clicar em “Cadastrar Recurso”, como a seguir: Feito isso, você conseguirá visualizar um modal onde poderá cadastrar seu recurso, como no exemplo abaixo: Agora que o modal apareceu para você, é importante preenchê-lo de acordo com o objetivo desejado. Passo 2) Informe o nome do seu recurso no campo “Nome”. Este será utilizado apenas para que você possa visualizá-lo de forma organizada. Passo 3) Coloque no campo “Chave” o nome da chave que você deseja utilizar no seu recurso, o input que você colocar nesse campo será utilizado para recuperar o valor do conteúdo pelo servidor. Passo 4) Após preencher os dois campos anteriores, será necessário optar pelo tipo do recurso a ser criado, que poderá variar entre uma coleção (coleção de recursos) ou único (um recurso), como na imagem: A maneira de cadastrar os dois tipos é bem semelhante, mas para que não haja dúvidas, você poderá entender um pouco mais sobre esses dois tipos nos vídeos a seguir: Recurso do Tipo Coleção: Extensão Gerenciador de Recursos - Blip - Recurso do Tipo Coleção Recurso do Tipo Único: Extensão Gerenciador de Recursos - Blip - Recursos de Tipo Único Passo 5) Feito isso, agora você poderá colocar os campos desejados no seu recurso, como “Título”, “Chave” e “Tipo”, onde o campo “Título’ será apenas para nome, o campo “Chave” será usado para recuperar o valor do conteúdo pelo servidor, e o campo “Tipo” você poderá escolher o tipo de campo desejado, sendo eles: texto, seleção, lista de texto, lista de objetos, on/off e arquivo. Como segue: Como funciona cada um dos tipos de campos? Todos os tipos de campos se diferenciam em algumas coisas, mas possuem uma característica em comum, todos eles poderão ser utilizados. Campo do Tipo Texto Ao optar por cadastrar um recurso com campo do tipo texto, você poderá colocar o texto desejado no recurso onde mais tarde você poderá utilizar esse texto no contato inteligente apenas chamando a chave do recurso cadastrado através da devida variável responsável pelo controle de recursos da Blip. Este tipo insere um texto no JSON. Campo do Tipo Seleção Escolhendo o cadastro de um recurso com campo do tipo seleção, você poderá colocar as opções desejadas no recurso, onde no momento em que você for cadastrar o item do recurso, você poderá selecionar uma das opções fornecidas na criação. Este tipo insere um texto no JSON. Campo do Tipo Lista de texto Quando for cadastrar um recurso com campo do tipo lista de texto, após cadastrar, basta clicar em “Acessar dados”, como orientado para todos os recursos que precisam de seleção e acréscimos posteriormente. Feito isso, basta clicar no botão de edição. Após isso feito irá ser aberto um modal, onde você poderá acrescentar os elementos da sua lista. É válido lembrar que este tipo de recurso insere um array de textos no JSON. Caso sinta necessidade de acrescentar mais um elemento na lista, basta clicar em adicionar: Quando você achar que está pronto, basta clicar no botão “Pronto”, então sua lista de texto será armazenada. Feito isso, logo você poderá visualizar sua lista: Campo do Tipo Lista de objetos Caso você queira cadastrar um recurso com um campo do tipo lista de objetos, você irá inserir um array de objetos no JSON. Assim que você colocar o tipo, o modal vai se estender apresentando também os campos do objeto para você preencher, como na imagem: Para preencher essas informações, é só seguir o que já foi apresentado anteriormente e ter entendimento sobre os tipos de campos. Caso queira acrescentar mais um objeto, basta clicar em “Novo campo” dentro do quadrado a ele referenciado, como segue: Campo do Tipo On/Off O campo On/Off se refere a um campo do tipo booleano, podendo ter como valores true ou false, ativo ou inativo. Optando pela sua utilização, você irá inserir um valor booleano no JSON e poderá usá-lo de várias maneiras, como por exemplo definindo se você deseja fazer uma pesquisa de satisfação ao final do atendimento ou não. Após colocar as devidas informações e finalizar o cadastro, você deverá clicar em “Acessar dados” no recurso desejado e então conseguirá habilitar ou desativar o campo, ficando como resultado true (habilitado) e false (desabilitado), como no exemplo abaixo: Campo do Tipo Arquivo Não é novidade que se tem um certo trabalho ao subir um arquivo no drive para depois editá-lo e então poder usar no Blip. Porém, agora seus problemas acabaram! Ao optar por cadastrar um recurso com campo do tipo arquivo, você poderá colocar o arquivo desejado e assim que for cadastrado você conseguirá utilizar o link diretamente da própria Blip. Após cadastrar o campo do tipo arquivo, basta clicar em “Acessar dados” do seu recurso e clicar no ícone de lápis para editá-lo. Logo após, irá aparecer um modal, onde você deverá clicar no botão a seguir para colocar seu arquivo: Assim que subir seu arquivo, você já terá um link dele: Feito isso, basta clicar em “Pronto”, e o arquivo será cadastrado, e o link já poderá ser utilizado. Prontinho, agora que você já sabe quais são os tipos de recursos, basta preenchê-lo corretamente para seguir para o próximo passo. Passo 6) Agora, já com os dados do recurso preenchidos, basta revisar as informações, e caso você esteja tudo ok, basta clicar em “Pronto” e seu recurso será cadastrado. Logo, seu recurso já estará disponível na lista de visualização. Cadastrando itens Passo 1 ) Para cadastrar itens no seu recurso, será necessário clicar em “Acessar dados” no recurso desejado, como na imagem: Passo 2 ) Feito isso, basta selecionar o botão “Cadastrar Item”: Após clicar em “Cadastrar Item”, você irá se deparar com um modal de cadastro, seguindo os campos do tipo de recurso que você criou anteriormente. Passo 3 ) Preencha os campos do modal de acordo com o item desejado e clique em “Pronto”, como na imagem abaixo: Feito isso, você já conseguirá visualizar o item cadastrado no seu devido recurso: Importação e Exportação de Recursos e Itens Seguindo esse caminho, você conseguirá importar recursos e itens através de um arquivo JSON, que pode ter sido construído por você ou até mesmo exportado da nossa extensão. Para lhe auxiliar, veja o tutorial a seguir: Extensão Gerenciador de Recursos - Blip - Importação e Exportação Mesmo após ver o vídeo, se ainda tiver alguma dúvida, basta seguir os seguintes passos: Importando recursos Passo 1 ) Na tela principal, clique no botão “Importar”, como na imagem a seguir: Passo 2 ) Assim que clicar em “Importar”, irá aparecer um modal de importação, como na imagem: Sendo assim, você poderá colocar o seu JSON de duas formas como apresentado, arrastando-o para o modal, ou clicando no link sugerido e selecionando o JSON desejado. Passo 3 ) Assim que colocar o JSON desejado, você terá duas opções, “Cancelar” e “Pronto”, caso queira parar o procedimento, basta clicar em “Cancelar”, como na imagem: Nesse caso, caso não queira cancelar e queira prosseguir com a importação, basta clicar em “Pronto”, como segue: Logo, se seu JSON estiver no formato correto, será importado com sucesso e você já poderá visualizá-lo: Importando itens Você poderá utilizar arquivos de importação para importar novos itens ao recurso. Logo, eles serão tratados e imediatamente adicionados à sua lista de itens. Passo 1 ) Para importar itens para o seu recurso, será necessário clicar em “Acessar dados” no recurso desejado, como na imagem: Passo 2 ) Feito isso, basta selecionar o botão “Importar Itens”: Após clicar em “Importar Itens”, você irá se deparar com um modal de importação, onde basta você arrastar ou clicar no link exibido para colocar seu JSON. Passo 3 ) Coloque seu JSON no modal, como a seguir: Caso tenha errado o arquivo, é só clicar na lixeira ao lado que ele será retirado. No entanto, estando seu JSON no formato correto, é só clicar em “Pronto” e seus itens serão acrescentados ao seu recurso. Veja no exemplo a seguir: Exportar recursos Nessa etapa, você entenderá como exportar os dados de um recurso para que possa usar em outro local ou até mesmo importá-lo em outro recurso a qualquer momento. Você pode exportar apenas os itens, apenas a estrutura do recurso, ou ambos. Ao exportar, um arquivo JSON será criado e um download se iniciará automaticamente. Passo 1 ) Para importar itens para o seu recurso, será necessário clicar em “Acessar dados” no recurso desejado, como na imagem: Passo 2 ) Feito isso, basta selecionar o botão “Exportar”: Passo 3 ) Após clicar em exportar, será necessário escolher o que deseja exportar, opte pela opção desejada, podendo variar entre: “Itens e Estrutura”, “Apenas a estrutura” e “Apenas os itens”, como no modal abaixo: Logo após, você já conseguirá visualizar o arquivo nos seus downloads. Extras Além do que você já conseguiu visualizar no tutorial, seguem abaixo alguns exemplos básicos de botões também utilizados. Para excluir um recurso: Para copiar as chaves de um recurso: Para editar um recurso: Para visitar a documentação: Suporte Em caso de dúvidas ou se encontrar algum problema com a extensão, entre em contato conosco pelo e-mail blippartner@sharkdev.com.br ou no número +55(35) 98802-9321 Vídeos demonstrativos Você conseguirá visualizar demonstrações nos vídeos abaixo: Extensão Gerenciador de Recursos - Blip - Apresentação Extensão Gerenciador de Recursos - Blip - Recursos de Tipo Unico Extensão Gerenciador de Recursos - Blip - Recurso do Tipo Coleção Extensão Gerenciador de Recursos - Blip - Importacao e Exportacao Para mais informações, acesse a discussão sobre o assunto em nossa comunidade ou os vídeos no nosso canal. 😃 Artigos relacionados Módulo Recursos no Blip Enviando dados para análise através de Webhooks Configuração do arquivo de audiência - Envio de notificações em massa Criando mensagens interativas no WhatsApp Como usar Conteúdo Dinâmico