Cómo integrar Publicaciones y Grupos con Slack
  • Identificarse

    • Cómo integrar Publicaciones y Grupos con Slack

    Cómo integrar Publicaciones y Grupos con SlackRequisitos PreviosPaso 1: Crear la aplicación en Slack y obtener el Token de AutorizaciónPaso 2: Obtener el ID del Canal de SlackPaso 3: Configurar la integración en RankmiPaso 4: Invitar tu App al canal de SlackPreguntas Frecuentes

    Integra tus Publicaciones de Rankmi con Slack para que cada nueva publicación se notifique automáticamente en el canal que elijas. Esto aumenta la visibilidad de tus comunicaciones y mantiene a tus equipos informados en la herramienta que ya utilizan a diario.

    Requisitos Previos

    Antes de comenzar, asegúrate de cumplir con el siguiente requisito:

    • Debes ser Administrador del espacio de trabajo (workspace) de Slack de tu empresa. Solo este rol tiene los permisos necesarios para crear e instalar una nueva aplicación.

    Paso 1: Crear la aplicación en Slack y obtener el Token de Autorización

    El primer paso es crear una aplicación dentro de Slack que actuará como un bot para publicar los mensajes de Rankmi.

    1. Ve a la página de aplicaciones de Slack en https://api.slack.com/apps y haz clic en Create New App.
    2. En la ventana que aparece, selecciona la opción From a manifest.
    3. Elige el espacio de trabajo (workspace) de tu empresa y haz clic en Next.
    4. Verás un código en formato YAML. Bórralo y pega el siguiente código en su lugar:
      display_information:
  name: Rankmi Publicaciones
features:
  bot_user:
    display_name: Rankmi Publicaciones
    always_online: false
oauth_config:
  scopes:
    bot:
      - chat:write
settings:
  org_deploy_enabled: false
  socket_mode_enabled: false
  token_rotation_enabled: false
    5. Puedes cambiar el nombre Rankmi Publicaciones por el nombre que prefieras para tu bot. Es importante que recuerdes este nombre para un paso posterior. Haz clic en Next.
    6. Revisa el resumen y haz clic en Create.
    7. En el menú lateral izquierdo, ve a OAuth & Permissions.
    8. Pantalla de permisos de la API de Slack con el menú lateral resaltado.
    9. En la sección OAuth Tokens for Your Workspace, haz clic en Install to Workspace.
    10. Confirma los permisos haciendo clic en Allow.
    11. Una vez instalada, la página te mostrará el Bot User OAuth Token. Cópialo, ya que lo necesitarás en Rankmi. Debería comenzar con xoxb-.

    Paso 2: Obtener el ID del Canal de Slack

    Ahora necesitas el identificador único del canal donde se publicarán las notificaciones.

    1. En tu aplicación de escritorio de Slack, haz clic con el botón derecho sobre el nombre del canal que deseas usar.
    2. Selecciona Copiar y luego Copiar enlace.
    3. Pega el enlace en un editor de texto. El ID del canal es la serie de caracteres que comienza con C y se encuentra al final de la URL. Por ejemplo, en https://tuempresa.slack.com/archives/C0123ABC456, el ID es C0123ABC456.
    4. Copia únicamente ese ID.

    Menú contextual de un canal de Slack con la opción 'Copiar enlace' resaltada.

    Paso 3: Configurar la integración en Rankmi

    Con los dos códigos listos, es momento de configurar la conexión en Rankmi.

    1. En Rankmi, dirígete a Administración > Aplicaciones > Publicaciones y Grupos.
    2. Ve a la pestaña Integraciones.
    3. Verás un listado de tus grupos. Pega el Token de Autorización (el que empieza con xoxb-) y el ID del Canal en los campos correspondientes para el grupo que deseas conectar.

    Paso 4: Invitar tu App al canal de Slack

    El último paso es darle permiso a tu nueva aplicación para que pueda escribir en el canal.

    1. Regresa al canal de Slack que configuraste.
    2. Escribe el siguiente comando en la caja de mensajes: /invite @[nombre de tu app]
    3. Importante: Reemplaza [nombre de tu app] por el nombre exacto que le diste a tu aplicación en el Paso 1. Presiona Enter.
    4. Recibirás una confirmación de que el bot se ha unido al canal. ¡Listo! A partir de ahora, las nuevas publicaciones en tu grupo de Rankmi se notificarán en este canal.

    Preguntas Frecuentes

    P: ¿Puedo realizar esta integración si no soy administrador del workspace de Slack? 

    R: No, la creación de la aplicación en Slack y la obtención del token de autorización debe ser realizada por un usuario con permisos de Administrador del espacio de trabajo (workspace).

    P: La integración está configurada, pero las publicaciones no aparecen en Slack. ¿Qué puedo revisar? 

    R: Asegúrate de haber invitado correctamente a tu aplicación (el bot que creaste) al canal de Slack usando el comando /invite @nombre-del-bot. Sin esta invitación, la aplicación no tiene permiso para publicar mensajes.