Slack

Versión de integración: 23.0

Configura Slack para que funcione con Google Security Operations

Para configurar Slack para que funcione con Google SecOps, primero debes crear una app nueva:

  1. Ve a https://api.slack.com/ y haz clic en Start Building.

  2. Ingresa los parámetros Nombre de la app y Espacio de trabajo de Slack de desarrollo. Haz clic en Crear app.

    Crea un diálogo de la app de Slack

  3. Ve a la pestaña OAuth y permisos y desplázate hacia abajo hasta las secciones Alcances.

    Pestaña OAuth y permisos

  4. Agrega los siguientes permisos y alcances. Slack recomienda agregar permisos de token de OAuth para un bot, no permisos de usuario:

    • channels:history
    • channels:manage
    • channels:read
    • chat:write
    • files:write
    • groups:history
    • groups:write
    • groups:read
    • im:read
    • im:write
    • im:history
    • mpim:read
    • mpim:history
    • mpim:write
    • users:read
    • users:read.email

    Diálogo de Permission Scopes

  5. Para permitir la interactividad de la app en acciones como "Enviar mensaje interactivo" y "Esperar respuesta con webhook", agrega una URL de solicitud para tu app. Para obtener más información, consulta el documento Cómo controlar la interacción del usuario en tus apps de Slack disponible en la documentación de Slack.

  6. Desplázate hacia arriba y haz clic en Instalar aplicación en el lugar de trabajo.

    Ubicación del botón para instalar la app en Workspace

  7. Haz clic en Permitir.

    Configuración de acceso a los permisos de LabBot

  8. Copia uno de los tokens que se crearon, según si quieres usar un bot o un usuario.

  9. Configura la integración con uno de esos tokens.

Red

Función Puerto predeterminado Dirección Protocolo
API Valores múltiples Saliente apitoken

Configura la integración de Slack en Google SecOps

Si quieres obtener instrucciones detalladas para configurar una integración en Google SecOps, consulta Configura integraciones.

Parámetros de integración

Usa los siguientes parámetros para configurar la integración:

Nombre visible del parámetro Tipo Valor predeterminado Es obligatorio. Descripción
Nombre de la instancia String N/A No Nombre de la instancia para la que deseas configurar la integración.
Descripción String N/A No Es la descripción de la instancia.
Token de API String N/A Token de API generado en la consola de Slack.
Verificar SSL Casilla de verificación Desmarcado No Usa esta casilla de verificación si tu conexión de Slack requiere una verificación SSL (no está marcada de forma predeterminada).
Ejecutar de forma remota Casilla de verificación Desmarcado No Marca la casilla para ejecutar la integración configurada de forma remota. Una vez que se marca, aparece la opción para seleccionar al usuario remoto (agente).

Acciones

Hacer una pregunta

Descripción

Haz preguntas en Slack.

Parámetros

Nombre del parámetro Tipo Valor predeterminado Es obligatorio Descripción
Canal String N/A Canal de destino.
Pregunta String N/A Contenido de la pregunta.

Ejecutar en

Esta acción se ejecuta en todas las entidades.

Resultados de la acción

Resultado de secuencia de comandos
Nombre del resultado de la secuencia de comandos Opciones de valor Ejemplo
is_succeed Verdadero/Falso is_succeed:False
Resultado de JSON
N/A

Bloque de compilación

Descripción

Compila un bloque de mensajes de Slack según los criterios de entrada proporcionados. Esta acción crea un bloque con un webhook que se puede pasar más adelante a la acción "Enviar mensaje interactivo" para enviar un mensaje.

Parámetros

Nombre del parámetro Tipo Valor predeterminado Es obligatorio Descripción
Pregunta String N/A Especifica el texto de la pregunta que se agregará al bloque.
Botones de respuestas String N/A Especifica los botones de respuesta que se agregarán al bloque.
URL base de Siemplify String N/A Especifica la URL base del servidor de Google SecOps que se agregará al bloqueo.
ID del caso String N/A Especifica el ID del caso de Google SecOps que se agregará al bloqueo.
UUID del token de webhook String N/A Especifica el UUID del token de Webhook para supervisar la respuesta del usuario.

Ejemplos de casos de uso de manuales

Crea un bloque que se puede pasar más tarde a la acción "Enviar mensaje avanzado" para enviar un mensaje con un bloque.

Ejecutar en

Esta acción no se ejecuta en entidades.

Resultados de la acción

Resultado de secuencia de comandos
Nombre del resultado de la secuencia de comandos Opciones de valor Ejemplo
is_succeed Verdadero/Falso is_succeed:False
Resultado de JSON
{
  "result": "[{\"type\": \"section\", \"block_id\": \"f99958f1-c1f1-4fdb-bb8b-a382d952d5bd\", \"text\": {\"type\": \"mrkdwn\", \"text\": \"yes?\", \"verbatim\": false}},{\"type\": \"actions\", \"block_id\": \"2850e684-472a-472f-9a32-96294cbe9046\", \"elements\": [{\"type\": \"button\", \"text\": {\"type\": \"plain_text\", \"text\": \"y\"}, \"action_id\": \"y\", \"url\": \"...\"}, {\"type\": \"button\", \"text\": {\"type\": \"plain_text\", \"text\": \"n\"}, \"action_id\": \"n\", \"url\": \"...\"}, {\"type\": \"button\", \"text\": {\"type\": \"plain_text\", \"text\": \"View Case in Siemplify\"}, \"action_id\": \"View Case in Siemplify\", \"url\": \"...\"}]}]"
}
Muro de casos
Tipo de resultado Valor o descripción Tipo
Mensaje de salida*

La acción no debe fallar ni detener la ejecución de una guía:

Si se crea un bloque de compilación correctamente (is_succeed=True): "Se creó el bloque de Slack correctamente".

