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:
Ve a https://api.slack.com/ y haz clic en Start Building.
Ingresa los parámetros Nombre de la app y Espacio de trabajo de Slack de desarrollo. Haz clic en Crear app.
Ve a la pestaña OAuth y permisos y desplázate hacia abajo hasta las secciones Alcances.
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
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.
Desplázate hacia arriba y haz clic en Instalar aplicación en el lugar de trabajo.
Haz clic en Permitir.
Copia uno de los tokens que se crearon, según si quieres usar un bot o un usuario.
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 | Sí | 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 | Sí | Canal de destino. |
Pregunta | String | N/A | Sí | 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 | Sí | Especifica el texto de la pregunta que se agregará al bloque. |
Botones de respuestas | String | N/A | Sí | Especifica los botones de respuesta que se agregarán al bloque. |
URL base de Siemplify | String | N/A | Sí | Especifica la URL base del servidor de Google SecOps que se agregará al bloqueo. |
ID del caso | String | N/A | Sí | Especifica el ID del caso de Google SecOps que se agregará al bloqueo. |
UUID del token de webhook | String | N/A | Sí | 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 | Sí | 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 | Sí | 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 | Sí | Especifica el ID del canal o del usuario para el que se recuperará el historial de conversaciones. |
Período | DDL | Última hora Valores posibles:
|
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:
|
Sí | Especifica el parámetro por el que se buscarán los detalles del usuario. |
Valor para el usuario | String | N/A | Sí | 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:
|
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 | Sí | 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 | Sí | 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:
|
Sí | Especifica el tipo de mensaje que se enviará. |
Tipo de destinatario | DDL | Nombre Valores posibles:
|
Sí | 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 | Sí | Especifica el destinatario al que se enviará un mensaje. |
Mensaje | String | N/A | Sí | 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:
| Sí | 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 | Sí | Especifica el destinatario al que se enviará un mensaje. |
Mensaje | String | N/A | Sí | Especifica el contenido del mensaje que se enviará. |
UUID del token de webhook | String | N/A | Sí | 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 | Sí | 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 | Sí | 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 | Sí | Nombre del archivo de destino. |
Ruta de acceso al archivo | String | N/A | Sí | Es la ruta de acceso al archivo de destino. |
Canal | String | N/A | Sí | 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 | Sí | Canal de destino. |
Marca de tiempo del mensaje | String | N/A | Sí | 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 | Sí | 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.