Conexión Slack

Introducción

Una conexión de Slack, creada mediante el conector de Slack, establece acceso a Slack. Una vez configurada una conexión, puedes crear instancias de actividades de Slack asociadas con esa conexión para usarlas 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 extremos y conectores del proyecto de la paleta de componentes de diseño (consulte paleta de componentes de diseño).
• La página Conexiones globales (vea Crear un extremo global en Conexiones globales).

Se puede editar una conexión de Slack existente desde estas ubicaciones:

• La pestaña extremos y conectores del proyecto de la paleta de componentes de diseño (consulte paleta de componentes de diseño).
• La pestaña Componentes del panel del proyecto (vea menú de acciones de componentes en la pestañaComponentes del panel Proyecto).
• La página Conexiones globales (vea Editar un extremo global en Conexiones globales).

Configurar una conexión Slack

A continuación se describe cada elemento de la interfaz de usuario de la pantalla de configuración de la conexión de Slack.

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

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

• Concesión de código de autorización: Para esta opción, la conexión se autentica a través de Slack en una pestaña separada del navegador (OAuth de 3 patas). Una vez autenticado, usted otorga su consentimiento para que Harmony acceda a la aplicación 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 mecanismo de autenticación, se presenta esta interfaz:

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

• Mecanismo de autenticación: Seleccione Autenticación basada en token para autenticarse usando un token de acceso OAuth.

• Tipo de autenticación: Seleccione 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 Tipo de autenticación, ingrese el token de usuario que obtuviste del sitio web de la API de Slack, como se describe en Obtener un token OAuth en Prerrequisitos.

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

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

• Prueba: Haz clic para verificar la conexión usando la configuración proporcionada. Cuando se prueba la conexión, los agentes del grupo de agentes asociado con el ambiente actual descargan la última versión del conector. Este conector admite la suspensión de la descarga de la última versión del conector mediante la política de la organización Deshabilitar actualización automática del conector.

• Guardar cambios: Haga clic para guardar y cerrar la configuración de 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 solicitará 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 te pedirá que confirmes que deseas eliminar la conexión.

Concesión de código de autorización

Cuando se selecciona Concesión de código de autorización como mecanismo de autenticación, se presenta esta interfaz:

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

• Mecanismo de autenticación: Seleccione Concesión de código de autorización para autenticarse proporcionando el consentimiento a través de Slack en una pestaña separada del navegador (OAuth de 3 patas).

• Aplicación OAuth: Visible solo cuando se registran aplicaciones privadas en Registro de aplicaciones página. Use 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 (Aplicación Jitterbit) es una aplicación OAuth 2.0 proporcionada por Jitterbit. Si no hay aplicaciones privadas registradas en Registro de aplicaciones página, se utiliza Jitterbit App de forma predeterminada.

  • Aplicaciones privadas: Esta categoría muestra las aplicaciones del conector de Slack configuradas en la Management Console Registros de aplicaciones página. Para obtener más información sobre cómo configurar una aplicación de conector de Slack en la página Registros de aplicaciones, consulte Configurar OAuth de 3 vías en Prerrequisitos.

  Nota

  Si el campo Aplicación OAuth no está visible, se utiliza de forma predeterminada la aplicación OAuth 2.0 proporcionada por Jitterbit.

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

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

• Prueba: Haz clic para verificar la conexión usando la configuración proporcionada. Cuando se prueba la conexión, los agentes del grupo de agentes asociado con el ambiente actual descargan la última versión del conector. Este conector admite la suspensión de la descarga de la última versión del conector mediante la política de la organización Deshabilitar actualización automática del conector.

• Guardar cambios: Haga clic para guardar y cerrar la configuración de 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 solicitará 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 te pedirá que confirmes que deseas eliminar la conexión.

Próximos pasos

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

Se puede acceder a las acciones del menú de una conexión y sus tipos de actividad desde el panel de proyecto y la paleta de componentes de diseño. Para obtener más información, consulte Menús de acciones en Conceptos básicos del conector.

Estos tipos de actividades están disponibles:

• Buscar: Encuentra mensajes en Slack y está pensado para usarse como fuente en una operación.

• Correo: Publica un objeto en un canal de Slack y está destinado a usarse como objetivo en una operación.

• Charlar: Coloca información de chat en Slack y está destinado a usarse como objetivo en una operación.

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

• Archivos: Coloca información de archivo en Slack y está destinado a usarse como objetivo en una operación.

• Conversaciones: Publica información de conversaciones en Slack y está destinado a usarse como objetivo en una operación.

• Usuarios: Coloca información del usuario en Slack y está destinado a usarse como objetivo en una operación.