Skip to main content

​
Configuración básica

Puedes instalar la integración de Slack desde nuestro Marketplace. Una vez instalada y autenticada mediante OAuth, podrás buscar contactos (miembros del workspace), enviar mensajes a canales o por DM, listar canales, consultar la información de un canal, crear canales e invitar miembros a un canal existente.

​
Funcionalidades

​
Buscar contactos (miembros de Slack)

Busca usuarios del workspace de Slack filtrando por nombre, display name o correo. Los correos se incluyen cuando están disponibles en el perfil. Inputs:
  • query (opcional, string) — Texto de búsqueda (nombres, correos, display name).
  • limit (opcional, number) — Máximo de usuarios a devolver (1–1000, por defecto 100).
Ejemplo: 
{
  "query": "ana.perez@empresa.com",
  "limit": 50
}

​
Enviar mensaje

Envía un mensaje a un canal o como DM. Puedes dirigirlo por channelId, por recipientUserId (ID de usuario de Slack) o por email (se abrirá DM con ese usuario). Soporta bloques y adjuntos. Inputs:
  • text (opcional, string) — Texto del mensaje.
  • channelId (opcional, string) — ID del canal (p. ej. C1234567890).
  • recipientUserId (opcional, string) — ID de usuario Slack para DM (p. ej. U1234567890).
  • email (opcional, string) — Correo del usuario para DM.
  • blocks (opcional, array de objeto) — Bloques de Slack (formato JSON).
  • attachments (opcional, array de objeto) — Adjuntos del mensaje (formato JSON).
  • thread_ts (opcional, string) — Timestamp de hilo para responder en un thread.
  • reply_broadcast (opcional, boolean) — Si se hace broadcast de la respuesta del hilo al canal (por defecto false).
  • mrkdwn (opcional, boolean) — Habilitar/deshabilitar Markdown (por defecto true).
Ejemplo: 
{
  "channelId": "C04567ABCD",
  "text": "Hola equipo, actualizamos el roadmap hoy a las 16:00.",
  "blocks": [
    {
      "type": "section",
      "text": {
        "type": "mrkdwn",
        "text": "*Recordatorio*: actualizamos el roadmap hoy a las 16:00."
      }
    }
  ],
  "attachments": [
    {
      "color": "#36a64f",
      "fields": [
        { "title": "Proyecto", "value": "Apollo", "short": true },
        { "title": "Estado", "value": "En curso", "short": true }
      ]
    }
  ],
  "thread_ts": "1731700000.123456",
  "reply_broadcast": false,
  "mrkdwn": true
}

​
Listar canales

Lista canales del workspace con opciones de filtro por tipo, exclusión de archivados y búsqueda parcial por nombre. Inputs:
  • types (opcional, array de string) — Tipos de canal: public_channel, private_channel, mpim, im (por defecto ["public_channel"]).
  • limit (opcional, number) — Máximo de canales a devolver (1–1000, por defecto 100).
  • excludeArchived (opcional, boolean) — Excluir canales archivados (por defecto true).
  • query (opcional, string) — Búsqueda por nombre (insensible a mayúsculas, coincidencia parcial).
Ejemplo: 
{
  "types": ["public_channel", "private_channel"],
  "limit": 200,
  "excludeArchived": true,
  "query": "support"
}

​
Obtener información de un canal

Obtiene la información detallada de un canal por su ID (nombre, topic, propósito, número de miembros, flags de privacidad/archivo, etc.). Inputs:
  • channel_id (string) — ID del canal de Slack (p. ej. C1234567890).
Ejemplo: 
{
  "channel_id": "C04567ABCD"
}

​
Crear canal

Crea un canal público o privado. El nombre se normaliza automáticamente (minúsculas, espacios a guiones, caracteres especiales removidos, máximo 80). Inputs:
  • name (string) — Nombre del canal (se normaliza).
  • is_private (boolean) — true para canal privado, false para público.
  • topic (opcional, string) — Topic del canal.
  • purpose (opcional, string) — Propósito del canal.
Ejemplo: 
{
  "name": "Proyecto Apollo 2025",
  "is_private": true,
  "topic": "Canal privado para coordinación del proyecto Apollo",
  "purpose": "Centralizar comunicación y decisiones del proyecto"
}

​
Invitar usuarios a un canal

Invita uno o varios usuarios a un canal existente. Requiere que el bot sea miembro del canal y tenga permisos adecuados. Inputs:
  • channel_id (string) — ID del canal de Slack (p. ej. C1234567890).
  • user_ids (array de string) — IDs de usuario a invitar (p. ej. ["U123", "U456"]).
Ejemplo: 
{
  "channel_id": "C04567ABCD",
  "user_ids": ["U111AAA222", "U333BBB444"]
}