Actions Slack

Aperçu

Nous travaillons toujours sur cette fonctionnalité, mais nous aimerions que vous l'essayiez !

Cette fonctionnalité est actuellement fournie dans le cadre d'un programme d'aperçu conformément à nos politiques de pré-sortie.

Cette page fournit une référence complète des actions de chat Slack disponibles dans le catalogue des actions d'automatisation des workflows. Ces actions vous permettent d'effectuer des opérations de messagerie Slack.

Prérequis

Avant d'utiliser des actions de communication dans l'automatisation workflow, assurez-vous de disposer de :

Un espace de travail Slack avec les autorisations appropriées.
Un bot Slack configuré comme secret dans l'automatisation workflow.
Accès aux canaux Slack dans lesquels vous souhaitez envoyer des messages.

Configurer l'intégration Slack

Cette section détaille les instructions pour configurer une application Slack avec les autorisations minimales pour permettre les actions Slack d'automatisation des workflows.

Créer une application Slack

Accédez à Slack API > Create New App > From Scratch
Donnez un nom à votre application et sélectionnez un espace de travail, puis cliquez sur Create App.
Après la création, accédez à App Home dans la navigation de gauche et assurez-vous que votre bot est en ligne.

Configurer les autorisations OAuth

Dans la navigation de gauche, sélectionnez OAuth & Permissions.
Faites défiler jusqu'à la section Bot Token Scopes et ajoutez les scopes suivants pour autoriser les utilisations des actions d'automatisation des workflows :
- chat:write - Requis pour publier un message
- reactions:read - Requis pour obtenir une réaction d'un fil
- files:write - Requis pour télécharger une pièce jointe de fichier dans un fil
Revenez en haut et cliquez sur le bouton Install to [espace de travail] pour démarrer la configuration OAuth avec votre espace de travail Slack.
Vous devriez voir une invite de confirmation. Cliquez sur Allow pour confirmer.
En cas de succès, copiez le Bot token et conservez-le pour l'étape suivante. Le jeton doit commencer par xoxb-....

Ajouter l'application aux canaux

Maintenant que l'application Slack est créée et configurée, ajoutez-la au(x) canal(aux) Slack que vous souhaitez utiliser en modifiant les Intégrations de ce canal et en y ajoutant l'application Slack.

Configuration New Relic

Une fois que vous avez configuré une application Slack et obtenu un jeton de bot, stockez cette information d'identification dans la gestion des secrets New Relic à l'aide de la mutation GraphQL ci-dessous :

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
  }
}

Configurez les valeurs suivantes :

id - Votre ID de compte New Relic
namespace - Facultatif, utilisez n'importe quelle chaîne alphanumérique pour catégoriser votre secret
key - Utilisez une chaîne alphanumérique pour référencer ce secret
description - Description facultative du secret
value - Le jeton du bot Slack que vous avez copié à l'étape précédente

Vous pouvez exécuter cette mutation à l'aide de NerdGraph GraphiQL explorer avec votre clé API utilisateur New Relic. Une fois soumis avec succès, vous devriez voir un résultat similaire à celui-ci :

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

Utiliser le jeton Slack dans les workflows

Utilisez la fonctionnalité d'automatisation des workflows en tirant parti du secret du jeton de bot Slack stocké avec vos espaces de noms et noms de clés.

Exemple:

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 }}

Conseil

Si vous n'avez pas utilisé d'espace de noms, supprimez la partie :namespace de l'entrée du jeton, comme ceci : ${{ :secrets:my-app-bot-token }}

Envoie un message vers un canal Slack, avec une pièce jointe facultative.

Champ de saisie	optionnalité	Type	Description	Exemple
jeton	Requis	Secret	Le jeton du bot Slack à utiliser. Cela doit être transmis sous forme de syntaxe secrète. Reportez-vous à Ajouter la configuration Slack pour obtenir des instructions sur la configuration d'un jeton.	`${{ :secrets:slackToken }}`
canal	Requis	Chaîne	Le nom du canal, ou un ID de canal, pour envoyer le message. Consultez l'API Slack pour plus d'informations.	`my-slack-channel`
texte	Requis	Chaîne	Le message à publier sur Slack dans le `channel` spécifié.	`Hello World!`
filTs	Facultatif	Chaîne	Horodatage appartenant au message parent, utilisé pour créer une réponse de message dans un fil de discussion.	`<digits>.<digits>`
pièce jointe	Facultatif	Carte	Permet de joindre un fichier avec un message sur le `channel` spécifié.
pièce jointe.nom_de_fichier	Requis	Chaîne	Spécifiez le nom de fichier pour le fichier téléchargé dans Slack.	`file.txt`
pièce jointe.contenu	Requis	Chaîne	Le contenu du fichier à télécharger en UTF8.	`Hello\nWorld!`
sélecteurs	Facultatif	List	Les sélecteurs permettant d'obtenir uniquement les paramètres spécifiés en sortie.	`[{\"name\": \"threadTs\", \"expression\": \".threadTs\"}, {\"name\": \"channelID\", \"expression\": \".channelID\")\"}]`