Si no se pudo crear un bloque de Slack debido a algún error general (is_succeed=False): "No se pudo crear un bloque debido al error ocurrido: {0}".format(texto del error)

La acción debería fallar y detener la ejecución de la guía:

Si no se especifica una URL basada en webhook en la configuración de la integración: "No se pudo ejecutar la acción. Especifica el parámetro de integración "URL base del webhook"".

Si se informa un error fatal, como credenciales incorrectas, falta de conexión con el servidor o algún otro, se mostrará el mensaje "Failed to execute "Send Advanced Message" action!". Error is {0}".format(exception.stacktrace)

General

Crear canales

Descripción

Crea un canal de Slack.

Parámetros

Nombre del parámetro Tipo Valor predeterminado Es obligatorio Descripción
Nombre del canal String N/A

Especifica el nombre del canal.

Nota: Los nombres de los canales solo pueden contener letras minúsculas, números, guiones y guiones bajos, y deben tener 80 caracteres o menos.

IDs de usuario String N/A

Especifica los IDs de los usuarios que se deben invitar al canal recién creado.

Ejemplo: U014JDHLW87, U08544ABC85.

Es privado Casilla de verificación Desmarcado No Si se habilita, la acción crea un canal privado.

Ejecutar en

Esta acción se ejecuta en todas las entidades.

Resultados de la acción

Resultado de secuencia de comandos
Nombre del resultado de la secuencia de comandos Opciones de valor Ejemplo
is_success Verdadero/Falso is_success:False
Resultado de JSON
{
    "is_general": "False",
    "name_normalized": "12asd1237712318",
    "is_channel": "True",
    "creator": "U014J4NFQQG",
    "is_member": "True",
    "is_archived": "False",
    "topic": {
        "last_set": "0",
        "value": " ",
        "creator": " "
    },
    "parent_conversation": "None",
    "is_im": "False",
    "is_ext_shared": "False",
    "previous_names": [],
    "last_read": "0000000000.000000",
    "id": "C014S1G6DB4",
    "is_org_shared": "False",
    "pending_connected_team_ids": [],
    "is_pending_ext_shared": "False",
    "is_mpim": "False",
    "is_group": "False",
    "shared_team_ids": ["T013MJHSNCT"],
    "purpose": {
        "last_set": 0,
        "value": " ",
        "creator": " "
    },
    "is_private": "False",
    "is_shared": "False",
    "name": "12asd1237712318",
    "created": "1591194197",
    "pending_shared": [],
    "unlinked": 0,
    "priority": 0
}
Muro de casos
Tipo de resultado Valor o descripción Tipo
Mensaje de salida*

La acción no debe fallar ni detener la ejecución de una guía:

Si "ok"== true y el parámetro de acción "Private" es falso y el parámetro de IDs de usuario está vacío (is_success=true):

"Se creó correctamente el canal {0}".format(name)

Si "ok"== true y el parámetro de acción "Privado" es verdadero y el parámetro de IDs de usuario está vacío (is_success=true): "Se creó correctamente el canal privado {0}".format(name)

Si "ok"== true y el parámetro de acción "Private" es falso y los IDs de usuario están disponibles (is_success=true): "Se creó correctamente el canal {0} y se agregaron {1} usuarios".format(name, user_ids)

Si "ok"== verdadero y el parámetro de acción "Privado" es verdadero, y los IDs de usuario están disponibles (is_success=true):

"Se creó correctamente el canal privado {0} y se agregaron {1} usuarios".format(name, user_ids)

Si "ok" == false. En la primera solicitud (is_success=false):

"No se pudo crear el canal {0}. Reason: {1}".format(name, value of error parameter from response)

Si "ok" == false en la segunda solicitud (is_success=false):

"Se creó el canal {0}, pero no se invitó a los usuarios. Reason:".format(name, value of error parameter from response)

Si "ok" == false y error == "user_not_found" (is_success=false):

"No se pudieron agregar usuarios al canal {0}. Reason: {1} of the specified User IDs does not exist in Slack".format(name, len(errors) from the response)

La acción debería fallar y detener la ejecución de la guía:

Si se informa un error fatal (credenciales incorrectas, error de conexión, falla de la acción), se mostrará el mensaje "Error al ejecutar la acción "Crear canal"". Reason: {0}''.format(error.Stacktrace)

General

Obtén el historial de conversaciones del canal o del usuario

Descripción

Obtén el historial de conversaciones de un usuario o un canal según los criterios de entrada proporcionados. Esta acción funciona con el ID de canal o de usuario, que se puede buscar con las acciones "List Channels" o "List User".

Parámetros

Nombre del parámetro Tipo Valor predeterminado Es obligatorio Descripción
ID de canal o usuario String N/A Especifica el ID del canal o del usuario para el que se recuperará el historial de conversaciones.
Período DDL

Última hora

Valores posibles:

  • Última hora
  • Últimas 6 horas
  • Últimas 24 horas
  • Última semana
  • Último mes
  • Personalizado
No

Especifica un período para los resultados.

Si se selecciona "Personalizado", también debes proporcionar el parámetro "Hora de inicio".

Hora de inicio String N/A No

Especifica la hora de inicio de los resultados.

Este parámetro es obligatorio si se selecciona "Personalizado" para el parámetro "Período".

Formato: ISO 8601.

Ejemplo: 2021-08-05T05:18:42Z

Hora de finalización String N/A No

Especifica la hora de finalización de los resultados.

Si no se proporciona nada y se selecciona "Personalizado" para el parámetro "Período", este parámetro usa la hora actual.

Formato: ISO 8601.

Ejemplo: 2021-08-05T05:18:42Z.

Cantidad máxima de registros que se pueden devolver Número entero 20 No

Especifica la cantidad de registros que se devolverán.

Si no se proporciona nada, la acción devuelve 20 registros.

Ejemplos de casos de uso de manuales

