Acciones de Slack

avance

Todavía estamos trabajando en esta característica, ¡pero nos encantaría que la probaras!

Esta característica se proporciona actualmente como parte de un programa de vista previa de conformidad con nuestras políticas de prelanzamiento.

Esta página proporciona una referencia completa de las acciones de chat de Slack disponibles en el catálogo de acciones de automatización del flujo de trabajo. Estas acciones le permiten aflojar las operaciones de mensajería.

Requisitos previos

Antes de emplear acciones de comunicación en la automatización del flujo de trabajo, cerciorar de tener:

Un espacio de trabajo de Slack con las licencias adecuadas.
Un token de bot de Slack configurado como secreto en la automatización del flujo de trabajo.
Acceso a los canales de Slack donde deseas enviar mensajes.

Configurar la integración de Slack

Esta sección detalla las instrucciones para configurar una aplicación Slack con los permisos de alcance mínimos para permitir las acciones de Slack de automatización del flujo de trabajo.

Crear una aplicación de Slack

Vaya a la Slack API > Create New App > From Scratch
Dale un nombre a tu aplicación y selecciona un espacio de trabajo, luego haz clic en Create App.
Al crear, vaya a App Home en la navegación izquierda y asegúrese de que su bot esté en línea.

Configurar permisos de OAuth

En la navegación izquierda, seleccione OAuth & Permissions.
Desplácese hacia abajo hasta la sección Bot Token Scopes y agregue los siguientes ámbitos para permitir los usos de la acción de automatización del flujo de trabajo:
- chat:write - Requerido para publicar un mensaje
- reactions:read - Requerido para obtener reacción de un hilo
- files:write - Requerido para subir un archivo adjunto a un hilo
Desplazar hacia arriba y haga clic en el botón Install to [espacio de trabajo] para iniciar la configuración de OAuth con su espacio de trabajo de Slack.
Deberías ver un mensaje de confirmación. Haz clic en Allow para confirmar.
Tras el éxito, copia el Bot token y guárdalo para el siguiente paso. El token debe comenzar con xoxb-....

Agregar la aplicación a los canales

Ahora que la aplicación Slack está creada y configurada, agrégala a los canales de Slack que quieras usar editando las Integraciones de ese canal y agregando la aplicación Slack.

Configuración de New Relic

Una vez que haya configurado una aplicación de Slack y obtenido un token de bot, almacene esta credencial en la gestión de secretos de New Relic utilizando la mutación de GraphQL a continuación:

mutation {
  secretsManagementCreateSecret(
    scope: { type: ACCOUNT, id: "12345678" }
    namespace: "slack"
    key: "my-app-bot-token"
    description: "A slack token to send messages with newrelic workflow automation"
    value: "xoxb-..."
  ) {
    key
  }
}

Configura los siguientes valores:

id - Su ID de cuenta de New Relic
namespace - Opcional, use cualquier cadena alfanumérica para categorizar su secreto
key - Use una cadena alfanumérica para hacer referencia a este secreto
description - Descripción opcional para el secreto
value - El token del bot de Slack que copió del paso anterior

Puede ejecutar esta mutación utilizando el explorador NerdGraph GraphiQL con su clave de API de usuario de New Relic. Una vez enviado correctamente, debería ver un resultado similar a este:

{
  "data": {
    "secretsManagementCreateSecret": {
      "key": "my-app-bot-token"
    }
  }
}

Usar el token de Slack en los flujos de trabajo

Use la función de automatización del flujo de trabajo aprovechando el secreto del token del bot de Slack almacenado con su espacio de nombres y nombres de clave.

Ejemplo:

name: to-slack

steps:
  - name: postCsv
    type: action
    action: slack.chat.postMessage
    version: 1
    inputs:
      channel: test-channel-workflow
      text: "Hello World!"
      token: ${{ :secrets:slack:my-app-bot-token }}

Sugerencia

Si no usó un espacio de nombres, elimine la parte :namespace de la entrada del token, así: ${{ :secrets:my-app-bot-token }}

Envía un mensaje a un canal de Slack, con un archivo adjunto opcional.

