Cómo utilizar App Connect con Slack
Slack es una aplicación de mensajería basada en web, en tiempo real y archivada, para tu equipo. Puedes comunicarte en canales abiertos o privados, enviar mensajes directos a tus compañeros y compartir archivos.
Versiones de productos y API compatibles
Para saber qué versiones de producto y API admite este conector, consulte Requisitos detallados del sistema en la página de asistencia IBM.
Conexión a Slack
Para conectar App Connect a una cuenta de Slack, consulte Conexión a Slack desde App Connect.
Lo primero que hay que tener en cuenta
- (Consideración general) Puede ver listas de los eventos y acciones desencadenantes que están disponibles en la página Aplicaciones y API del Diseñador de App Connect.
Para algunas aplicaciones, los eventos y acciones dependen del entorno y de si el conector admite eventos configurables y descubrimiento dinámico de acciones. Si la aplicación admite eventos configurables, verá un enlace Mostrar más eventos configurables bajo la lista de eventos. Si la aplicación admite la detección dinámica de acciones, verá un enlace Mostrar más debajo de la lista de acciones.
- (Consideración general) Si utiliza varias cuentas para una aplicación, el conjunto de campos que se muestra al seleccionar una acción para esa aplicación puede variar para las distintas cuentas. En el editor de flujo, algunas aplicaciones siempre proporcionan un conjunto curado de campos estáticos para una acción. Otras aplicaciones utilizan la detección dinámica para recuperar el conjunto de campos configurados en la instancia a la que está conectado. Por ejemplo, si tiene dos cuentas para dos instancias de una aplicación, la primera cuenta podría utilizar configuraciones listas para su uso inmediato. Sin embargo, la segunda cuenta puede estar configurada con campos personalizados adicionales.
- Antes de añadir algunos de los eventos o acciones de Slack a su flujo, asegúrese de que dispone de un espacio de trabajo de Slack. Si su equipo aún no utiliza Slack, puede empezar a utilizarlo (sin coste alguno) y crear un espacio de trabajo Slack en https://slack.com/intl/en-gb/get-started#/.
- Para utilizar la acción de nuevo mensaje en Slack como desencadenante del evento, configura la devolución de llamada del webhook URL que se muestra en la interfaz de usuario cuando seleccionas el evento Nuevo mensaje. Para configurar este webhook, cree un comando slash personalizado en Slack completando los siguientes pasos.
- Inicia sesión en Slack.
- Haz clic en la flecha situada junto al nombre de tu equipo y en . Alternativamente, haga clic en Añadir aplicaciones como se muestra en el siguiente ejemplo.
- En el campo Search App Directory, escriba slash commands
- Haga clic en Añadir configuración.
- Ingrese un nombre de comando de barra y luego haga clic en Agregar integración de comando de barra.
- En la sección Configuración de integración, actualice los siguientes campos con los siguientes detalles para crear un comando Slack Slash.
- En el campo URL pegue la llamada de retorno del webhook URL que aparece en App Connect.El siguiente ejemplo muestra una devolución de llamada de webhook URL en App Connect.
Nota: Un webhook URL está asociado a una cuenta. Por lo tanto, todos los flujos que utilizan esa cuenta tienen el mismo webhook URL y se activan cuando se produce un evento. - Seleccione el método POST. (Los datos se envían a su URL como un HTTP POST con una cabecera content-type establecida como application/x-www-form-urlencoded).
- Actualice los demás campos según sus necesidades.
- En el campo URL pegue la llamada de retorno del webhook URL que aparece en App Connect.
- Haga clic en Guardar integración.
Para probar su comando de barra personalizado, vaya a cualquier canal de Slack y escriba el comando de barra que ha creado. Si el comando se ejecuta correctamente, aparecerá un mensajeMessage publishedmensaje en Slack.
Eventos y acciones
Eventos de Slack
Estos eventos son para cambios en esta aplicación que desencadenan un flujo para empezar a completar las acciones en el flujo.
| Suceso | Descripción |
|---|---|
| Nuevo mensaje de comando de barra | Los comandos de barra son comandos de texto especiales que se escriben en el cuadro de entrada de mensajes para activar acciones específicas o interacciones con aplicaciones o integraciones de terceros |
Acciones de Slack
Su flujo completa estas acciones en esta aplicación.
| Objecto | Acción | Descripción |
|---|---|---|
| Canales | Crear canal | Crea un nuevo canal en Slack |
| Recuperar canales públicos | Recupera los canales públicos de Slack | |
| Mensajes directos | Recuperar mensajes directos | Recupera los mensajes directos de los canales de Slack |
| Archivos | Añadir archivo | Añade un nuevo archivo a Slack |
| Suprimir archivo | Elimina un archivo de Slack | |
| Recuperar archivos | Recupera los archivos de Slack | |
| Canales privados | Recuperar canales privados | Recupera los canales privados de Slack |
| Mensajes | Enviar mensaje | Se ha publicado un nuevo mensaje en Slack |
| Recuperar mensajes | Recupera los mensajes de Slack | |
| Mensajes directos a varias personas | Recuperar mensajes directos de varias personas | Recupera una lista de todos los mensajes directos multipartitos de los canales de Slack |
| Grupos de usuarios | Recuperar grupos de usuarios | Recupera una lista de grupos de usuarios del equipo en Slack |
| Actualizar grupo de usuarios | Actualiza las propiedades de un grupo de usuarios existente en Slack | |
| Usuarios | Recuperar usuarios | Recupera la información del usuario de Slack |
Ejemplos
Utilice plantillas para crear rápidamente flujos para Slack
Aprenda a utilizar App Connect para crear rápidamente flujos que completen acciones en Slack. Por ejemplo, ve a la página Descubrir y busca Slack.
