HEFLO le permite integrar su plataforma con otras aplicaciones. En este artículo, le mostraremos cómo abrir elementos de trabajo a través de un comando de barra diagonal en Slack.

Para ello, utilizaremos un proceso de soporte de demostración simple.

Adaptación de procesos

Agregue el evento iniciador «Mensaje», ubicado en la caja de herramientas BPMN a la izquierda, al área de dibujo o línea de proceso y conéctelo con la actividad «Análisis y resolución de la demanda».

Debe crear un campo de tipo «TEXTO» en el proceso, que recibirá el parámetro proveniente de Slack. Para hacer esto, agregue un elemento «Entrada de datos» y cree la nueva propiedad.

Establezca el campo en varias líneas.

Obtenga más información sobre cómo crear formularios en Creación de formularios.

Configuración de la integración en HEFLO

Seleccione el iniciador «Mensaje» y vaya a la pestaña de propiedades a la derecha, luego, en el atributo Conector, seleccione la opción «Servicio web».

Haga clic en el botón «Configurar SERVICIO WEB», en la ventana que se abrirá, complete los siguientes parámetros:

Cambie el campo «Tipo de contenido» a «ENCODED FORM URL (X-WWW-FORM-URLENCODED)».

Slack por defecto envía un parámetro llamado «texto» en la integración, necesitamos crear este parámetro en HEFLO y vincularlo a un campo de elemento de trabajo, en nuestro ejemplo lo vincularemos al campo «Problema», creado al principio de el artículo.

Haga clic en el enlace «Haga clic aquí para generar la clave» en el atributo «Clave de acceso», navegue hasta el área «Claves API» y haga clic en «Agregar nueva clave».

En la ventana que se abrirá, haga clic en «Cerrar y descargar». El campo «Clave» representa el usuario y la contraseña «Secreta».

Importante: HEFLO descarga un archivo .txt con los datos de la ventana anterior para que no pierdas esta información, no podrás cambiar la contraseña, si la necesitas, deberás generar una nueva clave y actualice la URL de la aplicación de llamada, para esto, guárdela en una carpeta segura.

Toda la integración será segura porque utiliza el protocolo https que garantiza un canal encriptado entre las aplicaciones, además de la Clave y Clave Secreta gestionada en HEFLO.

Haga clic en «Confirmar» en la ventana «Configurar servicio web». Una vez hecho esto, HEFLO crea los enlaces de prueba y producción para su proceso, que se utilizarán en Slack para realizar las llamadas.

El enlace de producción se habilitará y se mostrará solo cuando se publique la automatización del proceso, pero puede verlo haciendo clic en «Haga clic aquí para ver la URL ahora».

Creación de aplicaciones en Slack

Vaya a Slack, haga clic en su ID de usuario, luego en «Administración» y luego en «Administrar aplicaciones».

En la pantalla que se abrirá, haz clic en «Crear» y luego en «Tus aplicaciones».

Haga clic en «Crear nueva aplicación» y en la ventana que aparecerá, complete los campos «Nombre de la aplicación», con el nombre de su aplicación en slack y «Área de trabajo de desarrollo de Slack» con su equipo de desarrollo, luego haga clic en «Crear aplicación».

En la pantalla que se mostrará, elija «Comandos de barra», luego haga clic en «Crear nuevo comando» y complete los parámetros como se muestra a continuación.

Deje el parámetro «Solicitar URL» en blanco por ahora y complete los demás campos.

Para el campo «Solicitar URL» necesitamos hacer algunos ajustes a la url generada por HEFLO.

Ajuste de las URL de prueba de HEFLO

Vuelva a acceder a su proceso en HEFLO y copie la «URL de prueba» en las propiedades del iniciador en «Mensaje».

Pegue la URL en un archivo de texto y abra el archivo .txt que se descargó en su máquina con la clave y la contraseña.

Ahora necesita poner «https: //» el valor del atributo Clave, luego poner «:» e incluir la Contraseña, y para terminar su url inserte una «@» después de la Contraseña como se muestra en la imagen de abajo.

Ahora, con nuestra URL configurada, volvamos a Slack para terminar de configurar nuestro comando de barra inclinada.

Terminando la configuración de la aplicación Slack

Pegue la nueva URL en el campo «Solicitar URL» y luego haga clic en «Guardar».

Su comando se creará como en la imagen de abajo.

Ahora es necesario instalar la aplicación en Slack para que los usuarios puedan usarla.

Una vez instalado, puede crear inmediatamente elementos de trabajo mediante el comando de barra diagonal. Escriba / Start-Support y luego la Descripción que llenará el campo Problema en su elemento de trabajo.

Haga clic en «Entrar» para realizar la integración de llamadas y recibirá la respuesta de HEFLO.

Observe que se creó el elemento de prueba número 15.

Comprobación del elemento de prueba creado en HEFLO

Para ver el elemento, acceda a su proceso en HEFLO, haga clic derecho en el iniciador del mensaje, luego en «Pruebas» y luego en el elemento creado por Slack.

Tenga en cuenta que la descripción ingresada en el comando de barra inclinada coincide con el valor del campo «Problema» en su elemento de trabajo.

Creación de artículos en producción

Para comenzar a crear elementos en producción mediante el comando de barra, debe acceder a su proceso en HEFLO y publicar la automatización. Para hacer esto, haga clic en el icono «Acciones» en el menú de propiedades y luego en «Publicar automatización».

Vuelva a ajustar la URL usando el enlace de producción ahora. Seleccione el iniciador del mensaje y en las propiedades copie el enlace de producción.

La clave y la contraseña siguen siendo las mismas, así que simplemente reemplace la URL en el enlace de prueba con el enlace de producción.

Actualización de Slack con producción de URL

Vuelva a acceder a Slack y edite su comando de barra inclinada ingresando la nueva URL y luego guardando.

Ahora puede usar su comando Slash para crear elementos viables en su espacio de trabajo HEFLO.

Importante: te recomendamos que mantengas dos comandos en Slack, uno para pruebas y otro para producción.