Recuperar el historial de conversaciones para investigar alertas

Fecha de ejecución

Esta acción no se ejecuta en entidades.

Resultados de la acción

Resultado de secuencia de comandos
Nombre del resultado de la secuencia de comandos Opciones de valor Ejemplo
is_success Verdadero/Falso is_success:False
Resultado de JSON
[
  {
    "bot_id": "B02D9QYM7P0",
    "type": "message",
    "text": "test",
    "user": "U02D1RPLVST",
    "ts": "1665988448.627219",
    "app_id": "A02DDGD942Z",
    "team": "T02CX3N6B0B",
    "bot_profile": {
      "id": "B02D9QYM7P0",
      "deleted": false,
      "name": "Siemplify-test",
      "updated": 1630908872,
      "app_id": "A02DDGD942Z",
      "icons": {
        "image_36": "https://a.slack-edge.com/80588/img/plugins/app/bot_36.png",
        "image_48": "https://a.slack-edge.com/80588/img/plugins/app/bot_48.png",
        "image_72": "https://a.slack-edge.com/80588/img/plugins/app/service_72.png"
      },
      "team_id": "T02CX3N6B0B"
    },
    "blocks": [
      {
        "type": "rich_text",
        "block_id": "JbVUf",
        "elements": [
          {
            "type": "rich_text_section",
            "elements": [
              {
                "type": "text",
                "text": "test"
              }
            ]
          }
        ]
      }
    ]
  }
]
Muro de casos
Tipo de resultado Valor o descripción Tipo
Mensaje de salida*

La acción no debe fallar ni detener la ejecución de una guía:

Si se encuentra el historial de conversaciones correctamente (is_succeed=True): "Se recuperó el historial de conversaciones correctamente".

Si no se encuentra la conversación con el ID proporcionado (is_succeed=False): "No se pudo encontrar la conversación con el ID proporcionado {0}".format(channel_or_user_id)

Si se encuentra la conversación con el ID proporcionado y no se encuentran mensajes para el período proporcionado (is_succeed=False): "Se encontró la conversación con el ID {0}, pero no se encontraron mensajes para el período proporcionado".format(channel_or_user_id)

La acción debería fallar y detener la ejecución de la guía:

Si se informa un error fatal, como credenciales incorrectas, falta de conexión con el servidor o algún otro: "No se pudo ejecutar la acción "Enviar mensaje avanzado" Error is {0}".format(exception.stacktrace)

Si se proporciona un valor no válido para el parámetro "Max Records to Return": "Error executing action "{action name}". Motivo: Se proporcionó un valor no válido para "Max Records to Return": . Se debe proporcionar un número positivo"."

Si se selecciona "Personalizado" para el parámetro "Período" y no se especifica el parámetro "Hora de inicio": "Error al ejecutar la acción "{nombre de la acción}". Motivo: "No se proporcionó la hora de inicio para el período personalizado".

General

Obtén detalles del usuario

Descripción

Obtén detalles del usuario de Slack según los criterios de entrada proporcionados.

Parámetros

Nombre del parámetro Tipo Valor predeterminado Es obligatorio Descripción
Buscar por DDL

Correo electrónico

Valores posibles:

  • Correo electrónico
  • Nombre
  • ID
Especifica el parámetro por el que se buscarán los detalles del usuario.
Valor para el usuario String N/A Especifica el valor del usuario por el que se realizará la búsqueda.

Ejemplos de casos de uso de manuales

Obtén detalles del usuario para enriquecer el procesamiento de alertas en Google SecOps.

Ejecutar en

Esta acción no se ejecuta en entidades.

Resultados de la acción

Resultado de secuencia de comandos
Nombre del resultado de la secuencia de comandos Opciones de valor Ejemplo
is_success Verdadero/Falso is_success:False
Resultado de JSON
{
  "id": "U043FPEMATG",
  "team_id": "T02CX3N6B0B",
  "name": "example.user",
  "deleted": false,
  "color": "3c989f",
  "real_name": "Example User",
  "tz": "Europe/Europe",
  "tz_label": "Central European Summer Time",
  "tz_offset": 7200,
  "profile": {
    "title": "",
    "phone": "",
    "skype": "",
    "real_name": "Example User",
    "real_name_normalized": "Example User",
    "display_name": "Example User",
    "display_name_normalized": "Example User",
    "fields": null,
    "status_text": "",
    "status_emoji": "",
    "status_emoji_display_info": [],
    "status_expiration": 0,
    "avatar_hash": "gc297456197c",
    "email": "example.user@example.com",
    "first_name": "Example",
    "last_name": "User",
    "image_24": "https://secure.gravatar.com/avatar/c297456197c0de7baa8c4b9a2398ecd1.jpg?s=24&d=https%3A%2F%2Fa.slack-edge.com%2Fdf10d%2Fimg%2Favatars%2Fava_0011-24.png",
    "image_32": "https://secure.gravatar.com/avatar/c297456197c0de7baa8c4b9a2398ecd1.jpg?s=32&d=https%3A%2F%2Fa.slack-edge.com%2Fdf10d%2Fimg%2Favatars%2Fava_0011-32.png",
    "image_48": "https://secure.gravatar.com/avatar/c297456197c0de7baa8c4b9a2398ecd1.jpg?s=48&d=https%3A%2F%2Fa.slack-edge.com%2Fdf10d%2Fimg%2Favatars%2Fava_0011-48.png",
    "image_72": "https://secure.gravatar.com/avatar/c297456197c0de7baa8c4b9a2398ecd1.jpg?s=72&d=https%3A%2F%2Fa.slack-edge.com%2Fdf10d%2Fimg%2Favatars%2Fava_0011-72.png",
    "image_192": "https://secure.gravatar.com/avatar/c297456197c0de7baa8c4b9a2398ecd1.jpg?s=192&d=https%3A%2F%2Fa.slack-edge.com%2Fdf10d%2Fimg%2Favatars%2Fava_0011-192.png",
    "image_512": "https://secure.gravatar.com/avatar/c297456197c0de7baa8c4b9a2398ecd1.jpg?s=512&d=https%3A%2F%2Fa.slack-edge.com%2Fdf10d%2Fimg%2Favatars%2Fava_0011-512.png",
    "status_text_canonical": "",
    "team": "T02CX3N6B0B"
  },
  "is_admin": false,
  "is_owner": false,
  "is_primary_owner": false,
  "is_restricted": false,
  "is_ultra_restricted": false,
  "is_bot": false,
  "is_app_user": false,
  "updated": 1663939355,
  "is_email_confirmed": true,
  "who_can_share_contact_card": "EVERYONE"
}
Muro de casos
Tipo de resultado Valor o descripción Tipo
Mensaje de salida\*

