Slack — envoyer une notification depuis le bot

Configurer l'action Slack pour que votre bot publie un message dans un canal Slack via un webhook entrant.

Dernière mise à jour :

À quoi ça sert

L’action Envoyer un message Slack permet à votre agent de publier un message dans un canal Slack de votre équipe pendant une conversation.

Sens Ai donne à l’agent une consigne précise pour ce modèle : ne l’utiliser que si la personne demande explicitement d’envoyer un message ou de prévenir quelqu’un via Slack, et lui demander d’abord le contenu du message. Testez donc vos scénarios en conditions réelles, depuis l’entrée Test du menu de gauche.

L’agent ne lit jamais Slack en retour : c’est une notification sortante uniquement.

Pour être prévenu quand un client veut parler à un humain, utilisez plutôt la compétence Transfert vers un humain et ses notifications par e-mail : voir Prise en charge humaine.

Comment ça marche techniquement

Sens Ai utilise les webhooks entrants de Slack (« Incoming Webhooks »), la méthode officielle de Slack pour qu’une application tierce poste des messages :

  • vous créez une application Slack dans votre espace de travail ;
  • Slack vous donne une adresse de webhook unique, liée à un canal précis choisi à la création ;
  • Sens Ai envoie une requête à cette adresse à chaque exécution de l’action.

Prérequis

  • Un espace de travail Slack où vous avez le droit d’installer des applications (administrateur, ou autorisation de l’administrateur).
  • Le canal Slack de destination doit exister avant la création du webhook.

Étape 1 — Créer l’application Slack

  1. Allez sur api.slack.com/apps en étant connecté à votre espace de travail.
  2. Cliquez sur Create New App → From scratch.
  3. App Name : « Sens Ai » (ou le nom que vous voulez voir comme expéditeur du message).
  4. Pick a workspace : choisissez votre espace de travail.
  5. Cliquez sur Create App.

