Microaplicaciones

Integrar Slack

Implemente la integración de Slack para proporcionar funciones de supervisión adicionales de los canales críticos, que pueden no requerir mucho tráfico pero sí la atención de sus miembros. Con el fin de adaptar los canales disponibles a un grupo o departamento específicos, utilice múltiples integraciones.

Nota:

¡Su opinión nos interesa! Proporcione comentarios sobre esta plantilla de integración a medida que la utiliza. Para cualquier problema, nuestro equipo también supervisará el foro dedicado a diario.

Para obtener información detallada sobre la microaplicación de uso inmediato para Slack, consulte Usar Slack.

Revisar requisitos previos

Estos son los valores que se especifican en las microaplicaciones de Citrix Workspace:

  • URL base: https://slack.com/api
  • URL de autorización: https://slack.com/oauth/authorize
  • URL del token: https://slack.com/api/oauth.access
  • ID de canal: Obtendrá este al crear un canal favorito en Slack. Lo necesita para modificar los dispositivos de punto final y las acciones de servicio. Consulte Crear un canal favorito y recopilar ID de canal.
  • Token de acceso de OAuth: Se introduce como valor de token al configurar la plantilla de integración. Obtendrá este token, el ID de cliente y el secreto del cliente al Crear bot.
  • ID de cliente: El ID de cliente es la cadena que representa la información de registro del cliente exclusiva del servidor de autorización.
  • Secreto del cliente: El secreto del cliente es la cadena única emitida al configurar la integración de la aplicación de destino.

Nota:

Se recomienda utilizar OAuth 2.0 como método de autenticación del servicio siempre que esté disponible. OAuth 2.0 garantiza que la integración es conforme a los requisitos de seguridad más estrictos con la microaplicación configurada.

Crear una cuenta de servicio

La integración requiere un acceso periódico a su instancia de Slack. Recomendamos crear una cuenta de usuario dedicada con privilegios de administrador total. Regístrese aquí: https://slack.com/get-started#/create.

Habilitar API

El número de solicitudes de API que se pueden realizar a recursos específicos es limitado. Recomendamos, por tanto, lo siguiente:

Crear el bot

Los bots son aplicaciones de Slack que interactúan con los usuarios y tienen la capacidad de publicar, recibir y responder a los mensajes de los usuarios. Cree la aplicación de Slack y seleccione ámbitos para agregar a la aplicación.

  1. Vaya a la interfaz de usuario de administración de Slack y cree una aplicación si aún no ha creado una: https://api.slack.com/apps
  2. Introduzca un nombre de aplicación y seleccione el espacio de trabajo de desarrollo de Slack donde se instalará la aplicación.
  3. Seleccione Crear aplicación.
  4. En Información básica, copie la siguiente información de Credenciales de aplicación:
    • ID de cliente
    • Secreto del cliente
  5. Vaya a OAuth y Permisos bajo Funciones en la barra lateral izquierda.
  6. En Ámbitos/Ámbitos de token de bot, seleccione el icono de Agregar un ámbito de OAuth bajo la sección Ámbitos. Asegúrese de agregar ámbitos al token de bot, no a su token de usuario. Agregue estos ámbitos: channels:history channels:join channels:read groups:history groups:read mpim:history mpim:read team:read users.profile:read users:read users:read.email
  7. En URL de redireccionamiento, para cada una de las siguientes respuestas seleccione Agregar nueva URL de redirección, introduzca el valor y seleccione Guardar URL cuando haya terminado.
    • https://{yourmicroappserverurl}/admin/api/gwsc/auth/serverContext
    • https://{yourmicroappserverurl}/app/api/auth/serviceAction/callback

Instalar la aplicación de Slack

Instale la aplicación en su espacio de trabajo de Slack para probarla y generar los tokens necesarios para interactuar con la API de Slack.

  1. Vaya a Instalar aplicación en Parámetros, en la barra lateral izquierda.
  2. Seleccione Instalar aplicación en el espacio de trabajo, asegúrese de que la aplicación esté autorizada para realizar acciones en canales y conversaciones y seleccione Permitir.
  3. Copie el token de acceso de OAuth del usuario bot.

Crear un canal favorito y recopilar ID de canal

Cree un canal para hacer seguimiento de favoritos. Debe recopilar el ID de canal de la URL de este canal para modificar la integración.

Nota:

Si utiliza varias integraciones de Slack, utilice un canal favorito separado o dedicado para cada integración.

  1. Cree un nuevo canal en Slack y asígnele el nombre favoritos.
  2. Seleccione Agregar todos los miembros de {Nombre_EspacioTrabajo_Slack}
  3. Copie el enlace del canal. Guarde el ID al final de la URL. Este es el ID de canal que necesita para modificar los dispositivos de punto final y las acciones de servicio. Consulte Modificar dispositivos de punto final y acciones de servicio.

Agregar el bot a los canales prioritarios y favoritos

Ahora agregue el bot (aplicación Slack) a cualquier canal que quiera exponer al equipo suscrito a la aplicación y al canal favorito creado anteriormente. Se deben tener en cuenta las siguientes cuestiones:

  • No agregue un bot a un canal con ruido. Los bots deben agregarse a canales que se utilizan para comunicaciones poco frecuentes y en las que el tiempo es crítico dentro de un grupo seleccionado, como problemas urgentes de ventas para el grupo de ventas o seguridad de TI para empleados en general.
  • Varias integraciones pueden apuntar a una misma aplicación de Slack.
  • Mantenga la lista de canales centrada en un grupo específico.
  • Solo recomendamos agregar el bot a un canal público. Agregar bots a un canal privado puede permitir a otros ver la pertenencia a grupos del canal privado.

Agregar la integración a las microaplicaciones de Citrix Workspace

Agregue la integración de Slack a las microaplicaciones de Citrix Workspace para conectarse a su aplicación. Las opciones de autenticación están preseleccionadas. Compruebe que estas opciones estén seleccionadas a medida que complete el proceso. Esto proporciona microaplicaciones de uso inmediato con notificaciones y acciones preconfiguradas que se pueden usar desde ya en su espacio de trabajo.

Siga estos pasos:

  1. En la página Integraciones de microaplicaciones, seleccione Agregar nueva integración y Agregar una nueva integración a partir de plantillas proporcionadas por Citrix.
  2. Elija el mosaico de Slack.
  3. En el campo Nombre de la integración, introduzca un nombre para la misma.
  4. Introduzca los parámetros del conector.
    • Introduzca la URL base de la instancia: https://slack.com/api
    • Seleccione un icono para la integración en la Biblioteca de iconos, o deje el icono predeterminado.

    Parámetros de conexión

  5. En Autenticación de servicio, seleccione Token de portador en el menú Método de autenticación y complete los detalles correspondientes. Las opciones de autenticación están preseleccionadas. Compruebe que estas opciones estén seleccionadas a medida que complete el proceso.
  6. Introduzca el token. Este valor es el token de acceso de OAuth del usuario bot que se recopila al crear el bot. Consulte Crear el bot.

    Autenticación

  7. En Autenticación de acciones de servicio, habilite la opción Usar autenticación de usuario independiente en Acciones. Esto autentica en el nivel de acción de servicio. Las opciones de autenticación están preseleccionadas. Compruebe que estas opciones estén seleccionadas a medida que complete el proceso.

    1. En el menú Método de autenticación, seleccione OAuth 2.0 y complete los detalles de autenticación.
    2. En el menú Flujo de tipo de concesión, seleccione Código de autorización.
    3. En el campo Valor de tipo de concesión, introduzca authorization_code.La dirección URL de respuesta se rellena automáticamente.
    4. Seleccione Cuerpo de la solicitud en el menú Autorización de token.
    5. En el menú Tipo de contenido de token, seleccione URL codificada del formulario. La URL de autorización se rellena automáticamente: https://slack.com/oauth/authorize. La URL del token se rellena automáticamente: https://slack.com/api/oauth.access.
    6. Compruebe que se ha introducido lo siguiente para el ámbito: channels:history channels:join channels:read groups:history groups:read mpim:history mpim:read team:read users.profile:read users:read users:read.email
    7. Introduzca el ID de cliente obtenido en Crear el bot.
    8. Introduzca el Secreto de cliente obtenido en Crear el bot.

    Acción de servicio

  8. Habilite la opción Limitación del índice de solicitudes e introduzca 1 en Cantidad de solicitudes por segundo.
  9. Introduzca 120 en el campo Tiempo de espera de solicitud.
  10. (Optativo) Habilite la opción Registro para conservar un registro de 24 horas con fines de asistencia.
  11. Seleccione Guardar.

    Índice de solicitudes

Se abrirá la página Integraciones de microaplicaciones con la integración agregada y sus microaplicaciones. Ahora, modifique la integración agregando el valor channel como se describe en el siguiente procedimiento.

Modificar dispositivos de punto final y acciones de servicio