La acción no debe fallar ni detener la ejecución de una guía:

Si se encuentran los detalles del usuario correctamente (is_succeed=True): "Se recuperaron los detalles del usuario correctamente".

Si no se encuentran los detalles del usuario según los criterios proporcionados (is_succeed=False): "No se pudieron encontrar los detalles del usuario según los criterios proporcionados: Búsqueda por: <0> Valor del usuario: <1>".format(search_by, user_value)

Si se encuentran detalles del usuario por nombre y se encuentra más de una coincidencia (is_succeed=True): "Se encontraron varias coincidencias para los criterios de búsqueda proporcionados: Búsqueda por: <0> Valor del usuario: <1>".format(search_by, user_value)

Si no se encuentra al usuario (is_succeed=False) debido a algún error general: "No se pudieron recuperar los detalles del usuario debido al error ocurrido: {0}" (texto del error)

La acción debería fallar y detener la ejecución de la guía:

Si se informa un error fatal, como credenciales incorrectas, falta de conexión con el servidor o algún otro, se mostrará el mensaje "Failed to execute "Send Advanced Message" action!". Error is {0}".format(exception.stacktrace)

General
Tabla del muro de casos

Nombre de la tabla: Detalles del usuario de Slack

Columnas de la tabla:

  • ID
  • ID de equipo
  • Nombre
  • Nombre real
  • Nombre visible
  • Nombre
  • Apellido
  • Fecha y hora de actualización
  • Zona horaria
  • Título
  • Teléfono
  • Es administrador
  • Es propietario
  • Es el propietario principal
  • Is Restricted
  • Tiene restricción ultra
  • Es bot
  • Is App User
  • Is Email Confirmed
General

Obtén detalles del usuario por ID

Descripción

Obtén los detalles del usuario por su ID.

Parámetros

Nombre del parámetro Tipo Valor predeterminado Es obligatorio Descripción
ID de usuario String N/A ID del usuario.

Ejecutar en

Esta acción se ejecuta en todas las entidades.

Resultados de la acción

Resultado de secuencia de comandos
Nombre del resultado de la secuencia de comandos Opciones de valor Ejemplo
is_succeed Verdadero/Falso is_succeed:False
Resultado de JSON
N/A

Enumerar canales

Descripción

Obtén una lista de canales de Slack.

Parámetros

N/A

Ejecutar en

Esta acción se ejecuta en todas las entidades.

Resultados de la acción

Resultado de secuencia de comandos
Nombre del resultado de la secuencia de comandos Opciones de valor Ejemplo
is_succeed Verdadero/Falso is_succeed:False
Resultado de JSON
[
    {
        "is_org_shared": false,
        "is_general": true,
        "name_normalized": "general",
        "name": "general",
        "is_channel": true,
        "created": 1575550599,
        "is_member": true,
        "is_mpim": false,
        "is_archived": false,
        "creator": "URALP6WRJ",
        "topic": {
            "last_set": 1575550599,
            "value": "Company-wide announcements and work-based matters",
            "creator": "URALP6WRJ"
        },
        "num_members": 1,
        "purpose": {
            "last_set": 1575550599,
            "value": "This channel is for workspace-wide communication and announcements. All members are in this channel.",
            "creator": "URALP6WRJ"
        },
        "members": ["URALP6WRJ"],
        "unlinked": 0,
        "is_shared": false,
        "id": "CRB4ZHGNR",
        "is_private": false,
        "previous_names": []
    }, {
        "is_org_shared": false,
        "is_general": false,
        "name_normalized": "random",
        "name": "random",
        "is_channel": true,
        "created": 1575550599,
        "is_member": true,
        "is_mpim": false,
        "is_archived": false,
        "creator": "URALP6WRJ",
        "topic": {
            "last_set": 1575550599,
            "value": "Non-work banter and water cooler conversation",
            "creator": "URALP6WRJ"
        },
        "num_members": 1,
        "purpose": {
            "last_set": 1575550599,
            "value": "A place for non-work-related flimflam, faffing, hodge-podge or jibber-jabber you'd prefer to keep out of more focused work-related channels.",
            "creator": "URALP6WRJ"
        },
        "members": ["URALP6WRJ"],
        "unlinked": 0,
        "is_shared": false,
        "id": "CRD0KF9T9",
        "is_private": false,
        "previous_names": []
    }, {
        "is_org_shared": false,
        "is_general": false,
        "name_normalized": "website",
        "name": "website",
        "is_channel": true,
        "created": 1575550600,
        "is_member": true,
        "is_mpim": false,
        "is_archived": false,
        "creator": "URALP6WRJ",
        "topic": {
            "last_set": 0,
            "value": " ",
            "creator": " "
        },
        "num_members": 1,
        "purpose": {
            "last_set": 0,
            "value": " ",
            "creator": " "
        },
        "members": ["URALP6WRJ"],
        "unlinked": 0,
        "is_shared": false,
        "id": "CRDAUBZP0",
        "is_private": false,
        "previous_names": []
    }
]
Muro de casos
Tipo de resultado Valor o descripción Tipo
Mensaje de salida*

