Conexión de Slack

Introducción

Una conexión de Slack, creada utilizando el conector de Slack, establece acceso a Slack. Una vez que se configura una conexión, se pueden crear instancias de actividades de Slack asociadas con esa conexión para ser utilizadas como fuentes (para proporcionar datos en una operación) o como destinos (para consumir datos en una operación).

Crear o editar una conexión de Slack

Se crea una nueva conexión de Slack utilizando el conector de Slack desde una de estas ubicaciones:

• La pestaña Puntos finales y conectores del proyecto en la paleta de componentes de diseño (ver Paleta de componentes de diseño).
• La página de Puntos finales globales (ver Crear un punto final global en Puntos finales globales).

Una conexión de Slack existente se puede editar desde estas ubicaciones:

• La pestaña Puntos finales y conectores del proyecto en la paleta de componentes de diseño (ver Paleta de componentes de diseño).
• La pestaña Componentes del panel del proyecto (ver Menú de acciones de componentes en Pestaña de componentes del panel del proyecto).
• La página de Puntos finales globales (ver Editar un punto final global en Puntos finales globales).

Configurar una conexión de Slack

Cada elemento de la interfaz de la pantalla de configuración de la conexión de Slack se describe a continuación.

La interfaz utilizada en la configuración de la conexión de Slack depende de la opción seleccionada Mecanismo de autenticación:

• Autenticación basada en token: Para esta opción, la conexión se autentica utilizando un token OAuth para tu aplicación de Slack.

• Código de autorización: Para esta opción, la conexión se autentica a través de Slack en una pestaña de navegador separada (OAuth de 3 pasos). Una vez autenticado, proporcionas consentimiento para que Harmony acceda a la aplicación de Slack. Esta opción requiere el uso de la versión del agente 10.83 / 11.21 o posterior.

Autenticación basada en token

Cuando se selecciona Autenticación basada en token como el mecanismo de autenticación, se presenta la interfaz descrita a continuación.

• Nombre de la conexión: Ingresa un nombre para identificar la conexión. El nombre debe ser único para cada conexión de Slack y no debe contener barras diagonales / ni dos puntos :. Este nombre también se utiliza para identificar el punto final de Slack, que se refiere tanto a una conexión específica como a sus actividades.

• Mecanismo de autenticación: Selecciona Autenticación basada en token para autenticar utilizando un token de acceso OAuth.

• Tipo de autenticación: Selecciona el tipo de autenticación, ya sea Token de acceso OAuth o Token de acceso OAuth de usuario Bot (recomendado):

  • Token de acceso OAuth: Si se seleccionó Token de acceso OAuth como el tipo de autenticación, ingresa el token de usuario que obtuviste del sitio web de la API de Slack, como se describe en Obtener un token OAuth en Requisitos previos.

• Token de acceso OAuth del usuario Bot: Si se seleccionó Token de acceso OAuth del usuario Bot como el tipo de autenticación, ingresa el token del bot que obtuviste del sitio web de la API de Slack, como se describe en Obtener un token OAuth en Requisitos previos. Esta es la opción recomendada.

• Usar configuraciones de proxy (solo agente privado): Al usar un agente privado, se puede seleccionar esta configuración para utilizar configuraciones de proxy del agente privado.

• Probar: Haz clic para verificar la conexión utilizando la configuración proporcionada. Cuando se prueba la conexión, la última versión del conector es descargada por el(los) agente(s) en el grupo de agentes asociado con el entorno actual. Este conector admite suspender la descarga de la última versión del conector utilizando la política de organización Deshabilitar actualización automática del conector.

• Guardar cambios: Haz clic para guardar y cerrar la configuración de la conexión.

• Descartar cambios: Después de realizar cambios en una configuración nueva o existente, haz clic para cerrar la configuración sin guardar. Un mensaje te pide que confirmes que deseas descartar los cambios.

• Eliminar: Después de abrir una configuración de conexión existente, haz clic para eliminar permanentemente la conexión del proyecto y cerrar la configuración (ver Dependencias de componentes, eliminación y remoción). Un mensaje te pide que confirmes que deseas eliminar la conexión.