Campo de entrada	Opcionalidad	Tipo	Descripción	Ejemplo
token	Requerido	Secreto	El token del bot de Slack que se utilizará. Esto debe pasarse como una sintaxis secreta. Consulte Agregar configuración de Slack para obtener instrucciones sobre cómo configurar un token.	`${{ :secrets:slackToken }}`
canal	Requerido	Cadena	El nombre del canal, o un ID de canal, para enviar el mensaje. Consulte la API de Slack para obtener más información.	`my-slack-channel`
texto	Requerido	Cadena	El mensaje que se publicará en Slack en el `channel` especificado.	`Hello World!`
hilosTs	Opcional	Cadena	marca de tiempo que pertenece al mensaje principal, empleada para crear una respuesta de mensaje en un hilo.	`<digits>.<digits>`
adjunto	Opcional	Mapa	Permite anexar un archivo con un mensaje al `channel` especificado.
archivo adjunto	Requerido	Cadena	Especifique el nombre del archivo cargado en Slack.	`file.txt`
contenido del archivo adjunto	Requerido	Cadena	El contenido del archivo a cargar como UTF8.	`Hello\nWorld!`
selectores	Opcional	Lista	Los selectores para obtener como resultado el único parámetro especificado.	`[{\"name\": \"threadTs\", \"expression\": \".threadTs\"}, {\"name\": \"channelID\", \"expression\": \".channelID\")\"}]`

Campo de salida	Tipo	Descripción	Ejemplo
hilosTs	Cadena	marca de tiempo del hilo del mensaje. Se puede emplear en futuras llamadas `postMessage` para publicar una respuesta en un hilo.	`<digits>.<digits>`
ID de canal	Cadena	Id del canal donde se publica el mensaje.	`<string>`
éxito	Booleano	Estado de la solicitud	`true / false`
mensaje de error	Cadena	Motivo del fallo como mensaje	`<string>`

Ejemplo 1: Enviar mensaje de Slack

Ejemplo de flujo de trabajo
`name: SendMessage steps: - name: send_slack_message type: action action: slack.chat.postMessage version: 1 inputs: token: ${{ :secrets:dn_staging_slack_token }} channel: ${{ .workflowInputs.channel }} text: ${{ .workflowInputs.text }} selectors: - name: threadTs expression: ".threadTs" - name: channelID expression: ".channelID"` Entradas: { "inputs": [ { "key": "channel", "value": "test-channel-workflow" }, { "key": "text", "value": "This is my message with bold text and `code backticks`" } ] } Resultado esperado: `[ { "threadTs": "1718897637.400609", "channelID": "C063JK1RHN1" "success": true } ]`

Ejemplo de flujo de trabajo

name: SendMessage

  steps:
    - name: send_slack_message
      type: action
      action: slack.chat.postMessage 
      version: 1
      inputs:
        token: ${{ :secrets:dn_staging_slack_token }}
        channel: ${{ .workflowInputs.channel }}
        text: ${{ .workflowInputs.text }}
        selectors:
          - name: threadTs
            expression: ".threadTs"
          - name: channelID
            expression: ".channelID"

Entradas:

{
  "inputs": [
    {
      "key": "channel",
      "value": "test-channel-workflow"
    },
    {
      "key": "text",
      "value": "This is my message *with bold text* and `code backticks`"
    }
  ]
}

Resultado esperado:

[
    {
      "threadTs": "1718897637.400609",
      "channelID": "C063JK1RHN1"
      "success": true
    }
  ]

Ejemplo 2: Anexar un archivo

Ejemplo de flujo de trabajo
`name: SendFileMessage steps: - name: postCsv type: action action: slack.chat.postMessage version: 1 inputs: token: ${{ :secrets:dn_staging_slack_token }} channel: test-channel-workflow text: "Please find the attached file:" attachment: filename: 'file.txt' content: "Hello\nWorld!"` Resultado esperado: `[ { "threadTs": "1718897637.400609", "channelID": "C063JK1RHN1" "success": true } ]`

Ejemplo de flujo de trabajo

name: SendFileMessage

  steps:

    - name: postCsv
      type: action
      action: slack.chat.postMessage
      version: 1
      inputs:
        token: ${{ :secrets:dn_staging_slack_token }}
        channel: test-channel-workflow
        text: "Please find the attached file:"
        attachment:
          filename: 'file.txt'
          content: "Hello\nWorld!"