La acción no debe fallar ni detener la ejecución de una guía:

Si "ok" == false (is_success=false): "No se pudieron mostrar los canales. Motivo: {0}".format(value of error parameter from response)

General

Lista de usuarios

Descripción

Esta acción tiene el rol de obtener una lista de usuarios de Slack.

Parámetros

N/A

Ejecutar en

Esta acción se ejecuta en todas las entidades.

Resultados de la acción

Resultado de secuencia de comandos
Nombre del resultado de la secuencia de comandos Opciones de valor Ejemplo
is_succeed Verdadero/Falso is_succeed:False
Resultado de JSON
[
    {
        "profile": {
            "status_text": " ",
            "display_name": " ",
            "status_emoji": " ",
            "title": " ",
            "status_text_canonical": " ",
            "team": "TRALP6VNY",
            "real_name": "somerealname",
            "image_24": "https://secure.gravatar.com/avatar/2d62053d7f735bc096de59639eb8f350.jpg?s=24&d=https%3A%2F%2Fa.slack-edge.com%2Fdf10d%2Fimg%2Favatars%2Fava_0022-24.png",
            "phone": " ",
            "real_name_normalized": "somerealnamen",
            "image_512": "https://secure.gravatar.com/avatar/2d62053d7f735bc096de59639eb8f350.jpg?s=512&d=https%3A%2F%2Fa.slack-edge.com%2Fdf10d%2Fimg%2Favatars%2Fava_0022-512.png",
            "image_72": "https://secure.gravatar.com/avatar/2d62053d7f735bc096de59639eb8f350.jpg?s=72&d=https%3A%2F%2Fa.slack-edge.com%2Fdf10d%2Fimg%2Favatars%2Fava_0022-72.png",
            "image_32": "https://secure.gravatar.com/avatar/2d62053d7f735bc096de59639eb8f350.jpg?s=32&d=https%3A%2F%2Fa.slack-edge.com%2Fdf10d%2Fimg%2Favatars%2Fava_0022-32.png",
            "image_48": "https://secure.gravatar.com/avatar/2d62053d7f735bc096de59639eb8f350.jpg?s=48&d=https%3A%2F%2Fa.slack-edge.com%2Fdf10d%2Fimg%2Favatars%2Fava_0022-48.png",
            "skype": " ",
            "avatar_hash": "g2d62053d7f7",
            "display_name_normalized": " ",
            "status_expiration": 0,
            "email": "mail@seimplify.co",
            "image_192": "https://secure.gravatar.com/avatar/2d62053d7f735bc096de59639eb8f350.jpg?s=192&d=https%3A%2F%2Fa.slack-edge.com%2Fdf10d%2Fimg%2Favatars%2Fava_0022-192.png"
        },
        "updated": 1575550598,
        "tz": "Europe/Moscow",
        "name": "name",
        "deleted": false,
        "is_app_user": false,
        "is_bot": false,
        "tz_label": "Moscow Time",
        "real_name": "realname",
        "color": "9f69e7",
        "team_id": "TRALP6VNY",
        "is_admin": true,
        "is_ultra_restricted": false,
        "is_restricted": false,
        "is_owner": true,
        "tz_offset": 14400,
        "has_2fa": false,
        "id": "URALP6WRJ",
        "is_primary_owner": true
    }, {
        "profile": {
            "last_name": " ",
            "status_emoji": " ",
            "display_name_normalized": "Slackbot",
            "image_32": "https://a.slack-edge.com/80588/img/slackbot_32.png",
            "skype": " ",
            "image_72": "https://a.slack-edge.com/80588/img/slackbot_72.png",
            "status_expiration": 0,
            "image_192": "https://a.slack-edge.com/80588/marketing/img/avatars/slackbot/avatar-slackbot.png",
            "first_name": "slackbot",
            "display_name": "Slackbot",
            "title": " ",
            "real_name_normalized": "Slackbot",
            "always_active": true,
            "status_text_canonical": " ",
            "image_24": "https://a.slack-edge.com/80588/img/slackbot_24.png",
            "phone": " ",
            "image_48": "https://a.slack-edge.com/80588/img/slackbot_48.png",
            "fields": null,
            "real_name": "Slackbot",
            "image_512": "https://a.slack-edge.com/80588/img/slackbot_512.png",
            "team": "TRALP6VNY",
            "avatar_hash": "sv41d8cd98f0",
            "status_text": " "
        },
        "updated": 0,
        "tz": null,
        "name": "slackbot",
        "deleted": false,
        "is_app_user": false,
        "is_bot": false,
        "tz_label": "Pacific Standard Time",
        "real_name": "Slackbot",
        "color": "757575",
        "team_id": "TRALP6VNY",
        "is_admin": false,
        "is_ultra_restricted": false,
        "is_restricted": false,
        "is_owner": false,
        "tz_offset": -28800,
        "id": "USLACKBOT",
        "is_primary_owner": false
    }
]

Ping

Descripción

Prueba la conectividad.

Parámetros

N/A

Ejecutar en

Esta acción se ejecuta en todas las entidades.

Resultados de la acción

Resultado de secuencia de comandos
Nombre del resultado de la secuencia de comandos Opciones de valor Ejemplo
is_succeed Verdadero/Falso is_succeed:False
Resultado de JSON
N/A

Cambiar el nombre del canal

Descripción

Cambiar el nombre del canal de Slack

Parámetros

Nombre del parámetro Tipo Valor predeterminado Es obligatorio Descripción
Nombre del canal String N/A No

Especifica el nombre del canal al que quieres cambiarle el nombre.

Nota: Si se especifican los parámetros "Nombre del canal" y "ID del canal", la acción solo funcionará con el ID.

ID del canal String N/A No

