Actividad Enviar Mensaje de Slack
Introducción
Una actividad de Slack Enviar Mensaje, utilizando su conexión de Slack, envía un mensaje a un usuario, múltiples usuarios, una conversación o un canal en Slack y está destinada a ser utilizada como un objetivo para consumir datos en una operación.
Crear una actividad Enviar Mensaje de Slack
Una instancia de una actividad de Slack Enviar Mensaje se crea a partir de una conexión de Slack utilizando su tipo de actividad Enviar Mensaje.
Para crear una instancia de una actividad, arrastra el tipo de actividad al lienzo de diseño o copia el tipo de actividad y pégalo en el lienzo de diseño. Para más detalles, consulta Crear una instancia de actividad o herramienta en Reutilización de componentes.
Una actividad existente de Slack Enviar Mensaje se puede editar desde estas ubicaciones:
- El lienzo de diseño (consulta Menú de acciones de componentes en Lienzo de diseño).
- La pestaña Componentes del panel del proyecto (consulta Menú de acciones de componentes en Pestaña de componentes del panel del proyecto).
Configurar una actividad Enviar Mensaje de Slack
Sigue estos pasos para configurar una actividad de Slack Enviar Mensaje:
-
Paso 1: Ingresa un nombre y configura el enrutamiento del mensaje
Proporciona un nombre para la actividad y configura cómo se enrutará el mensaje. -
Paso 2: Configura los destinatarios del mensaje
Elige cómo especificar los destinatarios del mensaje y selecciona los usuarios o la conversación que recibirán el mensaje. -
Paso 3: Configura el contenido del mensaje
Proporciona el contenido del mensaje a enviar. -
Paso 4: Revisar los esquemas de datos
Se muestran los esquemas de solicitud o respuesta.
Paso 1: Ingrese un nombre y configure el enrutamiento de mensajes
En este paso, proporcione un nombre para la actividad y configure cómo se enrutará los mensajes a los destinatarios. Cada elemento de la interfaz de usuario de este paso se describe a continuación.
-
Menú de endpoint: Si tiene múltiples endpoints del mismo tipo de conector configurados, un menú en la parte superior de la pantalla muestra el nombre del endpoint actual. Haga clic en el menú para cambiar a un endpoint diferente. Para más información, consulte Cambiar el endpoint asignado en Pantallas de configuración.
- Editar endpoint: Aparece cuando pasa el cursor sobre el nombre del endpoint actual. Haga clic para editar la configuración de conexión del endpoint seleccionado actualmente.
-
Nombre: Ingrese un nombre para identificar la actividad. El nombre debe ser único para cada actividad de Slack Enviar Mensaje y no debe contener barras diagonales
/ni dos puntos:. -
Tipo de mensaje: Seleccione cómo enrutará el mensaje:
-
Directo o Multi-Persona: Enviar un mensaje directo a un usuario o un mensaje directo grupal a múltiples usuarios (hasta 8).
-
Canal: Enviar un mensaje a un canal de Slack existente.
-
-
Tipo de conversación: Este campo aparece cuando selecciona Directo o Multi-Persona para el Tipo de mensaje. Seleccione cómo desea identificar o crear la conversación:
-
Crear Nueva Conversación: Crear una nueva conversación de mensaje directo o mensaje directo grupal.
-
Seleccionar Conversación Existente: Seleccionar de conversaciones existentes.
-
-
Siguiente: Haga clic para almacenar temporalmente la configuración de este paso y continuar al siguiente paso. La configuración no se guardará hasta que haga clic en el botón Finalizado en el último paso.
-
Descartar Cambios: Después de realizar cambios, haga clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje le pide que confirme que desea descartar los cambios.
Paso 2: Configurar destinatarios de mensajes
En este paso, elige cómo especificar los destinatarios del mensaje. La interfaz mostrada depende del tipo de selección que elijas y de las selecciones realizadas en el Paso 1.
-
Tipo de selección de mensajes/canales directos: Selecciona cómo especificar los destinatarios para tu mensaje:
-
Informar Manualmente: Ingresa manualmente el ID de la conversación o el ID del canal.
-
Seleccionar de la Lista: Selecciona destinatarios de una lista de usuarios, conversaciones o canales disponibles.
-
Omitir: Omitir la selección de destinatarios en este paso y proporcionar la información del destinatario a través de una transformación. Cuando seleccionas esta opción, mapea los IDs de usuario de Slack al nodo
usersen el esquema de solicitud.Para obtener los IDs de usuario, configura una actividad de Usuarios de Slack con el tipo de objeto Lista de Usuarios, ejecuta la operación y recupera los IDs de usuario del payload de respuesta. Luego puedes usar estos IDs de usuario en tu transformación para especificar los destinatarios del mensaje.
-
-
Atrás: Haz clic para almacenar temporalmente la configuración de este paso y regresar al paso anterior.
-
Siguiente: Haz clic para almacenar temporalmente la configuración de este paso y continuar al siguiente paso. La configuración no se guardará hasta que hagas clic en el botón Finalizado en el último paso.
-
Descartar Cambios: Después de realizar cambios, haz clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje te pedirá que confirmes que deseas descartar los cambios.
Informar Manualmente
Cuando seleccionas Informar Manualmente, puedes ingresar directamente el identificador de la conversación o del canal.
-
Informar ID de conversación/ID de canal: Ingresa el ID de la conversación o el ID del canal donde deseas enviar el mensaje. El formato del ID depende de tu selección de tipo de mensaje del Paso 1:
- Para mensajes directos o de varias personas, ingresa un ID de conversación.
- Para mensajes de canal, ingresa un ID de canal.
Seleccionar de la lista
Cuando seleccionas Seleccionar de la lista, la interfaz muestra opciones para seleccionar destinatarios según el tipo de mensaje y las selecciones de tipo de conversación del Paso 1.
Crear una nueva conversación directa o de múltiples personas
Cuando configuras Tipo de mensaje a Directo o de múltiples personas y Tipo de conversación a Crear nueva conversación en el Paso 1, selecciona hasta 8 usuarios para crear una nueva conversación.
-
Lista de usuarios (Selecciona de 1 a 8): Selecciona los usuarios que se incluirán en la nueva conversación.
-
Usuarios disponibles: Lista todos los usuarios disponibles en tu espacio de trabajo de Slack. Usa el cuadro de búsqueda para filtrar la lista ingresando un nombre de usuario. Haz clic en el ícono de para recargar la lista de usuarios desde Slack.
-
Usuarios seleccionados: Muestra los usuarios que han sido seleccionados para ser incluidos en la conversación. Usa los botones de flecha para mover usuarios entre las listas de Usuarios disponibles y Usuarios seleccionados.
-
Haz clic en la flecha derecha para agregar un usuario seleccionado de la lista de Usuarios disponibles a la lista de Usuarios seleccionados.
-
Haz clic en la flecha izquierda para eliminar un usuario seleccionado de la lista de Usuarios seleccionados.
-
-
Seleccionar una conversación existente
Cuando configuras Tipo de mensaje a Directo o de múltiples personas y Tipo de conversación a Seleccionar conversación existente en el Paso 1, selecciona una conversación existente.
-
Seleccionar chat existente: Elige la conversación existente donde se enviará el mensaje. Usa el cuadro de búsqueda para filtrar la lista de conversaciones. Haz clic en el ícono de para recargar las conversaciones desde Slack.
-
Chat seleccionado: Después de seleccionar una conversación, se lista aquí.
-
Buscar: Ingresa cualquier valor de columna en el cuadro de búsqueda para filtrar la lista de conversaciones. La búsqueda no distingue entre mayúsculas y minúsculas. Si las conversaciones ya se muestran en la tabla, los resultados de la tabla se filtran en tiempo real con cada pulsación de tecla. Para recargar las conversaciones desde el endpoint al buscar, ingresa los criterios de búsqueda y luego actualiza, como se describe a continuación.
-
Actualizar: Haz clic en el ícono de actualización o en la palabra Actualizar para recargar las conversaciones desde el punto final de Slack. Esto puede ser útil si se han agregado conversaciones a Slack. Esta acción actualiza todos los metadatos utilizados para construir la tabla de conversaciones que se muestra en la configuración.
-
Seleccionar una conversación: Dentro de la tabla, haz clic en cualquier parte de una fila para seleccionar una conversación. Solo se puede seleccionar una conversación. La información disponible para cada conversación se obtiene del punto final de Slack.
Consejo
Si la tabla no se llena con las conversaciones disponibles, la conexión de Slack puede no haber sido exitosa. Asegúrate de estar conectado volviendo a abrir la conexión y volviendo a probar las credenciales.
-
Seleccionar un canal
Cuando configures Tipo de Mensaje a Canal en el Paso 1, selecciona un canal existente.
-
Seleccionar Canal de Slack: Elige el canal de Slack donde se enviará el mensaje. Usa el cuadro de búsqueda para filtrar la lista de canales. Haz clic en el ícono de actualización para recargar los canales desde Slack.
-
Canal de Slack Seleccionado: Después de seleccionar un canal de Slack, se listará aquí.
-
Buscar: Ingresa el valor de cualquier columna en el cuadro de búsqueda para filtrar la lista de canales. La búsqueda no distingue entre mayúsculas y minúsculas. Si los canales ya se muestran en la tabla, los resultados de la tabla se filtran en tiempo real con cada pulsación de tecla. Para recargar los canales desde el punto final al buscar, ingresa los criterios de búsqueda y luego actualiza, como se describe a continuación.
-
Actualizar: Haz clic en el ícono de actualización o en la palabra Actualizar para recargar los canales desde el punto final de Slack. Esto puede ser útil si se han agregado canales a Slack. Esta acción actualiza todos los metadatos utilizados para construir la tabla de canales que se muestra en la configuración.
-
Seleccionar un canal de Slack: Dentro de la tabla, haz clic en cualquier parte de una fila para seleccionar un canal de Slack. Solo se puede seleccionar un canal de Slack. La información disponible para cada canal de Slack se obtiene del punto final de Slack.
Consejo
Si la tabla no se llena con los canales disponibles, la conexión de Slack puede no haber sido exitosa. Asegúrate de estar conectado volviendo a abrir la conexión y volviendo a probar las credenciales.
-
Paso 3: Configura el contenido del mensaje
En este paso, proporciona el contenido del mensaje a enviar. Cada elemento de la interfaz de usuario de este paso se describe a continuación.
-
Message content: Ingresa el contenido de texto del mensaje a enviar a los destinatarios seleccionados. Este campo admite texto sin formato y formato Markdown de Slack.
-
Continue on error: Selecciona continuar la ejecución de la actividad si se encuentra un error para un conjunto de datos en una solicitud por lotes. Si se encuentran errores, se escriben en el registro de operaciones.
-
Back: Haz clic para almacenar temporalmente la configuración de este paso y regresar al paso anterior.
-
Next: Haz clic para almacenar temporalmente la configuración de este paso y continuar al siguiente paso. La configuración no se guardará hasta que hagas clic en el botón Finalizado en el último paso.
-
Discard Changes: Después de realizar cambios, haz clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje te pedirá que confirmes que deseas descartar los cambios.
Paso 4: Revisar los esquemas de datos
Se muestran los esquemas de solicitud o respuesta. Cada elemento de la interfaz de usuario de este paso se describe a continuación.
-
Data Schemas: Estos esquemas de datos son heredados por transformaciones adyacentes y se muestran nuevamente durante el mapeo de transformación.
Nota
Los datos suministrados en una transformación tienen prioridad sobre la configuración de la actividad.
El conector de Slack utiliza la API REST de Slack. Consulta la documentación de la API para obtener información sobre los nodos y campos del esquema.
-
Refresh: Haz clic en el ícono de refresco o en la palabra Refrescar para regenerar esquemas desde el punto final de Slack. Esta acción también regenera un esquema en otras ubicaciones a lo largo del proyecto donde se hace referencia al mismo esquema, como en una transformación adyacente.
-
Atrás: Haz clic para almacenar temporalmente la configuración de este paso y regresar al paso anterior.
-
Terminado: Haz clic para guardar la configuración de todos los pasos y cerrar la configuración de la actividad.
-
Descartar Cambios: Después de realizar cambios, haz clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje te pide que confirmes que deseas descartar los cambios.
Siguientes pasos
Después de configurar una actividad de Slack Enviar Mensaje, completa la configuración de la operación agregando y configurando otras actividades o herramientas como pasos de la operación. También puedes configurar los ajustes de la operación, que incluyen la capacidad de encadenar operaciones que están en los mismos o diferentes flujos de trabajo.
Las acciones del menú para una actividad son accesibles desde el panel del proyecto y el lienzo de diseño. Para más detalles, consulta el menú de acciones de actividad en Conceptos básicos de conectores.
Las actividades de Slack Enviar Mensaje se pueden usar como un objetivo con estos patrones de operación:
- Patrón de transformación
- Patrón de dos transformaciones (como el primer o segundo objetivo)
Para usar la actividad con funciones de scripting, escribe los datos en una ubicación temporal y luego usa esa ubicación temporal en la función de scripting.
Cuando estés listo, despliega y ejecuta la operación y valida el comportamiento revisando los registros de operación.