[Extensão] Manuseando variáveis de ambiente com Recursos com a extensão Gerenciador de Recursos – Blip | Blip Help

Introdução
Funcionalidades
Instalação e configuração
Manual de uso
Exemplos de uso
Como funciona cada um dos tipos de campos?
Importação e Exportação de Recursos e Itens
Extras
Suporte

O Gerenciador de Recursos chegou para facilitar e auxiliar os usuários do Blip a criar recursos personalizados dentro da plataforma. Crie, gerencie e padronize recursos no Blip sem manipular arquivos JSON manualmente. Otimize o tempo do desenvolvimento integrando dados dinâmicos ao Builder em poucos cliques.

Palavras chave: Gerenciador de Recursos, Recursos, Variáveis de ambiente, JSON, Automação, Importação, Exportação, Gerenciamento de Conteúdo, Extensões Blip.

Introdução

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, técnico, 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 editar o JSON manualmente, 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.

Você conseguirá visualizar um exemplo de uso da extensão nos vídeos abaixo:

Funcionalidades

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 e configuraçã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

Exemplos de uso

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:

Passo 6) "Para puxar as informações cadastradas nos recursos, basta utilizar o formato padrão de chamada de variáveis de recursos da Blip!

Segue exemplo:

Observação: o manuseio da variável depende do formato criado. Objetos, strings, etc possuem diferentes manuseios nos Builders/Studios Blip."

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)99148-3887

Precisa de mais ajuda? Explore nossos conteúdos na Blip Academy ou Blip Community, assista a tutoriais no nosso canal do YouTube ou tire suas dúvidas em nosso canal de atendimento 😃