Especifica el ID del canal al que quieres cambiarle el nombre.

Nota: Si se especifican los parámetros "Nombre del canal" y "ID del canal", la acción solo funcionará con el ID.

Nombre nuevo String N/A

Especifica un nombre nuevo para el canal.

Nota: Los nombres de los canales solo pueden contener letras minúsculas, números, guiones y guiones bajos, y deben tener 80 caracteres o menos.

Ejecutar en

Esta acción no se ejecuta en entidades.

Resultados de la acción

Resultado de secuencia de comandos
Nombre del resultado de la secuencia de comandos Opciones de valor Ejemplo
is_succeed Verdadero/Falso is_succeed:False
Resultado de JSON

Cuando "ok" == true:

{
    "channel": {
        "id": "C013ELA1YVC",
        "name": "project_old",
        "is_channel": true,
        "is_group": false,
        "is_im": false,
        "created": 1589444943,
        "is_archived": false,
        "is_general": false,
        "unlinked": 0,
        "name_normalized": "project_old",
        "is_shared": false,
        "parent_conversation": null,
        "creator": "U0136KZ0P5M",
        "is_ext_shared": false,
        "is_org_shared": false,
        "shared_team_ids": [
            "T013MJHSNCT"
        ],
        "pending_shared": [],
        "pending_connected_team_ids": [],
        "is_pending_ext_shared": false,
        "is_member": true,
        "is_private": false,
        "is_mpim": false,
        "last_read": "1595242486.000300",
        "topic": {
            "value": "",
            "creator": "",
            "last_set": 0
        },
        "purpose": {
            "value": "This *channel* is for working on a project. Hold meetings, share docs, and make decisions together with your team.",
            "creator": "U0136KZ0P5M",
            "last_set": 1589444943
        },
        "previous_names": [
            "project_new",
            "project"
        ]
    },
    "ok": true,
    "warning": "missing_charset",
    "response_metadata": {
        "warnings": [
            "missing_charset"
        ]
    }
}

Cuando "ok" == false:

{
    "ok": false,
    "error": "name_taken",
    "warning": "missing_charset",
    "response_metadata": {
        "warnings": [
            "missing_charset"
        ]
    }
}
Muro de casos
Tipo de resultado Valor o descripción Tipo
Mensaje de salida*

La acción no debe fallar ni detener la ejecución de una guía:

Si "ok"== true (is_success=true): "Se cambió el nombre del canal {0} a {1} {0} correctamente".format(name/ID, new name)

Si "ok"== false (is_success=false): "No se pudo cambiar el nombre del canal {0}. Reason: {1}".format(name,error from the response)

Si no se encontró el canal por su nombre (is_success=false): "No se pudo cambiar el nombre del canal {0}. Motivo: No se encontró el canal".format(name)

La acción debería fallar y detener la ejecución de la guía:

Si se informa un error grave (credenciales incorrectas, error de conexión, falla de la acción): "Error al ejecutar la acción "Cambiar el nombre del canal". Motivo: {0}''.format(error.Stacktrace)

Si no se especifican los parámetros "Nombre del canal" y "ID del canal": "Error al ejecutar la acción "Cambiar el nombre del canal". Motivo: Debes especificar el "Nombre del canal" o el "ID del canal".

General

Enviar mensaje avanzado

Descripción

Envía un mensaje avanzado a un canal o usuario de Slack. Esta acción permite enviar mensajes de texto simples y mensajes enriquecidos de bloques de Slack con botones, formato avanzado y mucho más. Para obtener más información sobre los mensajes de bloques, consulta Slack Block Kit .

Esta acción se puede usar junto con la acción "Wait for Reply With Webhook" para enviar primero un mensaje de bloque con un webhook a un usuario y, luego, con la acción "Wait for Reply With Webhook", verificar la respuesta del usuario.

Parámetros

Nombre del parámetro Tipo Valor predeterminado Es obligatorio Descripción
Tipo de mensaje DDL

Texto

Valores posibles:

  • Texto
  • Bloquear
Especifica el tipo de mensaje que se enviará.
Tipo de destinatario DDL

Nombre

Valores posibles:

  • Nombre
  • ID
  • Correo electrónico

Especifica el canal o el nombre de usuario (nombre completo) al que se enviará el mensaje.

Opcionalmente, especifica el ID del canal o del usuario, o la dirección de correo electrónico de un usuario.

Destinatario String N/A Especifica el destinatario al que se enviará un mensaje.
Mensaje String N/A Especifica el contenido del mensaje que se enviará.

Ejemplos de casos de uso de manuales

Enviar un mensaje con contenido enriquecido, como botones, vínculos o imágenes

Ejecutar en

Esta acción no se ejecuta en entidades.

Resultados de la acción

Resultado de secuencia de comandos
Nombre del resultado de la secuencia de comandos Opciones de valor Ejemplo
is_succeed Verdadero/Falso is_succeed:False
Resultado de JSON
[
  {
    "Entity": "U043FPEMATG",
    "EntityResult": {
      "channel": "D044C3DUMB2",
      "message": {
        "bot_id": "B02D9QYM7P0",
        "type": "message",
        "text": "test msg",
        "user": "U02D1RPLVST",
        "ts": "1666008612.116169",
        "app_id": "A02DDGD942Z",
        "team": "T02CX3N6B0B",
        "bot_profile": {
          "id": "B02D9QYM7P0",
          "app_id": "A02DDGD942Z",
          "name": "test",
          "icons": {
            "image_36": "https://a.slack-edge.com/80588/img/plugins/app/bot_36.png",
            "image_48": "https://a.slack-edge.com/80588/img/plugins/app/bot_48.png",
            "image_72": "https://a.slack-edge.com/80588/img/plugins/app/service_72.png"
          },
          "deleted": false,
          "updated": 1630908872,
          "team_id": "T02CX3N6B0B"
        },
        "blocks": [
          {
            "type": "rich_text",
            "block_id": "RJvg",
            "elements": [
              {
                "type": "rich_text_section",
                "elements": [
                  {
                    "type": "text",
                    "text": "test msg"
                  }
                ]
              }
            ]
          }
        ]
      },
      "ts": "1666008612.116169",
      "ok": true
    }
  }
]
Muro de casos
Tipo de resultado Valor o descripción Tipo
Mensaje de salida*

