Configuración

Introducción

Para habilitar las actividades de Slack, debes introducir los detalles de autenticación en la actividad del ámbito de Slack . Estos detalles de autenticación le dan al Robot la capacidad de tomar medidas en su nombre y acceder a sus datos permitidos.

Para generar y conceder los detalles de autenticación y empezar a crear su proyecto de automatización, complete los siguientes pasos:

1. Crear una nueva aplicación de Slack (no se requiere codificación)
2. Agregar permisos de la aplicación
3. Instale su aplicación en su espacio de trabajo
4. Construya su proyecto

Después de crear su aplicación, Slack le asigna un ID de cliente único, el Secreto de cliente (p. Ej. app) y un token de acceso de OAuth (para automatización desatendida) que introducirá en las propiedades de autenticación de la actividad de ámbito de Slack .

Pasos

Antes de usar las actividades de Slack, sigue los pasos a continuación para generar o recopilar los datos de entrada necesarios para la actividad del ámbito de Slack .

1. Crear una aplicación de Slack

Para usar las actividades de Slack, puedes crear una aplicación simple de un solo espacio de trabajo. Los pasos y el ejemplo siguientes asumen que tienes un espacio de trabajo existente y eres miembro de este.

1. Inicie sesión en su espacio de trabajo de Slack o abra la aplicación de escritorio de Slack.

   • Si inicia sesión con la URL anterior, necesitará la URL de Slack de su espaciode trabajo.

2. Ve a Tus aplicaciones y haz clic en el botón Crear nueva aplicación .

   
   

   

   
   

3. Introduce el nombre de tu aplicación, selecciona el Espacio de trabajo de Slack para desarrollo y haz clic en el botón Crear aplicación .

   
   

   

   
   

Después de crear tu aplicación, se te dirigirá a la página Información básica . Aquí es donde puedes encontrar el ID de cliente y el Secreto de cliente que necesitarás para la autenticación de automatización atendida en la actividad de Ámbito de Slack .

Antes de copiarlos y pegarlos en tu actividad, debes configurar las características de OAuth y permisos siguiendo los pasos de la siguiente sección.

Nota:

Aunque técnicamente puede, no se recomienda porque necesitará compartir su Secreto de Cliente con ellos.

Si está interesado en compartir su aplicación con los miembros del equipo, puede usar el modo de automatización desatendida porque se basa en un token de acceso OAuth que se puede compartir.

2. Añadir permisos de aplicaciones

La adición de permisos a la aplicación se realiza mediante ámbitos. Los ámbitos definen los métodos API a los que puede llamar esta aplicación y la información a la que puede acceder en el espacio de trabajo en el que está instalada. Muchos ámbitos están restringidos a recursos específicos como canales o archivos.

Nota:

No es necesario agregar ámbitos directamente a su aplicación si planea ejecutar solo la automatización atendida. Si ejecuta automatización atendida, seleccione sus ámbitos mediante la propiedad Ámbitos en la actividad Ámbito de Slack .

Dado que la configuración de ámbitos en su aplicación habilita tanto la automatización asistida como la desatendida, recomendamos completar los siguientes pasos antes de empezar a utilizar el paquete de actividades; esto le permite cambiar libremente entre los modos.

1. En la navegación de la izquierda, haga clic en OAuth y permisos.

2. En la sección URL de redireccionamiento , haz clic en el botón Añadir nueva URL de redireccionamiento e introduce tu URL.

   • Si no conoce la URL que debe introducir, puede dejarla vacía por ahora.

   • Cuando intentas conectarte a tu aplicación con la actividad del ámbito de Slack por primera vez (mediante la automatización atendida), la actividad abre una nueva página web que muestra un error de OAuth. Este error incluye la URL de redireccionamiento (es decir, el URI pasado) que está utilizando su espacio de trabajo. Puede copiar esta URL e introducirla como URL de redirección.

     
     

     

     
     

3. En la sección Ámbitos , añade los ámbitos de los permisos que quieres asignar a tu aplicación y haz clic en el botón Guardar cambios (consulta la lista completa de los Ámbitos para añadir en la siguiente sección).

   
   

   

   
   

Ámbitos a añadir

A continuación, se enumeran los ámbitos necesarios para las diferentes actividades de Slack. También se incluye en la tabla la asignación de cada ámbito a los valores de propiedad de Ámbitos de la actividad de ámbito de Slack .