Código de autorización Grant

Cuando se selecciona Código de autorización Grant como el mecanismo de autenticación, se presenta la interfaz descrita a continuación.

• Nombre de la conexión: Ingresa un nombre para identificar la conexión. El nombre debe ser único para cada conexión de Slack y no debe contener barras diagonales / ni dos puntos :. Este nombre también se utiliza para identificar el punto final de Slack, que se refiere tanto a una conexión específica como a sus actividades.

• Mecanismo de autenticación: Selecciona Authorization Code Grant para autenticar proporcionando consentimiento a través de Slack en una pestaña de navegador separada (OAuth de 3 patas).

• Aplicación OAuth: Visible solo cuando hay aplicaciones privadas registradas en la página de Registro de Aplicaciones. Usa el menú para seleccionar una aplicación OAuth 2.0 de una de estas categorías:

  • Aplicaciones en la Nube: La aplicación en esta categoría (Jitterbit App) es una aplicación OAuth 2.0 proporcionada por Jitterbit. Si no hay aplicaciones privadas registradas en la página de Registro de Aplicaciones, se utiliza Jitterbit App por defecto.

  • Aplicaciones Privadas: Esta categoría muestra aplicaciones de conector de Slack configuradas en la página de Registro de Aplicaciones de la Consola de Administración App Registrations. Para más información sobre cómo configurar una aplicación de conector de Slack en la página de Registro de Aplicaciones, consulta Configurar OAuth de 3 patas en Requisitos Previos.

  Nota

  Si el campo Aplicación OAuth no es visible, se utiliza por defecto la aplicación OAuth 2.0 proporcionada por Jitterbit.

• Iniciar sesión con Slack: Haz clic para autenticar a través de Slack en una pestaña de navegador separada y proporciona consentimiento para que Jitterbit acceda a la aplicación de Slack.

• Usar Configuraciones de Proxy (Solo Agente Privado): Al usar un agente privado, se puede seleccionar esta configuración para usar configuraciones de proxy de agente privado.

• Probar: Haz clic para verificar la conexión utilizando la configuración proporcionada. Cuando se prueba la conexión, la última versión del conector es descargada por el(los) agente(s) en el grupo de agentes asociado con el entorno actual. Este conector admite suspender la descarga de la última versión del conector utilizando la política de organización Deshabilitar Actualización Automática del Conector.

• Guardar cambios: Haga clic para guardar y cerrar la configuración de la conexión.

• Descartar cambios: Después de realizar cambios en una configuración nueva o existente, haga clic para cerrar la configuración sin guardar. Un mensaje le pide que confirme que desea descartar los cambios.

• Eliminar: Después de abrir una configuración de conexión existente, haga clic para eliminar permanentemente la conexión del proyecto y cerrar la configuración (consulte Dependencias de componentes, eliminación y remoción). Un mensaje le pide que confirme que desea eliminar la conexión.

Siguientes pasos

Después de que se ha creado una conexión de Slack, se coloca un tipo de actividad en el lienzo de diseño para crear instancias de actividad que se utilizarán como fuentes (para proporcionar datos en una operación) o como destinos (para consumir datos en una operación).

Las acciones del menú para una conexión y sus tipos de actividad son accesibles desde el panel del proyecto y la paleta de componentes de diseño. Para más detalles, consulte Menús de acciones en Conceptos básicos del conector.

Estos tipos de actividad están disponibles:

• Buscar: Encuentra mensajes en Slack y está destinado a ser utilizado como fuente en una operación.

• Publicar: Publica un objeto en un canal de Slack y está destinado a ser utilizado como destino en una operación.

• Chat: Coloca información de chat en Slack y está destinado a ser utilizado como destino en una operación.

• Obtener: Recupera datos de objetos de Slack y está destinado a ser utilizado como fuente en una operación.

• Archivos: Coloca información de archivos en Slack y está destinado a ser utilizado como destino en una operación.

• Conversations: Publica información de conversaciones en Slack y está destinado a ser utilizado como un objetivo en una operación.

• Users: Coloca información de usuarios en Slack y está destinado a ser utilizado como un objetivo en una operación.