La acción no debe fallar ni detener la ejecución de una guía:

Si el mensaje se envía correctamente (is_succeed=True): "Se envió el mensaje correctamente"

Si el mensaje no se envía correctamente (is_succeed=False) porque no se encuentra el destinatario especificado: "No se envió el mensaje porque no se encontró el destinatario especificado {0} con el tipo {1}". (destinatario, tipo de destinatario)

Si el mensaje no se envía correctamente (is_succeed=False) debido a algún error general: "No se envió el mensaje debido al siguiente error: {0}" (texto del error)

La acción debería fallar y detener la ejecución de la guía:

Si se informa un error fatal, como credenciales incorrectas, falta de conexión con el servidor o algún otro: "No se pudo ejecutar la acción "Enviar mensaje avanzado" Error is {0}".format(exception.stacktrace)

General

Enviar mensaje interactivo

Descripción

Envía un mensaje interactivo a un canal o a un usuario y, cuando se base en el UUID del webhook proporcionado, verifica la respuesta del usuario. Esta acción es similar a la acción "Enviar mensaje avanzado", pero permite enviar solo contenido de bloques (no mensajes de texto sin formato) y también requiere un UUID de webhook para verificar la respuesta del usuario a un webhook.

La acción es asíncrona, por lo que debes ajustar el tiempo de espera de la acción en el IDE según corresponda.

Configura la app de Slack que se usa en la integración para permitir mensajes interactivos. Para obtener más información sobre la configuración de la app de Slack, consulta Cómo preparar tu aplicación para mensajes interactivos.

Parámetros

Nombre del parámetro Tipo Valor predeterminado Es obligatorio Descripción
Tipo de destinatario DDL

Nombre

Valores posibles:

  • Nombre
  • ID
  • Correo electrónico

Especifica el canal o el nombre de usuario (nombre completo) al que se enviará el mensaje.

Opcionalmente, especifica el ID del canal o del usuario, o la dirección de correo electrónico de un usuario.

Destinatario String N/A Especifica el destinatario al que se enviará un mensaje.
Mensaje String N/A Especifica el contenido del mensaje que se enviará.
UUID del token de webhook String N/A Especifica el UUID del token del webhook para supervisar la respuesta del usuario.

Ejemplos de casos de uso de manuales

Enviar un mensaje con contenido enriquecido, como botones, vínculos o imágenes

Ejecutar en

Esta acción no se ejecuta en entidades.

Resultados de la acción

Resultado de secuencia de comandos
Nombre del resultado de la secuencia de comandos Opciones de valor Ejemplo
is_succeed Verdadero/Falso is_succeed:False
Resultado de JSON
[
  {
    "uuid": "10953f8e-7ef8-4bde-9e9b-212005e0e737",
    "type": "web",
    "token_id": "47289ba5-277e-4ab9-9238-eb31080530ca",
    "ip": "0000:a000000:ad80:000:20ea:653:fb97",
    "hostname": "webhook.site",
    "method": "GET",
    "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/15.4 Safari/605.1.15",
    "content": "",
    "query": {
      "Answer": "yes"
    },
    "headers": {
      "connection": [
        "close"
      ],
      "accept-encoding": [
        "gzip, deflate, br"
      ],
      "accept-language": [
        "en-US,en;q=0.9"
      ],
      "user-agent": [
        "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/15.4 Safari/605.1.15"
      ],
      "cookie": [
        "_ga=GA"
      ],
      "accept": [
        "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8"
      ],
      "host": [
        "webhook.site"
      ],
      "content-length": [
        ""
      ],
      "content-type": [
        ""
      ]
    },
    "url": "https://webhook.site/47289ba5-277e-4ab9-9238-xx0000000xx?Answer=yes",
    "size": 0,
    "files": [],
    "created_at": "2022-10-14 19:45:40",
    "updated_at": "2022-10-14 19:45:40",
    "sorting": 1665776740032262,
    "custom_action_output": []
  }
]
Muro de casos
Tipo de resultado Valor o descripción Tipo
Mensaje de salida*

La acción no debe fallar ni detener la ejecución de una guía:

Si el mensaje se envía correctamente (is_succeed=True): "Se envió el mensaje correctamente"

Si el mensaje no se envía correctamente (is_succeed=False) porque no se encuentra el destinatario especificado: "No se envió el mensaje porque no se encontró el destinatario especificado {0} con el tipo {1}". (destinatario, tipo de destinatario)

Si el mensaje no se envía correctamente (is_succeed=False) debido a algún error general: "No se envió el mensaje debido al siguiente error: {0}" (texto del error)

Mensajes del muro de casos para la funcionalidad asíncrona:

Un mensaje de la pared del caso para las iteraciones mientras se espera la respuesta: "Waiting for the response to the sent message with a webhook. URL de webhook con UUID: "{0}".format(URL de webhook de la configuración de la integración + UUID del token web)

Si la respuesta se recuperó correctamente (is_succeed=True): "Successfully fetched the user's response to a webhook! Contenido de la respuesta: {0}".format(carga útil que se envió del usuario a un webhook)

Si no se pudo recuperar la respuesta hasta el tiempo de espera: "No se encontró una respuesta del usuario a un webhook y la acción se detuvo debido al tiempo de espera".

La acción debería fallar y detener la ejecución de la guía:

