[Extensión] Administración de variables de entorno con Recursos mediante la extensión Administrador de Recursos – Blip | Blip Help

Introducción
Funcionalidades
Instalación y configuración
Manual de uso
Ejemplos de uso
¿Cómo funciona cada uno de los tipos de campos?
Importación y exportación de recursos y elementos
Extras
Soporte

El Administrador de Recursos llegó para facilitar y ayudar a los usuarios de Blip a crear recursos personalizados dentro de la plataforma. Crea, administra y estandariza recursos en Blip sin manipular archivos JSON manualmente. Optimiza el tiempo de desarrollo integrando datos dinámicos al Builder con unos cuantos clics.

Palabras clave: Administrador de Recursos, Recursos, Variables de entorno, JSON, Automatización, Importación, Exportación, Administración de contenido, Extensiones de Blip.

Introducción

A pesar de la gran ventaja y la posibilidad de contar con recursos dentro de la plataforma Blip para organizar, estandarizar y crear contenidos que pueden utilizarse fácilmente en el builder, el proceso de desarrollar un JSON muchas veces puede ser complicado, técnico, tardado y cansado, dependiendo de su tamaño. Pero ¿te imaginas que, con acciones simples y básicas, pudieras crear un recurso para utilizarlo en la construcción de tu contacto inteligente sin necesidad de editar el JSON manualmente, aprovechando mejor la herramienta y ahorrando tiempo y energía?

Ahí es donde surge el Administrador de Recursos. Ahora puedes contar con él para ahorrar tiempo, ganar agilidad y mantener la organización. Además, te permite importar, exportar y administrar tus recursos de forma fácil y sencilla.

A continuación, podrás ver un ejemplo de uso de la extensión en los siguientes videos:

Funcionalidades

La extensión Administrador de Recursos fue desarrollada para facilitar, ayudar y organizar la creación de contenidos de recursos de la plataforma Blip. Es posible crear distintos tipos de contenido sin preocuparse por el JSON, ya que, con unos cuantos clics, el propio administrador lo hará por ti.

Se ofrecen las siguientes funcionalidades:

Registro de recursos únicos personalizados:
Registro de colecciones de recursos personalizados;
Posibilidad de registrar recursos de distintos tipos, como: texto, selección, lista de texto, lista de objetos, on/off y archivos;
Importación de recursos y elementos mediante un archivo JSON;
Listado de recursos registrados;
Listado de los elementos de cada uno de los recursos;
Importación de nuevos elementos a un recurso;
Exportación de elementos y/o estructura de los recursos registrados.

Instalación y configuración

Para utilizar la extensión Administrador de Recursos, debes acceder al contrato en el que deseas instalarla, entrar a Blip Store, acceder a la pestaña de extensiones y buscar Administrador de Recursos. Cuando la encuentres, deberás activarla e instalarla. Una vez activada e instalada, la extensión estará lista para usarse.

Manual de uso

Los usuarios con permisos de administrador pueden realizar todas las funciones de la extensión, como registrar recursos personalizados de distintos tipos e importar y exportar recursos, elementos y estructuras.

Una vez instalada y activada la extensión Administrador de Recursos, si el usuario tiene permisos de administrador, podrá utilizarla al acceder a ella y verá la siguiente pantalla:

Desde la pantalla inicial de la extensión, todos los recursos registrados se mostrarán en una lista. En esta pantalla podrás realizar varias acciones, como registrar un recurso, copiar sus claves principales, editarlo, eliminarlo o acceder a sus datos, además de importar nuevos recursos o incluso utilizar uno de ellos como referencia para registrar uno nuevo mediante la exportación. Es importante tener cuidado al editar los datos y, principalmente, al eliminar elementos. Las acciones son permanentes. Pero no te preocupes: en este tutorial revisaremos todas.

También puedes ver este video de presentación de la extensión para entender un poco más sobre ella antes de continuar con el manual de uso:

Extensión Administrador de Recursos - Blip - Presentación

Ejemplos de uso

En esta sección verás cómo registrar un nuevo recurso personalizado y adaptado a tus necesidades. Después de crearlo, aparecerá en la lista de recursos y podrás acceder a él para administrar sus elementos, así como registrar nuevos elementos.

Registro de recursos

Paso 1) En la pantalla principal de la extensión Administrador de Recursos, haz clic en “Registrar recurso”, como se muestra a continuación:

Después de hacerlo, podrás ver un modal donde registrarás tu recurso, como en el siguiente ejemplo:

Ahora que el modal aparece, es importante completarlo de acuerdo con el objetivo deseado.

Paso 2) Especifica el nombre de tu recurso en el campo “Nombre”. Este se utilizará únicamente para que puedas visualizarlo de forma organizada.

