Acción Conectar del package Slack

Autentíquese en Slack mediante una conexión OAuth2 de Control Room y cree una sesión reutilizable de Slack para acciones posteriores en la automatización.

Requisitos

Antes de usar la acción Conectar, primero debe crear y configurar una aplicación de Slack, generar el token de Bot requerido y configurar una conexión OAuth en la Control Room completando el siguiente requisito previo:

Crear una aplicación de Slack
  • Vaya al portal de desarrolladores de Slack: https://api.slack.com/apps
  • Vaya a Sus aplicaciones > Crear nueva aplicación.
  • Elija Desde cero.

    Crear una aplicación

  • Ingrese los siguientes datos:
    • Nombre de la aplicación: Por ejemplo, Integración de AA con Slack.
    • Elija un espacio de trabajo para desarrollar su aplicación: seleccione el espacio de trabajo de Slack donde se usará la aplicación.

    Elegir espacio de trabajo

  • Haga clic en Crear aplicación.
Configurar OAuth y permisos
  • Después de crear la aplicación, en el panel izquierdo, vaya a OAuth y permisos.
  • Vaya a la sección URL de redireccionamiento. En el campo URL de redireccionamiento, ingrese la URL de llamada de la configuración de conexión de la Control Room.
  • Vaya a la sección Alcances.

Agregar alcances de token de Bot: En la sección Alcances, agregue los permisos requeridos según su caso de uso. Para agregarlos, haga clic en Agregar un alcance de OAuth.

A continuación, se enumeran algunos ejemplos:
  • chat:write → Enviar mensajes como @Integración de AA con Slack
  • channels:read → Ver información básica sobre los canales públicos en un espacio de trabajo
  • channels:history → Ver mensajes y otro contenido en los canales públicos a los que se ha agregado INtegración de AA con Slack
  • groups:read → Ver información básica sobre los canales privados a los que se ha agregado la Integración de AA con Slack
  • im:read → Ver información básica sobre los mensajes directos a los que se ha agregado la Integración de AA con Slack.
Nota:
  • Asegúrese de elegir sus alcances cuidadosamente, ya que si los alcances son insuficientes las acciones podrían fallar más adelante.
  • Actualmente, solo se admite la autenticación con Bot Token.

Configurar la conexión OAuth 2.0: Para obtener más información sobre cómo crear un proveedor personalizado, consulte Configuración de la conexión OAuth 2.0 en la Control Room.

Configuración

  • En el campo Conexión OAuth , haga clic en Elegir para elegir entre las credenciales OAuth2 administradas por la Control Room disponibles.
    Nota: Asegúrese de que la conexión OAuth2 sea válida y esté activa en la Control Room.
  • Haga clic en el menú desplegable Tipo de proveedor para seleccionar un proveedor disponible o personalizado.
  • En el campo Nombre de la conexión, seleccione el objeto de conexión OAuth específico.

    Este campo está deshabilitado hasta que se seleccione un tipo de proveedor.

  • En el campo Tipo de token, seleccione una de las siguientes opciones según el token que se utilizará en el tiempo de ejecución.
    • Compartido: en el caso de un token global.

      Un token de acceso de tipo compartido se crea cuando se establece una conexión con Control Room. Este token de acceso se almacena como una credencial. Cuando ejecuta su automatización, se hace referencia al token de acceso en la automatización utilizando el tipo de proveedor de aplicaciones empresariales configurado en Control Room.

    • Específico del usuario: en el caso de un token que es específico de un usuario.
  • En el campo Sesión de Slack, use una de las siguientes pestañas para crear una sesión:
    • Sesión local: para especificar un nombre de sesión que solo se pueda utilizar en el bot actual.
    • Sesión global: para especificar un nombre de sesión que se pueda utilizar en varios bots, como bots principales, bots secundarios y todos los demás bots secundarios del bot principal.

      Recomendación: Los bots principal y secundario deben tener la misma versión de paquete.

    • Variable: para especificar una variable de sesión de Slack.

      Haga clic en el ícono de la derecha para crear una variable y, luego, elija Sesión de Slack como el tipo de sesión en la ventana que aparece. Consulte Crear una variable.