Champ de sortie	Type	Description	Exemple
filTs	Chaîne	Horodatage du fil de discussion. Peut être utilisé dans les futurs appels `postMessage` pour publier une réponse dans un fil de discussion.	`<digits>.<digits>`
ID du canal	Chaîne	ID du canal où le message est publié.	`<string>`
succès	Booléen	État de la demande	`true / false`
message d'erreur	Chaîne	Motif de l'échec sous forme de message	`<string>`

Exemple 1 : Envoyer un message Slack

Exemple de workflow
`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"` Entrées : { "inputs": [ { "key": "channel", "value": "test-channel-workflow" }, { "key": "text", "value": "This is my message with bold text and `code backticks`" } ] } Résultat attendu : `[ { "threadTs": "1718897637.400609", "channelID": "C063JK1RHN1" "success": true } ]`

Exemple de workflow

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"

Entrées :

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

Résultat attendu :

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

Exemple 2 : Joindre un fichier

Exemple de workflow
`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!"` Résultat attendu : `[ { "threadTs": "1718897637.400609", "channelID": "C063JK1RHN1" "success": true } ]`

Exemple de workflow

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!"

Résultat attendu :

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

Obtenir une réaction à un message provenant d'un canal Slack.

Champ de saisie	optionnalité	Type	Description	Exemple
jeton	Requis	Secret	Le jeton du bot Slack à utiliser. Cela doit être transmis sous forme de syntaxe secrète. Reportez-vous à Ajouter la configuration Slack pour obtenir des instructions sur la configuration d'un jeton.	`${{ :secrets:slackToken }}`
ID du canal	Requis	Chaîne	L'ID de canal, pour obtenir les réactions aux messages. Voir la méthode`reactions.get`	`C063JK1RHN1`
temps mort	Facultatif	Int	Le temps en secondes pendant lequel il faut attendre une réaction. La valeur par défaut est de 60 s, le maximum autorisé est de 600 s (10 min).	60
filTs	Requis	Chaîne	Horodatage appartenant au message, utilisé pour obtenir la réaction de ce message.	`<digits>.<digits>`
sélecteurs	Facultatif	List	Les sélecteurs permettant d'obtenir uniquement les paramètres spécifiés en sortie.	`[{\"name\": \"reactions\", \"expression\": \".reactions \"}]`

Champ de sortie	Type	Description	Exemple
réactions	List	Liste d'éléments avec toutes les réactions capturées ou une liste vide si le délai d'attente est dépassé.	`<list>`
succès	Booléen	État de la demande	`true / false`
message d'erreur	Chaîne	Motif de l'échec sous forme de message	`Invalid slack token`

Exemple 1 : Slack obtient des réactions

Exemple de workflow
`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 }}` Entrées : `{ "inputs": [ { "key": "channelID", "value": "C063JK1RHN1" }, { "key": "threadTs", "value": "1718897637.400609" }, { "key": "selectors", "value": "[{\"name\": \"reactions\", \"expression\": \".reactions \"}]" } ] }` Sorties : `[ { "name": "grinning", "users": [ "W222222" ], "count": 1 }, { "name": "question", "users": [ "W333333" ], "count": 1 } ] or if it is timed out, []`

Exemple de workflow

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 }}

Entrées :

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

Sorties :

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

  or if it is timed out,
  []

Cette traduction automatique est fournie pour votre commodité.

Actions Slack

Aperçu

Prérequis

Configurer l'intégration Slack

Créer une application Slack

Configurer les autorisations OAuth

Ajouter l'application aux canaux

Configuration New Relic

Utiliser le jeton Slack dans les workflows

Conseil

Actions Slack

Publier un message sur le canal Slack

Obtenir une réaction à un message provenant d'un canal Slack

Cette traduction automatique est fournie pour votre commodité.

Actions Slack

Aperçu

Prérequis.css-21sua1{background:none;border:none;width:0;padding:0;}

Configurer l'intégration Slack

Créer une application Slack

Configurer les autorisations OAuth

Ajouter l'application aux canaux

Configuration New Relic

Utiliser le jeton Slack dans les workflows

Conseil

Actions Slack

Obtenir une réaction à un message provenant d'un canal Slack

Prérequis