Paso 3) En el campo “Clave”, escribe el nombre de la clave que deseas utilizar en tu recurso. El valor que introduzcas en este campo se utilizará para recuperar el valor del contenido mediante el servidor.

Paso 4) Después de completar los dos campos anteriores, deberás elegir el tipo de recurso que se creará, que puede ser una colección (colección de recursos) o único (un recurso), como se muestra en la imagen:

La forma de registrar ambos tipos es muy similar, pero para evitar dudas, puedes conocer un poco más sobre estos dos tipos en los siguientes videos:

Recurso de tipo colección:

Extensión Administrador de Recursos - Blip - Recurso de tipo colección

Recurso de tipo único:

Extensión Administrador de Recursos - Blip - Recursos de tipo único

Paso 5) Después de esto, podrás agregar los campos deseados a tu recurso, como “Título”, “Clave” y “Tipo”. El campo “Título” se utilizará únicamente como nombre; el campo “Clave” se usará para recuperar el valor del contenido mediante el servidor; y en el campo “Tipo” podrás elegir el tipo de campo deseado: texto, selección, lista de texto, lista de objetos, on/off y archivo. Como se muestra a continuación:

Paso 6) "Para obtener la información registrada en los recursos, solo tienes que utilizar el formato estándar de llamada de variables de recursos de Blip.

Ejemplo:

Nota: el manejo de la variable depende del formato creado. Los objetos, strings, etc. tienen distintos manejos en los Builders/Studios de Blip."

¿Cómo funciona cada uno de los tipos de campos?

Todos los tipos de campos se diferencian en algunos aspectos, pero tienen una característica en común: todos pueden utilizarse.

Campo de tipo texto

Al elegir registrar un recurso con un campo de tipo texto, podrás agregar el texto deseado al recurso y posteriormente utilizarlo en el contacto inteligente, simplemente llamando a la clave del recurso registrado mediante la variable correspondiente para administrar los recursos de Blip. Este tipo inserta un texto en el JSON.

Campo de tipo selección

Al registrar un recurso con un campo de tipo selección, podrás agregar las opciones deseadas al recurso. Cuando registres el elemento del recurso, podrás seleccionar una de las opciones proporcionadas durante la creación. Este tipo inserta un texto en el JSON.

Campo de tipo lista de texto

Al registrar un recurso con un campo de tipo lista de texto, después de registrarlo, solo tienes que hacer clic en “Acceder a los datos”, como se indica para todos los recursos que requieren selección y adiciones posteriores. Después, haz clic en el botón de edición. Se abrirá un modal donde podrás agregar los elementos de tu lista. Recuerda que este tipo de recurso inserta un arreglo de textos en el JSON. Si necesitas agregar otro elemento a la lista, solo haz clic en agregar:

Cuando consideres que está lista, haz clic en el botón “Listo” y tu lista de texto se almacenará.

Después de esto, podrás visualizar tu lista:

Campo de tipo lista de objetos

Si deseas registrar un recurso con un campo de tipo lista de objetos, insertarás un arreglo de objetos en el JSON. Cuando selecciones el tipo, el modal se ampliará y también mostrará los campos del objeto para que los completes, como en la imagen:

Para completar esta información, solo sigue lo que se presentó anteriormente y asegúrate de comprender los tipos de campos. Si deseas agregar otro objeto, haz clic en “Nuevo campo” dentro del recuadro correspondiente, como se muestra a continuación:

Campo de tipo On/Off

El campo On/Off se refiere a un campo de tipo booleano, cuyos valores pueden ser true o false, activo o inactivo. Si eliges utilizarlo, insertarás un valor booleano en el JSON y podrás usarlo de distintas maneras, por ejemplo, para definir si deseas realizar una encuesta de satisfacción al final de la atención.

Después de ingresar la información correspondiente y finalizar el registro, deberás hacer clic en “Acceder a los datos” en el recurso deseado. Entonces podrás activar o desactivar el campo, cuyo resultado será true (habilitado) y false (deshabilitado), como en el ejemplo siguiente:

Campo de tipo archivo

No es ninguna novedad que subir un archivo a Drive para después editarlo y poder usarlo en Blip requiere cierto trabajo. Sin embargo, ¡ahora tus problemas terminaron! Al registrar un recurso con un campo de tipo archivo, podrás agregar el archivo deseado y, una vez registrado, utilizar el enlace directamente desde Blip.

Después de registrar el campo de tipo archivo, haz clic en “Acceder a los datos” de tu recurso y luego en el ícono de lápiz para editarlo.

A continuación, aparecerá un modal en el que deberás hacer clic en el siguiente botón para agregar tu archivo:

Después de subir tu archivo, ya tendrás un enlace:

