Slack es una plataforma de comunicación empresarial que ofrece a los equipos un lugar unificado para mensajería, herramientas y archivos.
Con Slack, puedes:
- Automatiza notificaciones de agentes: Envía actualizaciones en tiempo real desde tus agentes Aptlystar a cualquier canal de Slack
- Crea endpoints de webhook: Configura bots de Slack como webhooks para activar flujos de trabajo de Aptlystar desde actividades de Slack
- Mejora los flujos de trabajo de agentes: Integra mensajería de Slack en tus agentes para entregar resultados, alertas y actualizaciones de estado
- Crea y comparte lienzos de Slack: Genera programáticamente documentos colaborativos (lienzos) en canales de Slack
- Lee mensajes de canales: Recupera y procesa mensajes recientes de cualquier canal de Slack para monitoreo o activación de flujos de trabajo
- Gestiona mensajes de bot: Actualiza, elimina y añade reacciones a mensajes enviados por tu bot
En Aptlystar, la integración con Slack permite a tus agentes interactuar programáticamente con Slack con capacidades completas de gestión de mensajes como parte de sus flujos de trabajo:
- Enviar mensajes: Los agentes pueden enviar mensajes formateados a cualquier canal o usuario de Slack, compatible con la sintaxis mrkdwn de Slack para formato enriquecido
- Actualizar mensajes: Editar mensajes de bot enviados previamente para corregir información o proporcionar actualizaciones de estado
- Eliminar mensajes: Eliminar mensajes de bot cuando ya no son necesarios o contienen errores
- Añadir reacciones: Expresar sentimiento o reconocimiento añadiendo reacciones con emojis a cualquier mensaje
- Crear lienzos: Crear y compartir lienzos de Slack (documentos colaborativos) directamente en canales, permitiendo compartir contenido más rico y documentación
- Leer mensajes: Leer mensajes recientes de canales, permitiendo monitoreo, informes o activación de acciones adicionales basadas en la actividad del canal
- Descargar archivos: Recuperar archivos compartidos en canales de Slack para procesamiento o archivo
Esto permite escenarios de automatización potentes como enviar notificaciones con actualizaciones dinámicas, gestionar flujos conversacionales con mensajes de estado editables, reconocer mensajes importantes con reacciones y mantener canales limpios eliminando mensajes de bot obsoletos. Tus agentes pueden entregar información oportuna, actualizar mensajes a medida que avanzan los flujos de trabajo, crear documentos colaborativos o alertar a miembros del equipo cuando se necesita atención. Esta integración cierra la brecha entre tus flujos de trabajo de IA y la comunicación de tu equipo, asegurando que todos se mantengan informados con información precisa y actualizada. Al conectar Aptlystar con Slack, puedes crear agentes que mantengan a tu equipo actualizado con información relevante en el momento adecuado, mejorar la colaboración compartiendo y actualizando información automáticamente, y reducir la necesidad de actualizaciones manuales de estado, todo mientras aprovechas tu espacio de trabajo de Slack existente donde tu equipo ya se comunica.
Integra Slack en el flujo de trabajo. Puede enviar, actualizar y eliminar mensajes, crear lienzos, leer mensajes y añadir reacciones. Requiere Token de Bot en lugar de OAuth en modo avanzado. Se puede usar en modo de disparador para iniciar un flujo de trabajo cuando se envía un mensaje a un canal.
Envía mensajes a canales de Slack o mensajes directos. Compatible con el formato mrkdwn de Slack.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
authMethod | string | No | Método de autenticación: oauth o bot_token |
botToken | string | No | Token del bot para Bot personalizado |
channel | string | No | Canal de Slack objetivo (p. ej., #general) |
userId | string | No | ID de usuario de Slack objetivo para mensajes directos (p. ej., U1234567890) |
text | string | Sí | Texto del mensaje a enviar (admite formato mrkdwn de Slack) |
thread_ts | string | No | Marca de tiempo del hilo al que responder (crea respuesta en hilo) |
files | file[] | No | Archivos para adjuntar al mensaje |
| Parámetro | Tipo | Descripción |
|---|
message | object | Objeto de mensaje completo con todas las propiedades devueltas por Slack |
ts | string | Marca de tiempo del mensaje |
channel | string | ID del canal donde se envió el mensaje |
fileCount | number | Número de archivos subidos (cuando se adjuntan archivos) |
Crea y comparte lienzos de Slack en canales. Los lienzos son documentos colaborativos dentro de Slack.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
authMethod | string | No | Método de autenticación: oauth o bot_token |
botToken | string | No | Token del bot para Bot personalizado |
channel | string | Sí | Canal de Slack objetivo (p. ej., #general) |
title | string | Sí | Título del lienzo |
content | string | Sí | Contenido del lienzo en formato markdown |
document_content | object | No | Contenido estructurado del documento de lienzo |
| Parámetro | Tipo | Descripción |
|---|
canvas_id | string | ID del lienzo creado |
channel | string | Canal donde se creó el lienzo |
title | string | Título del lienzo |
Lee los últimos mensajes de los canales de Slack. Recupera el historial de conversaciones con opciones de filtrado.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
authMethod | string | No | Método de autenticación: oauth o bot_token |
botToken | string | No | Token del bot para Bot personalizado |
channel | string | No | Canal de Slack del que leer mensajes (p. ej., #general) |
userId | string | No | ID de usuario para conversación de mensaje directo (p. ej., U1234567890) |
limit | number | No | Número de mensajes a recuperar (predeterminado: 10, máx: 15) |
oldest | string | No | Inicio del rango de tiempo (marca de tiempo) |
latest | string | No | Fin del rango de tiempo (marca de tiempo) |
| Parámetro | Tipo | Descripción |
|---|
messages | array | Array de objetos de mensaje del canal |
Lista todos los canales en un espacio de trabajo de Slack. Devuelve los canales públicos y privados a los que el bot tiene acceso.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
authMethod | string | No | Método de autenticación: oauth o bot_token |
botToken | string | No | Token del bot para Bot personalizado |
includePrivate | boolean | No | Incluir canales privados de los que el bot es miembro (predeterminado: true) |
excludeArchived | boolean | No | Excluir canales archivados (predeterminado: true) |
limit | number | No | Número máximo de canales a devolver (predeterminado: 100, máx: 200) |
| Parámetro | Tipo | Descripción |
|---|
channels | array | Array de objetos de canal del espacio de trabajo |
Lista todos los miembros (IDs de usuario) en un canal de Slack. Úsalo con Obtener Información de Usuario para resolver IDs a nombres.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
authMethod | string | No | Método de autenticación: oauth o bot_token |
botToken | string | No | Token del bot para Bot personalizado |
channel | string | Sí | ID del canal del que listar miembros |
limit | number | No | Número máximo de miembros a devolver (predeterminado: 100, máx: 200) |
| Parámetro | Tipo | Descripción |
|---|
members | array | Array de IDs de usuario que son miembros del canal (p. ej., U1234567890) |
Lista todos los usuarios en un espacio de trabajo de Slack. Devuelve perfiles de usuario con nombres y avatares.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
authMethod | string | No | Método de autenticación: oauth o bot_token |
botToken | string | No | Token del bot para Bot personalizado |
includeDeleted | boolean | No | Incluir usuarios desactivados/eliminados (predeterminado: false) |
limit | number | No | Número máximo de usuarios a devolver (predeterminado: 100, máx: 200) |
| Parámetro | Tipo | Descripción |
|---|
users | array | Array de objetos de usuario del espacio de trabajo |
Obtiene información detallada sobre un usuario específico de Slack mediante su ID de usuario.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
authMethod | string | No | Método de autenticación: oauth o bot_token |
botToken | string | No | Token del bot para Bot personalizado |
userId | string | Sí | ID de usuario a buscar (p. ej., U1234567890) |
| Parámetro | Tipo | Descripción |
|---|
user | object | Información detallada del usuario |
Descargar un archivo de Slack
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
authMethod | string | No | Método de autenticación: oauth o bot_token |
botToken | string | No | Token del bot para Bot personalizado |
fileId | string | Sí | El ID del archivo a descargar |
fileName | string | No | Anulación opcional del nombre del archivo |
| Parámetro | Tipo | Descripción |
|---|
file | file | Archivo descargado almacenado en los archivos de ejecución |
Actualizar un mensaje enviado previamente por el bot en Slack
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
authMethod | string | No | Método de autenticación: oauth o bot_token |
botToken | string | No | Token del bot para Bot personalizado |
channel | string | Sí | ID del canal donde se publicó el mensaje (p. ej., C1234567890) |
timestamp | string | Sí | Marca de tiempo del mensaje a actualizar (p. ej., 1405894322.002768) |
text | string | Sí | Nuevo texto del mensaje (admite formato mrkdwn de Slack) |
| Parámetro | Tipo | Descripción |
|---|
message | object | Objeto de mensaje actualizado completo con todas las propiedades devueltas por Slack |
content | string | Mensaje de éxito |
metadata | object | Metadatos del mensaje actualizado |
Eliminar un mensaje enviado previamente por el bot en Slack
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
authMethod | string | No | Método de autenticación: oauth o bot_token |
botToken | string | No | Token del bot para Bot personalizado |
channel | string | Sí | ID del canal donde se publicó el mensaje (p. ej., C1234567890) |
timestamp | string | Sí | Marca de tiempo del mensaje a eliminar (p. ej., 1405894322.002768) |
| Parámetro | Tipo | Descripción |
|---|
content | string | Mensaje de éxito |
metadata | object | Metadatos del mensaje eliminado |
Añadir una reacción emoji a un mensaje de Slack
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
authMethod | string | No | Método de autenticación: oauth o bot_token |
botToken | string | No | Token del bot para Bot personalizado |
channel | string | Sí | ID del canal donde se publicó el mensaje (p. ej., C1234567890) |
timestamp | string | Sí | Marca de tiempo del mensaje al que reaccionar (p. ej., 1405894322.002768) |
name | string | Sí | Nombre de la reacción emoji (sin dos puntos, p. ej., thumbsup, heart, eyes) |
| Parámetro | Tipo | Descripción |
|---|
content | string | Mensaje de éxito |
metadata | object | Metadatos de la reacción |
- Categoría:
tools
- Tipo:
slack
Actualizar un mensaje enviado previamente por el bot en Slack
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
authMethod | string | No | Método de autenticación: oauth o bot_token |
botToken | string | No | Token del bot para bot personalizado |
channel | string | Sí | ID del canal donde se publicó el mensaje (p. ej., C1234567890) |
timestamp | string | Sí | Marca de tiempo del mensaje a actualizar (p. ej., 1405894322.002768) |
text | string | Sí | Nuevo texto del mensaje (admite formato mrkdwn de Slack) |
| Parámetro | Tipo | Descripción |
|---|
message | object | Objeto completo del mensaje actualizado con todas las propiedades devueltas por Slack |
↳ type | string | Tipo de mensaje (normalmente "message") |
↳ ts | string | Marca de tiempo del mensaje (identificador único) |
↳ text | string | Contenido de texto del mensaje |
↳ user | string | ID del usuario que envió el mensaje |
↳ bot_id | string | ID del bot si fue enviado por un bot |
↳ username | string | Nombre de usuario mostrado |
↳ channel | string | ID del canal |
↳ team | string | ID del equipo/espacio de trabajo |
↳ thread_ts | string | Marca de tiempo del mensaje padre (para respuestas en hilo) |
↳ parent_user_id | string | ID del usuario autor del mensaje padre del hilo |
↳ reply_count | number | Número total de respuestas en el hilo |
↳ reply_users_count | number | Número de usuarios únicos que respondieron |
↳ latest_reply | string | Marca de tiempo de la respuesta más reciente |
↳ subscribed | boolean | Si el usuario está suscrito al hilo |
↳ last_read | string | Marca de tiempo del último mensaje leído |
↳ unread_count | number | Número de mensajes no leídos en el hilo |
↳ subtype | string | Subtipo de mensaje (bot_message, file_share, etc.) |
↳ is_starred | boolean | Si el mensaje está marcado con estrella por el usuario |
↳ pinned_to | array | IDs de canales donde el mensaje está fijado |
↳ permalink | string | URL permanente al mensaje |
↳ reactions | array | Reacciones en este mensaje |
↳ name | string | Nombre del emoji (sin dos puntos) |
↳ count | number | Número de veces que se añadió esta reacción |
↳ users | array | Array de IDs de usuarios que reaccionaron |
↳ files | array | Archivos adjuntos al mensaje |
↳ id | string | Identificador único del archivo |
↳ name | string | Nombre del archivo |
↳ mimetype | string | Tipo MIME del archivo |
↳ size | number | Tamaño del archivo en bytes |
↳ url_private | string | URL de descarga privada (requiere autenticación) |
↳ permalink | string | Enlace permanente al archivo |
↳ mode | string | Modo del archivo (hosted, external, etc.) |
↳ attachments | array | Adjuntos heredados en el mensaje |
↳ id | number | ID del adjunto |
↳ fallback | string | Resumen en texto plano |
↳ text | string | Texto principal del adjunto |
↳ pretext | string | Texto mostrado antes del adjunto |
↳ color | string | Código hexadecimal de la barra de color o preestablecido |
↳ author_name | string | Nombre mostrado del autor |
↳ author_link | string | URL del enlace del autor |
↳ author_icon | string | URL del icono del autor |
↳ title | string | Título del adjunto |
↳ title_link | string | URL del enlace del título |
↳ image_url | string | URL de la imagen |
↳ thumb_url | string | URL de la miniatura |
↳ footer | string | Texto del pie de página |
↳ footer_icon | string | URL del icono del pie de página |
↳ ts | string | Marca de tiempo mostrada en el pie de página |
↳ blocks | array | Bloques de Block Kit en el mensaje |
↳ type | string | Tipo de bloque (section, divider, image, actions, etc.) |
↳ block_id | string | Identificador único del bloque |
↳ edited | object | Información de edición si el mensaje fue editado |
↳ user | string | ID del usuario que editó el mensaje |
↳ ts | string | Marca de tiempo de la edición |
content | string | Mensaje de éxito |
metadata | object | Metadatos del mensaje actualizado |
↳ channel | string | ID del canal |
↳ timestamp | string | Marca de tiempo del mensaje |
↳ text | string | Texto del mensaje actualizado |
Eliminar un mensaje enviado previamente por el bot en Slack
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
authMethod | string | No | Método de autenticación: oauth o bot_token |
botToken | string | No | Token del bot para bot personalizado |
channel | string | Sí | ID del canal donde se publicó el mensaje (p. ej., C1234567890) |
timestamp | string | Sí | Marca de tiempo del mensaje a eliminar (p. ej., 1405894322.002768) |
| Parámetro | Tipo | Descripción |
|---|
content | string | Mensaje de éxito |
metadata | object | Metadatos del mensaje eliminado |
↳ channel | string | ID del canal |
↳ timestamp | string | Marca de tiempo del mensaje |
Añadir una reacción emoji a un mensaje de Slack
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
authMethod | string | No | Método de autenticación: oauth o bot_token |
botToken | string | No | Token del bot para bot personalizado |
channel | string | Sí | ID del canal donde se publicó el mensaje (p. ej., C1234567890) |
timestamp | string | Sí | Marca de tiempo del mensaje al que reaccionar (p. ej., 1405894322.002768) |
name | string | Sí | Nombre de la reacción emoji (sin dos puntos, p. ej., thumbsup, heart, eyes) |
| Parámetro | Tipo | Descripción |
|---|
content | string | Mensaje de éxito |
metadata | object | Metadatos de la reacción |
↳ channel | string | ID del canal |
↳ timestamp | string | Marca de tiempo del mensaje |
↳ reaction | string | Nombre del emoji de reacción |