Ámbito	Actividades	Propiedad de ámbitos
channels:write Modificar sus canales públicos	Crear canal Invitar al canal Unirse al canal Salir del canal Eliminar del canal Enviar mensaje	PublicChannels
grupos: escribir Modificar sus canales privados	Invitar al canal Salir del canal Eliminar del canal Enviar mensaje	PrivateChannels
im: escribir Modificar los mensajes directos del usuario	Invitar al canal Salir del canal Eliminar del canal Enviar mensaje	DirectMessages
mpim:write Realizar cambios en los mensajes del grupo del usuario	Invitar al canal Salir del canal Eliminar del canal Enviar mensaje	GroupMessages
archivos: escribir: usuario Cargar y modificar archivos como usuario	Enviar mensaje	Archivos
archivos: leer Acceder a los archivos, los comentarios y la información asociada del espacio de trabajo	Descargar archivo Enviar mensaje	Archivos
channels:read Acceder a la información sobre el canal público del usuario	Obtener mensajes	PublicChannels
grupos: leer Acceder a la información sobre los canales privados del usuario	Obtener mensajes	PrivateChannels
im:read Acceder a la información sobre los mensajes directos del usuario	Obtener mensajes	DirectMessages
mpim: leer Acceder a la información sobre los mensajes de grupo del usuario	Obtener mensajes	GroupMessages
channels:history Acceder a los canales públicos del usuario	Obtener respuestas	PublicChannels
grupos: historia Acceder al contenido de los canales privados del usuario	Obtener respuestas	PrivateChannels
im:history Acceder al contenido de los mensajes directos del usuario	Obtener respuestas	DirectMessages
mpim: historia Acceder a los mensajes de grupo del usuario	Obtener respuestas	GroupMessages
chat: escribir: usuario Enviar mensajes como usuario	Responder Enviar mensaje	Chat
buscar: leer Buscar el contenido de su espacio de trabajo	Buscar	(incluido con DirectMessages y / o GroupMessages)
usuarios.perfil: escribir Modificar el perfil del usuario	Actualizar estado	Usuarios
usuarios: read.email Ver las direcciones de correo electrónico de los miembros del espacio de trabajo	Invitar al canal Eliminar del canal	Usuarios
users:read Ver la lista de miembros del espacio de trabajo y su información de contacto	Invitar al canal Eliminar del canal	Usuarios

Después de seleccionar sus ámbitos, estará listo para instalar su aplicación en su espacio de trabajo siguiendo los pasos de la siguiente sección.

3. Instale su aplicación en su espacio de trabajo

Dependiendo de cómo se administre tu espacio de trabajo, es posible que debas solicitar la instalación de la aplicación.

1. En la sección URL de redireccionamiento y tokens de OAuth, haz clic en el botón Instalar aplicación en el espacio de trabajo o en el botón Solicitar instalación .

   
   

   

   
   

2. Una vez instalada la aplicación, se genera un token de acceso de OAuth .

   • Al igual que el ID de cliente y el Secretodel cliente, el token de acceso de OAuth se utiliza con fines de autenticación. Las diferencias entre los dos se aplican al ejecutar su proyecto de automatización.

     • Si se ejecuta automatización atendida, la actividad del ámbito de Slack necesita valores en las propiedades IDde cliente, Secretode cliente y Ámbitos .

     • Si se ejecuta una automatización desatendida, la actividad del ámbito de Slack solo necesita un valor en la propiedad del token de acceso de OAuth.

       
       

       

       
       

4. Cree su proyecto

1. Crear un nuevo proyecto de automatización.

   1. Abra UiPath Studio.
   2. En Nuevo proyecto, haz clic en Proceso (se abre una ventana Nuevo proceso en blanco ).
   3. Introduce un Nombre, una Ubicacióny una Descripcióndel proyecto.

   4. Haz clic en Crear.

      
      

      

      
      

2. Instale el paquete UiPath.Slack.Activities .

   1. En la cinta Diseño , haz clic en Administrar paquetes (se abre la ventana Administrar paquetes ).
   2. En Todos los paquetes, haz clic en Ir.
   3. En la barra de búsqueda , escribe Slack.

   4. Haz clic en, instala y acepta la licencia de UiPath.Slack.Activities.

      • Para obtener más información sobre los paquetes de Uipath Studio, consulta Gestionar paquetes en la Guía de Studio.

        
        

        

        
        

¡Ya está!

Ahora que has completado la configuración, puedes empezar a añadir actividades de Slack a tu proyecto.

Próximos pasos

Para una experiencia de aprendizaje práctica y para empezar a utilizar rápidamente las actividades, consulta las guías de inicio rápido . Estas guías proporcionan instrucciones paso a paso para ayudarte a crear ejemplos de trabajo de las diferentes actividades para que puedas verificar la conexión a tu Slack WorkSpace y familiarizarse con las propiedades de entrada / salida.

Para obtener más información sobre las actividades de Slack (incluidas las entradas / salidas de propiedades de ejemplo), consulta la página Actividades para obtener una lista completa de actividades y enlaces a las páginas de detalles de las actividades.