Después de esto, haz clic en “Listo”. El archivo se registrará y el enlace podrá utilizarse.

Listo, ahora que ya conoces los tipos de recursos, solo tienes que completarlo correctamente para continuar con el siguiente paso.

Paso 6) Ahora que los datos del recurso están completos, revisa la información y, si todo está correcto, haz clic en “Listo” para registrar tu recurso.

Tu recurso estará disponible en la lista de visualización.

Registro de elementos

Paso 1 ) Para registrar elementos en tu recurso, deberás hacer clic en “Acceder a los datos” en el recurso deseado, como se muestra en la imagen:

Paso 2 ) Después de esto, selecciona el botón “Registrar elemento”:

Después de hacer clic en “Registrar elemento”, aparecerá un modal de registro con los campos correspondientes al tipo de recurso que creaste anteriormente.

Paso 3 ) Completa los campos del modal de acuerdo con el elemento deseado y haz clic en “Listo”, como se muestra en la imagen siguiente:

Después de esto, podrás visualizar el elemento registrado en el recurso correspondiente:

Importación y exportación de recursos y elementos

Siguiendo este proceso, podrás importar recursos y elementos mediante un archivo JSON, que puede haber sido creado por ti o exportado desde nuestra extensión. Para ayudarte, consulta el siguiente tutorial:

Extensión Administrador de Recursos - Blip - Importación y exportación

Incluso después de ver el video, si aún tienes alguna duda, solo sigue estos pasos:

Importación de recursos

Paso 1 ) En la pantalla principal, haz clic en el botón “Importar”, como se muestra en la siguiente imagen:

Paso 2 ) Después de hacer clic en “Importar”, aparecerá un modal de importación, como en la imagen:

Por lo tanto, podrás agregar tu JSON de dos formas, como se muestra: arrastrándolo al modal o haciendo clic en el enlace sugerido y seleccionando el JSON deseado.

Paso 3 ) Después de agregar el JSON deseado, tendrás dos opciones: “Cancelar” y “Listo”. Si deseas detener el procedimiento, haz clic en “Cancelar”, como se muestra en la imagen:

En caso de que no quieras cancelar y desees continuar con la importación, haz clic en “Listo”, como se muestra a continuación:

Si tu JSON tiene el formato correcto, se importará correctamente y podrás visualizarlo:

Importación de elementos

Puedes utilizar archivos de importación para importar nuevos elementos al recurso. Estos se procesarán y agregarán inmediatamente a tu lista de elementos.

Paso 1 ) Para importar elementos a tu recurso, deberás hacer clic en “Acceder a los datos” en el recurso deseado, como se muestra en la imagen:

Paso 2 ) Después de esto, selecciona el botón “Importar elementos”:

Después de hacer clic en “Importar elementos”, aparecerá un modal de importación. Solo tienes que arrastrar el archivo o hacer clic en el enlace mostrado para agregar tu JSON.

Paso 3 ) Agrega tu JSON al modal, como se muestra a continuación:

Si seleccionaste el archivo equivocado, haz clic en la papelera que aparece junto a él para quitarlo. Sin embargo, si tu JSON tiene el formato correcto, solo haz clic en “Listo” y tus elementos se agregarán al recurso. Consulta el siguiente ejemplo:

Exportación de recursos

En esta sección aprenderás a exportar los datos de un recurso para utilizarlos en otro lugar o incluso importarlos en otro recurso en cualquier momento. Puedes exportar solo los elementos, solo la estructura del recurso o ambos. Al exportar, se creará un archivo JSON y la descarga comenzará automáticamente.

Paso 1 ) Para exportar elementos de tu recurso, deberás hacer clic en “Acceder a los datos” en el recurso deseado, como se muestra en la imagen:

Paso 2 ) Después de esto, selecciona el botón “Exportar”:

Paso 3 ) Después de hacer clic en exportar, deberás elegir qué deseas exportar. Selecciona la opción deseada, que puede ser: “Elementos y estructura”, “Solo la estructura” o “Solo los elementos”, como en el modal siguiente:

Después de esto, podrás ver el archivo en tus descargas.

Extras

Además de lo que ya viste en el tutorial, a continuación se muestran algunos ejemplos básicos de botones que también se utilizan.

Para eliminar un recurso:

Para copiar las claves de un recurso:

Para editar un recurso:

Para visitar la documentación:

Soporte

Si tienes alguna duda o encuentras algún problema con la extensión, contáctanos por correo electrónico en blippartner@sharkdev.com.br o al número +55(35)99148-3887

¿Necesitas más ayuda? Explora nuestros contenidos en Blip Academy o en Blip Community, mira tutoriales en nuestro canal de YouTube o resuelve tus dudas en nuestro canal de atención 😃