Étape 2 — Activer les Incoming Webhooks

  1. Dans la page de votre application, ouvrez le menu de gauche Features → Incoming Webhooks.
  2. Activez Activate Incoming Webhooks.
  3. En bas de la page, cliquez sur Add New Webhook to Workspace.
  4. Choisissez le canal où poster les messages (ex. : #support, #ventes).
  5. Cliquez sur Autoriser.

Slack affiche votre Webhook URL, de la forme :

https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX

Copiez-la pour l’étape suivante.

Important : cette adresse permet à n’importe qui de publier dans le canal choisi. Traitez-la comme un mot de passe : ne la partagez pas, ne la collez pas en clair dans un ticket.

Étape 3 — Créer le connecteur Slack dans Sens Ai

L’adresse du webhook ne se colle pas sur l’action : elle est stockée dans un connecteur Slack réutilisable.

  1. Dans le menu du haut, cliquez sur Intégrations, onglet Catalogue, puis Configurer sur Slack.
  2. Nom : par exemple « Slack — #support » (le nom du canal cible, pour vous y retrouver).
  3. URL du Webhook : collez l’adresse copiée à l’étape 2. Elle est chiffrée et ne sera plus réaffichée.
  4. Cliquez sur Créer.

Le connecteur Slack n’a pas de test de connexion : sa carte n’a pas de bouton Tester. Testez plutôt l’action (étape 5).

Étape 4 — Créer l’action

  1. Dans le menu de gauche de l’agent : Configuration Agent › Compétences › onglet Catalogue › Configurer sur Envoyer un message Slack.
  2. Description pour l’agent : donnez un Nom explicite, par exemple « Prévenir l’équipe support sur Slack ».
  3. Configuration › Connecteur : choisissez le connecteur de l’étape 3 (ou Créer un connecteur s’il n’en existe aucun, Nouveau pour en créer un autre). Il n’y a pas d’autre réglage.

Étape 5 — Tester, puis créer

  1. Section Test : Tester l’action.
  2. Dans le champ text, saisissez un message de test, par exemple Test depuis Sens Ai — à ignorer.
  3. Cliquez sur Lancer le test : le résultat doit indiquer Succès et « Message envoyé sur Slack ».
  4. Vérifiez dans Slack que le message est arrivé dans le bon canal.
  5. Cliquez sur Créer.

Si rien n’arrive : voir Dépannage ci-dessous.

Ce que l’agent remplit

InformationObligatoireDescription
textOuiLe message à poster, 3 000 caractères au plus (au-delà, il est coupé et se termine par « … »). Accepte la mise en forme mrkdwn de Slack (gras avec *texte*, italique avec _texte_, code avec `texte`, listes, liens).

L’agent rédige le text à partir de la conversation et de ce que la personne lui a demandé de transmettre. Le message part toujours dans le canal du webhook.

Les champs à collecter sont ajoutés à la fin du message. Si le tout dépasse 3 000 caractères, c’est le texte de l’agent qui est raccourci : les informations collectées restent entières (sauf si elles dépassent à elles seules 3 000 caractères).

Limites

À lire avant de promettre quoi que ce soit à votre équipe.

  • Notification sortante uniquement. L’agent ne reçoit aucune réponse de Slack. Si quelqu’un répond au message dans Slack, l’agent ne le saura pas.
  • Un webhook = un canal. Le canal est fixé à la création du webhook côté Slack. Pour poster dans un autre canal, créez un deuxième webhook, un deuxième connecteur et une deuxième action.
  • Pas de pièces jointes ni de fichiers. L’action n’envoie que du texte mis en forme.
  • Pas de réactions ni de fils de discussion. Vous pouvez mentionner un utilisateur avec <@U12345> si vous connaissez son identifiant Slack.
  • Adresses hooks.slack.com uniquement. L’action refuse toute adresse dont le domaine n’est pas exactement hooks.slack.com, ou qui n’est pas en https://.
  • Délai de 10 secondes. Si Slack ne répond pas à temps, l’action échoue. C’est très rare en pratique.

Dépannage

Le message n’arrive pas dans Slack

  • L’adresse est-elle complète ? Une adresse tronquée donne une erreur 404. Recopiez-la depuis Slack, puis mettez à jour le connecteur (Intégrations › Mes connecteurs › Modifier).
  • Le webhook est-il toujours actif ? Sur api.slack.com/apps → votre application → Incoming Webhooks : s’il n’apparaît plus, il a été révoqué. Créez-en un nouveau et mettez à jour le connecteur.
  • L’application Slack a-t-elle été désinstallée ? Un administrateur qui supprime l’application casse tous ses webhooks.

Le Journal de l’action (page de l’action) indique le statut de chaque envoi et, en cas d’erreur, le code renvoyé par Slack.

Erreur « invalid_payload »

Slack refuse le contenu du message. Raccourcissez le message de test pour isoler le caractère en cause.

Erreur « channel_not_found »

Le canal du webhook a été supprimé ou archivé. Créez un nouveau webhook vers un canal existant.

Erreur 403 ou 404

L’adresse n’est pas un webhook Slack valide, ou elle a été révoquée. Vérifiez qu’elle commence par https://hooks.slack.com/services/ et régénérez-la côté Slack si besoin.

Bonnes pratiques

  • Un webhook par canal de destination. Plus simple à révoquer en cas de fuite, plus clair à suivre.
  • Nommez connecteurs et actions par canal cible. Ex. : « Slack — #support », « Slack — #ventes ».
  • Gardez les messages courts. Slack tronque les longs messages dans les notifications mobiles.
  • Si l’adresse fuit : révoquez-la sur api.slack.com/apps → votre application → Incoming Webhooks, créez-en une nouvelle et mettez à jour le connecteur.

Étape suivante

Pour tester et déboguer l’action en cas de problème : Tester et déboguer une action.

Cet article vous a-t-il été utile ?

À lire aussi dans cette section