Introducción
El conector de Slack está disponible para ser descargado en el Connectors Xchange de Bizagi.
Con este conector usted puede conectar sus procesos de Bizagi a una cuenta de www.slack.com para usar los servicios de mensajería de Slack.
Para mayor información sobre las funcionalidades de este conector, visite el Connectors Xchange.
|
Este conector se encuentra actualmente en versión Beta. Úselo en ambientes de producción bajo su propio riesgo. |
Antes de empezar
Para probar y usar este conector, usted necesita:
1.Bizagi Studio previamente instalado.
2.Este conector previamente instalado, a través del Connectors Xchange como se describe en https://help.bizagi.com/platform/en/index.html?Connectors_Xchange.htm, o por medio de una instalación manual como se describe en https://help.bizagi.com/platform/es/index.html?connectors_setup.htm.
3.Un workspace en www.slack.com.
4.Navegar a https://api.slack.com/docs/token-types y revisar qué tipo de token se ajusta a sus necesidades. Le recomendamos usar User tokens pues le permiten trabajar directamente en nombre de usuarios.
5.Ir a https://api.slack.com/apps y crear una app en Slack.
6.Llenar todos los detalles que se piden y hacer clic en Crear app.
7.Ir a OAuth & Permissions.
8.En caso de que sea una app de Usuario, habilite estas configuraciones.
9.Si es una app de workspace, habilite estas configuraciones.
10. Haga clic en Instalar app al workspace.
11. Copie y guarde el token para usarlo en la configuración del conector en Bizagi.
Configurar el conector
Para configurar el conector (por ejemplo sus parámetros de autenticación), siga estos pasos presentados en el capítulo de configuración en https://help.bizagi.com/platform/es/index.html?connectors_setup.htm.
Para esta configuración, tenga en cuenta los siguientes parámetros de autenticación:
•Authentication method: Custom.
•Token: El token obtenido en el procedimiento previo. Le permite usar los servicios del API de Slack de su app.
Usar el conector
Este conector cuenta con un conjunto de métodos disponibles del API de servicios de Slack.
Para aprender cómo y en dónde configurar el uso de un conector, refiérase a https://help.bizagi.com/platform/en/index.html?Connectors_Studio.htm.
Al usar el conector, asegúrese de considerar los siguientes detalles para cada uno de los métodos disponibles.
Completar recordatorio (Complete reminder)
Marca un recordatorio como completado.
Para configurar las entradas considere:
•Reminder: ID del recordatorio que desea marcar como completado. Este parámetro es requerido para una invocación exitosa del servicio.
Para configurar las salidas considere mapear:
Eliminar recordatorio (Delete reminder)
Elimina un recordatorio existente.
Para configurar las entradas considere:
•Reminder: ID del recordatorio que desea eliminar. Este parámetro es requerido para una invocación exitosa del servicio.
Para configurar las salidas considere mapear:
Crear recordatorio (Create reminder)
Crea un nuevo recordatorio.
Para configurar las entradas considere:
•Text: Contenido del recordatorio. Este parámetro es requerido para una invocación exitosa del servicio.
•Time: Cuándo debe ocurrir el recordatorio, expresado en formato de fecha Unix. Este parámetro es requerido para una invocación exitosa del servicio.
•User: ID del usuario que recibirá el recordatorio.
Para configurar las salidas considere mapear:
Obtener lista de recordatorios (Get reminder list)
Obtener una lista de recordatorios.
Para configurar las salidas considere mapear:
Obtener mensajes de conversación (Get conversation messages)
Obtener los mensajes de una conversación.
Para configurar las entradas considere:
•Channel: ID del canal del que desea obtener los mensajes. Este parámetro es requerido para una invocación exitosa del servicio.
Para configurar las salidas considere mapear:
Obtener miembros de conversación (Get conversation members)
Obtener la lista de miembros de una conversación específica.
Para configurar las entradas considere:
•Channel: ID del canal del que desea obtener la lista de usuarios. Este parámetro es requerido para una invocación exitosa del servicio.
Para configurar las salidas considere mapear:
Desarchivar conversación (Unarchive conversation)
Pone disponible una conversación previamente archivada.
Para configurar las entradas considere:
•Channel: ID del canal que desea desarchivar. Este parámetro es requerido para una invocación exitosa del servicio.
Para configurar las salidas considere mapear:
Archivar conversación (Archive conversation)
Archiva una conversación, es decir que la marca para que no se puedan enviar mas mensajes en ella.
Para configurar las entradas considere:
•Channel: ID del canal que desea archivar. Este parámetro es requerido para una invocación exitosa del servicio.
Para configurar las salidas considere mapear:
Crear conversación (Create conversation)
Crear un canal público o privado.
Para configurar las entradas considere:
•Name: Nombre del canal (solo acepta letras en minúscula). Este parámetro es requerido para una invocación exitosa del servicio.
•User_ids: IDs separados por comas de los usuarios a incluir en el canal.
•Is_private: Valor booleano que indica si el canal es privado o no.
Para configurar las salidas considere mapear:
Obtener lista de conversaciones internas (Get list of internal conversations)
Obtener la lista de todas las conversaciones internas.
Para configurar las salidas considere mapear:
Obtener lista de conversaciones internas multiparte (Get list of multipart internal conversations)
Obtener todas las conversaciones internas multiparte.
Para configurar las salidas considere mapear:
Obtener lista de conversaciones privadas (Get list of private conversations)
Obtener todas las conversaciones privadas.
Para configurar las salidas considere mapear:
Obtener lista de conversaciones públicas (Get list of public conversations)
Obtener todas las conversaciones públicas.
Para configurar las salidas considere mapear:
Invitar usuarios a una conversación (Invite users to conversation)
Invitar usuarios a una conversación en específico.
Para configurar las entradas considere:
•Channel: ID del canal al que desea invitar a los usuarios. Este parámetro es requerido para una invocación exitosa del servicio.
•User_ids: IDs separados por comas de los usuarios a ser invitados a la conversación. Este parámetro es requerido para una invocación exitosa del servicio.
Para configurar las salidas considere mapear:
Renombrar conversación (Rename conversation)
Cambiar el nombre de una conversación.
Para configurar las entradas considere:
•Channel: ID del canal cuyo nombre desea cambiar. Este parámetro es requerido para una invocación exitosa del servicio.
•Name: Nuevo nombre de la conversación (solo acepta letras en minúscula). Este parámetro es requerido para una invocación exitosa del servicio.
Para configurar las salidas considere mapear:
Establecer propósito de la conversación (Set conversation purpose)
Establecer el propósito a una conversación específica.
Para configurar las entradas considere:
•Channel: ID del canal al que le quiere establecer un propósito. Este parámetro es requerido para una invocación exitosa del servicio.
•Purpose: Propósito para la conversación. Este parámetro es requerido para una invocación exitosa del servicio.
Para configurar las salidas considere mapear:
Establecer tema a una conversación (Set conversation topic)
Establecer el tema a una conversación específica.
Para configurar las entradas considere:
•Channel: ID del canal cuyo tema desea establecer. Este parámetro es requerido para una invocación exitosa del servicio.
•Topic: Tema para la conversación. Este parámetro es requerido para una invocación exitosa del servicio.
Para configurar las salidas considere mapear:
Eliminar archivo (Delete file)
Eliminar un archivo en particular.
Para configurar las entradas considere:
•File: ID del archivo a eliminar. Este parámetro es requerido para una invocación exitosa del servicio.
Para configurar las salidas considere mapear:
Obtener lista de archivos (Get file list)
Obtener la lista de todos los archivos.
Para configurar las entradas considere:
•Channel: ID del canal cuyos archivos se desean obtener. Este parámetro es requerido para una invocación exitosa del servicio.
Para configurar las salidas considere mapear:
Cargar archivo (Upload file)
Cargar un archivo a varios canales.
Para configurar las entradas considere:
•Channels: IDs separados por comas de los canales a los que desea cargar el archivo. Este parámetro es requerido para una invocación exitosa del servicio.
•filename: Nombre del ajunto. Este parámetro es requerido para una invocación exitosa del servicio.
•file: Archivo en base64 a cargar. Este parámetro es requerido para una invocación exitosa del servicio.
•title: Título del archivo.
•token: de proveerlo, el archivo es cargado en nombre de la persona a la que corresponde el token.
Para configurar las salidas considere mapear:
Eliminar mensaje (Delete message)
Eliminar un mensaje.
Para configurar las entradas considere:
•Channel: ID del canal en donde se encuentra el mensaje que desea eliminar. Este parámetro es requerido para una invocación exitosa del servicio.
•TS: Fecha y hora del mensaje que desea eliminar. Este parámetro es requerido para una invocación exitosa del servicio.
Para configurar las salidas considere mapear:
Obtener mensajes de conversación (Get conversation messages)
Obtener los mensajes de una conversación.
Para configurar las entradas considere:
•Channel: ID del canal cuyos mensajes desea obtener. Este parámetro es requerido para una invocación exitosa del servicio.
Para configurar las salidas considere mapear:
Enviar mensaje (Send message)
Enviar mensaje a un canal público o privado, en una conversación directa o canal de mensajería instantánea.
Para configurar las entradas considere:
•Channel: ID del canal al que desea mandar el mensaje. Este parámetro es requerido para una invocación exitosa del servicio.
•message: Texto del mensaje que desea enviar. Este parámetro es requerido para una invocación exitosa del servicio.
Para configurar las salidas considere mapear:
Actualizar mensaje (Update message)
Editar un mensaje que haya sido enviado a un canal.
Para configurar las entradas considere:
•Channel: ID del canal que contiene el mensaje que desea editar. Este parámetro es requerido para una invocación exitosa del servicio.
•ts: Fecha y hora del mensaje que desea editar. Este parámetro es requerido para una invocación exitosa del servicio.
•text: Nuevo texto para remplazar el mensaje original. Este parámetro es requerido para una invocación exitosa del servicio.
Para configurar las salidas considere mapear:
Obtener usuario por email (Get user by email)
Obtener un usuario por su dirección de correo.
Para configurar las entradas considere:
•email: email del usuario que desea obtener. Este parámetro es requerido para una invocación exitosa del servicio.
Para configurar las salidas considere mapear:
Obtener lista de usuarios (Get users list)
Obtener una lista de todos los usuarios.
Para configurar las salidas considere mapear:
Para más detalle sobre el uso y respuesta de los servicios, consulte la documentación oficial del API de Slack en https://api.slack.com/methods.
Last Updated 10/28/2022 3:38:21 PM