Para completar esta configuración, debe agregar el valor channel con su ID de canal recopilado en Crear un canal favorito y recopilar ID de canal. Modifique el dispositivo de punto final de Canales favoritos y las acciones de servicio Canal favorito y Quitar de favoritos.

Reemplazar dispositivo de punto final de carga de datos

Agregue manualmente el valor channel en el dispositivo de punto final de Canales favoritos con su ID de canal.

  1. En la página Integraciones de microaplicaciones, seleccione el menú situado junto a la integración de Slack y, a continuación, Modificar. Se abrirá la pantalla Carga de datos. Si se encuentra en la pantalla de configuración, seleccione Carga de datos en la columna de navegación del lado izquierdo.
  2. Seleccione el menú situado junto al dispositivo de punto final de Canales favoritos y, a continuación, Modificar, o bien seleccione el nombre del dispositivo de punto final: Canales favoritos.

    Canales favoritos

  3. En la pantalla Modificar dispositivo de punto final de datos, en Sincronizaciones completas, introduzca el ID de canal en el campo correspondiente al valor del canal.
  4. Seleccione Aplicar en la parte inferior de la pantalla y confirme la operación.

    Valor del canal

Reemplazar variables de acción de servicio

Para las acciones de servicio Canal favorito y Quitar de favoritos, debe agregar manualmente el valor channel con su ID de canal dos veces para ambas acciones de servicio. Una vez en Ejecución de la acción y otra en Actualización de datos después de la acción (opcional).

  1. Mientras modifica la configuración de integración, seleccione Acciones de servicio en la columna de navegación del lado izquierdo.
  2. Seleccione el menú situado junto a una de las acciones de servicio que necesita modificar y seleccione Modificar, o bien seleccione el nombre de la acción de servicio correspondiente. Empecemos con Canal favorito.

    Canales

  3. En la pantalla Modificar acción de servicio, en Secuencia de acciones y, a continuación, en Ejecución de la acción, seleccione CUERPO.
  4. Introduzca el ID de canal en el campo de valor correspondiente al canal.
  5. En Actualización de datos después de la acción (opcional), vuelva a introducir el ID de canal en el campo correspondiente al valor del canal.

    Valor del canal

  6. Seleccione Guardar para finalizar.
  7. Ahora repita esto para la otra acción de servicio: Quitar de favoritos. Agregue el valor channel con su ID de canal dos veces. Una vez en Ejecución de la acción y otra en Actualización de datos después de la acción (opcional).

Para obtener información detallada sobre los dispositivos de punto final de las API y las entidades de tabla, consulte Especificaciones del conector de Slack.

Usar microaplicaciones de Slack

Las integraciones de las aplicaciones existentes vienen con microaplicaciones de uso inmediato. Comience con estas microaplicaciones y personalícelas conforme a sus exigencias.

Mis canales favoritos: Sirve para recibir notificaciones de actividad en canales favoritos.

Notificación o página Flujos de trabajo por caso de uso
Página Lista de canales Proporciona una lista de canales favoritos, con la opción Agregar canales.
Página Detalles del canal Permite ver los detalles de un canal favorito, incluidas las publicaciones anteriores. Incluye opciones de botón para Publicar mensaje y Quitar canal de favoritos.
Página Detalles del mensaje Permite ver los detalles de un mensaje de un canal favorito, con los datos del remitente. Incluye opciones de botón para Aprobación (pulgar hacia arriba) y Ver respuestas en Slack.
Página Publicar un mensaje Proporciona un formulario para redactar y un botón para Publicar un mensaje en un canal favorito.
Página Agregar detalles del canal Permite ver los detalles de un canal, incluidos sus miembros. Incluye una opción de botón para Agregar a favoritos.
Página Agregar lista de canales Proporciona una lista de canales en la que se puede buscar, con una opción para ver detalles en la página Detalles del canal.

Publicar en Slack: Sirve para publica un mensaje en el canal prioritario seleccionado en Slack.

Notificación o página Flujos de trabajo por caso de uso
Página Publicar nuevo mensaje Proporciona un formulario para redactar y publicar un mensaje.

Establecer mi estado de Slack: Permite establece el estado de Slack, crear avisos y habilitar No molestar durante un período de tiempo determinado.

Notificación o página Flujos de trabajo por caso de uso
Página Crear un aviso Proporciona un formulario para establecer un aviso.
Página Pausar notificaciones Proporciona un formulario para poner en pausa las notificaciones durante un período de tiempo determinado.
Página Establecer mi estado de Slack Proporciona un formulario para establecer un estado, con opciones para Establecer aviso y No molestar.