Resultado esperado:

[
    {
      "threadTs": "1718897637.400609",
      "channelID": "C063JK1RHN1"
      "success": true
    }
  ]

Obtén una reacción a un mensaje del canal de Slack.

Campo de entrada	Opcionalidad	Tipo	Descripción	Ejemplo
token	Requerido	Secreto	El token del bot de Slack que se utilizará. Esto debe pasarse como una sintaxis secreta. Consulte Agregar configuración de Slack para obtener instrucciones sobre cómo configurar un token.	`${{ :secrets:slackToken }}`
ID de canal	Requerido	Cadena	El ID del canal, para obtener las reacciones del mensaje. Ver método`reactions.get`	`C063JK1RHN1`
se acabó el tiempo	Opcional	En t	El tiempo en segundos que hay que esperar para obtener cualquier reacción. El valor predeterminado es 60 s, el máximo permitido es 600 s (10 min).	60
hilosTs	Requerido	Cadena	marca de tiempo que pertenece al mensaje, empleada para obtener la reacción de ese mensaje.	`<digits>.<digits>`
selectores	Opcional	Lista	Los selectores para obtener como resultado el único parámetro especificado.	`[{\"name\": \"reactions\", \"expression\": \".reactions \"}]`

Campo de salida	Tipo	Descripción	Ejemplo
reacciones	Lista	Lista de elementos con todas las reacciones capturadas o una lista vacía si se agotó el tiempo de espera.	`<list>`
éxito	Booleano	Estado de la solicitud	`true / false`
mensaje de error	Cadena	Motivo del fallo como mensaje	`Invalid slack token`

Ejemplo 1: Slack obtiene reacciones

Ejemplo de flujo de trabajo
`name: GetReactions steps: - name: getReactions type: action action: slack.chat.getReactions version: 1 inputs: token: ${{ :secrets:dn_staging_slack_token }} channelID: ${{ .steps.promptUser.outputs.channelID }} threadTs: ${{ .steps.promptUser.outputs.threadTs }} timeout: ${{ .workflowInputs.timeout }} selectors: ${{ .workflowInputs.selectors }}` Entradas: `{ "inputs": [ { "key": "channelID", "value": "C063JK1RHN1" }, { "key": "threadTs", "value": "1718897637.400609" }, { "key": "selectors", "value": "[{\"name\": \"reactions\", \"expression\": \".reactions \"}]" } ] }` Salidas: `[ { "name": "grinning", "users": [ "W222222" ], "count": 1 }, { "name": "question", "users": [ "W333333" ], "count": 1 } ] or if it is timed out, []`

Ejemplo de flujo de trabajo

name: GetReactions

  steps:
      - name: getReactions
      type: action
      action: slack.chat.getReactions
      version: 1
      inputs:
        token: ${{ :secrets:dn_staging_slack_token }}
        channelID: ${{ .steps.promptUser.outputs.channelID }}
        threadTs: ${{ .steps.promptUser.outputs.threadTs }}
        timeout: ${{ .workflowInputs.timeout }}
        selectors: ${{ .workflowInputs.selectors }}

Entradas:

{
  "inputs": [
    {
      "key": "channelID",
      "value": "C063JK1RHN1"
    },
    {
      "key": "threadTs",
      "value": "1718897637.400609"
    },
    {
      "key": "selectors",
      "value": "[{\"name\": \"reactions\", \"expression\": \".reactions \"}]"
    }
  ]
}

Salidas:

[
              {
                  "name": "grinning",
                  "users": [
                      "W222222"
                  ],
                  "count": 1
              },
              {
                  "name": "question",
                  "users": [
                      "W333333"
                  ],
                  "count": 1
              }
          ]

  or if it is timed out,
  []

Te ofrecemos esta traducción automática para facilitar la lectura.

Acciones de Slack

avance

Requisitos previos

Configurar la integración de Slack

Crear una aplicación de Slack

Configurar permisos de OAuth

Agregar la aplicación a los canales

Configuración de New Relic

Usar el token de Slack en los flujos de trabajo

Sugerencia