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:

Crear una nueva aplicación de Slack (no se requiere codificación)
Agregar permisos de la aplicación
Instale su aplicación en su espacio de trabajo
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 utilizar las actividades de Slack, puedes crear una sencilla aplicación de espacio de trabajo único. Los pasos y el ejemplo a continuación asumen que tienes y eres miembro de un espacio de trabajo existente.

Inicia sesión en tu espacio de trabajo de Slack o abre la aplicación de escritorio de Slack.
- Si inicias sesión con la URL anterior, necesitarás la URL de Slack de tu espacio de trabajo.
Ve a Tus aplicaciones y haz clic en el botón Crear nueva aplicación .
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 tu aplicación se realiza mediante ámbitos. Los ámbitos definen los métodos de la 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.

En la navegación de la izquierda, haga clic en OAuth y permisos.
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.
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.

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 .
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

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.
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.

En esta página