Si no se especifica una URL basada en webhook en la configuración de la integración y se especifica un token de UUID de webhook: "No se pudo ejecutar la acción. Especifica el parámetro de integración "URL base del webhook". "

Si se informa un error fatal, como credenciales incorrectas, falta de conexión con el servidor o algún otro error: "No se pudo ejecutar la acción "Enviar mensaje interactivo"! Error is {0}".format(exception.stacktrace)

General

Enviar mensaje

Descripción

Envía un mensaje a un usuario o a varios usuarios o canales.

Parámetros

Nombre del parámetro Tipo Valor predeterminado Es obligatorio Descripción
Canal String N/A

Es el nombre del canal de Slack o la dirección de correo electrónico del usuario al que se enviará el mensaje.

Los valores ingresados deben estar separados por comas.

Mensaje String N/A Es el contenido del mensaje.

Ejecutar en

Esta acción se ejecuta en todas las entidades.

Resultados de la acción

Resultado de secuencia de comandos
Nombre del resultado de la secuencia de comandos Opciones de valor Ejemplo
is_succeed Verdadero/Falso is_succeed:False
Resultado de JSON
N/A

Subir archivo

Descripción

Agrega archivos a Slack y compártelos con tus compañeros de equipo para colaborar. Puedes elegir y subir archivos a Slack desde tu dispositivo o tu app de administración de archivos preferida. Los archivos subidos se almacenan, se pueden buscar y se pueden compartir en todo tu espacio de trabajo.

Parámetros

Nombre del parámetro Tipo Valor predeterminado Es obligatorio Descripción
Nombre del archivo String N/A Nombre del archivo de destino.
Ruta de acceso al archivo String N/A Es la ruta de acceso al archivo de destino.
Canal String N/A Canal de destino.

Ejecutar en

Esta acción se ejecuta en todas las entidades.

Resultados de la acción

Resultado de secuencia de comandos
Nombre del resultado de la secuencia de comandos Opciones de valor Ejemplo
is_succeed Verdadero/Falso is_succeed:False
Resultado de JSON
N/A

Esperar respuesta

Descripción

Espera una respuesta de conversación a un mensaje en un canal.

Parámetros

Nombre del parámetro Tipo Valor predeterminado Es obligatorio Descripción
Canal String N/A Canal de destino.
Marca de tiempo del mensaje String N/A Es la marca de tiempo del mensaje del que se obtendrán las respuestas (en milisegundos).
ID del canal String N/A No ID del canal de Slack de destino.

Casos de uso del manual

Guía con la acción de enviar un mensaje y después esperar una respuesta (con el canal como marcador de posición de la acción anterior: ID del canal)

Ejecutar en

Esta acción se ejecuta en todas las entidades.

Resultados de la acción

Resultado de secuencia de comandos
Nombre del resultado de la secuencia de comandos Opciones de valor Ejemplo
is_succeed Verdadero/Falso is_succeed:False
Resultado de JSON
N/A

Wait For Reply With Webhook

Descripción

Espera a que un usuario responda un mensaje enviado con un webhook. Esta acción verifica periódicamente el webhook proporcionado para ver si el usuario respondió. La acción se puede usar con la acción "Enviar mensaje avanzado" si se envió el mensaje de bloque con webhook para verificar si se proporcionó la respuesta del usuario al webhook.

Esta acción es asíncrona, por lo que debes ajustar el valor de tiempo de espera del IDE según corresponda.

Parámetros

Nombre del parámetro Tipo Valor predeterminado Es obligatorio Descripción
UUID del token de webhook String N/A Especifica el UUID del token del webhook para supervisar la respuesta del usuario.

Ejemplos de casos de uso de manuales

Espera una respuesta a un mensaje con un webhook.

Ejecutar en

Esta acción no se ejecuta en entidades.

Resultados de la acción

Resultado de secuencia de comandos
Nombre del resultado de la secuencia de comandos Opciones de valor Ejemplo
is_succeed Verdadero/Falso is_succeed:False
Resultado de JSON
{
  "client_msg_id": "00000000-0000-0000-0000-000000000000",
  "type": "message",
  "text": "Yes",
  "user": "U0000000",
  "ts": "1578390603.001200",
  "team": "T0000000",
  "blocks": [
    {
      "type": "rich_text",
      "block_id": "2Bb=",
      "elements": [
        {
          "type": "rich_text_section",
          "elements": [
            {
              "type": "text",
              "text": "Example"
            }
          ]
        }
      ]
    }
  ],
  "thread_ts": "1578390492.001100",
  "parent_user_id": "U0000000"
}
Muro de casos
Tipo de resultado Valor o descripción Tipo
Mensaje de salida*

La acción no debe fallar ni detener la ejecución de una guía:

Un mensaje de la pared del caso para las iteraciones mientras se espera la respuesta: "Waiting for the response to the sent message with a webhook. URL de webhook con UUID: "{0}".format(URL de webhook de la configuración de la integración + UUID del token web)

Si la respuesta se recuperó correctamente (is_succeed=True): "Successfully fetched the user's response to a webhook! Contenido de la respuesta: {0}".format(carga útil que se envió del usuario a un webhook)

Si no se pudo recuperar la respuesta hasta el tiempo de espera: "No se encontró una respuesta del usuario a un webhook y la acción se detuvo debido al tiempo de espera".

La acción debería fallar y detener la ejecución de la guía:

Si no se especifica la URL basada en webhook en la configuración de la integración y se especifica el token UUID del webhook: "No se pudo ejecutar la acción. Especifica el parámetro de integración "URL base del webhook". "

Si se informa un error fatal, como credenciales incorrectas, falta de conexión con el servidor o algún otro: "No se pudo ejecutar la acción "Enviar mensaje avanzado" Error is {0}".format(exception.stacktrace)

General

¿Necesitas más ayuda? Obtén respuestas de miembros de la comunidad y profesionales de Google SecOps.