Slack — envoyer une notification depuis le bot

À quoi ça sert

L’action Envoyer un message Slack permet à votre bot de publier un message dans un canal Slack à des moments clés de la conversation : escalade vers une équipe humaine, alerte commerciale, notification interne d’un cas particulier, etc.

Quelques exemples d’usage :

• Prévenir le canal #support qu’un client demande à parler à un humain.
• Envoyer un message dans #ventes quand un visiteur laisse un e-mail qualifié.
• Alerter #alertes-tech quand le bot reçoit une réclamation urgente.

Le bot ne lit jamais Slack en retour : c’est une notification sortante uniquement.

Comment ça marche techniquement

Sens-AI utilise les webhooks entrants Slack (« Incoming Webhooks »). C’est la méthode officielle Slack pour qu’une application tierce poste des messages, sans avoir à gérer de jeton OAuth complexe.

• Vous créez une application Slack dans votre espace de travail.
• Slack vous donne une URL de webhook unique, liée à un canal précis que vous choisissez à la création.
• Sens-AI envoie une requête HTTP POST à cette URL à chaque exécution de l’action.

Pré-requis

• Un espace de travail Slack où vous avez le droit d’installer des applications (admin ou autorisation accordée par l’admin).
• 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 Bot » (ou le nom que vous voulez voir apparaître 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 le bouton Activate Incoming Webhooks (en haut à droite).
3. En bas de la page, cliquez sur Add New Webhook to Workspace.
4. Slack vous demande dans quel canal poster les messages. Choisissez-le (ex. : #support, #ventes).
5. Cliquez sur Autoriser.

Slack revient sur la page Incoming Webhooks avec votre Webhook URL affichée dans la liste. Elle ressemble à :

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

Copiez-la — vous en aurez besoin à l’étape suivante.

Important : cette URL autorise n’importe qui à publier dans le canal choisi. Traitez-la comme un mot de passe : ne la partagez pas publiquement, ne la commitez pas dans un dépôt Git, ne la collez pas dans un ticket support en clair.

Étape 2.5 — Créer le connecteur Slack dans Sens-AI

L’URL du webhook ne se colle pas directement sur l’action : elle est stockée sur un connecteur Slack réutilisable. Vous créez le connecteur une fois, puis vous l’attachez à autant d’actions Slack que vous voulez.

1. Dashboard Sens-AI → Connecteurs → Ajouter un connecteur.
2. Choisissez Slack dans la liste des types disponibles.
3. Nom du connecteur : ex. « Slack — #support » (utilisez le nom du canal cible pour vous y retrouver).
4. Webhook URL : collez l’URL copiée à l’étape 2.
5. Enregistrer.

Le connecteur est maintenant disponible pour vos actions Slack.

Étape 3 — Ajouter l’action dans Sens-AI

1. Dashboard Sens-AI → votre bot → Actions → Ajouter une action.
2. Dans le catalogue, sélectionnez Slack — Envoyer un message Slack.
3. Connecteur Slack : sélectionnez le connecteur créé à l’étape 2.5. L’URL du webhook est lue depuis ce connecteur — il n’y a pas de champ « Webhook URL » sur l’action elle-même.
4. Nom de l’action : ex. « Notifier l’équipe support sur Slack ».
5. Description (pour l’IA) : expliquez clairement quand le bot doit utiliser cette action. Exemple : « Envoie une notification dans le canal support Slack quand le client demande à parler à un humain ou signale un problème urgent. »
6. Enregistrer.

Étape 4 — Tester

Avant de mettre l’action en production :

1. Ouvrez l’action depuis le dashboard → bouton Tester cette action.
2. Remplissez le champ text avec un message de test : par exemple Test depuis Sens-AI — à ignorer.
3. Cliquez sur Exécuter.
4. Allez vérifier dans Slack que le message est bien arrivé dans le bon canal.

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

Paramètres exposés au bot

L’action accepte deux paramètres que le bot remplit à partir de la conversation :

Le bot construit lui-même la valeur du text à partir du contexte de la conversation, en suivant l’instruction que vous avez écrite dans le champ « Description (pour l’IA) ».

Limitations

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

• Notification sortante uniquement. Le bot ne reçoit aucune réponse des utilisateurs Slack. Si quelqu’un répond au message dans Slack, le bot ne le saura pas. Pour un vrai dialogue, utilisez le canal Slack natif via une intégration distincte.
• Un webhook = un canal. Le canal est fixé à la création du webhook côté Slack. Le paramètre channel est conservé dans le contrat mais la majorité des webhooks entrants modernes l’ignorent : Slack postera dans le canal autorisé à l’étape 2, point. Pour poster dans un autre canal, créez un deuxième webhook et une deuxième action.
• Pas de pièces jointes ni de fichiers. L’action n’envoie que du texte (avec mise en forme mrkdwn). Pour envoyer une image ou un fichier, il faut passer par l’API Slack complète, qui n’est pas couverte par ce modèle d’action.
• Pas de réactions, de threads, de mentions structurées avancées. Vous pouvez mentionner un utilisateur en écrivant <@U12345> dans le texte si vous connaissez son ID Slack, mais le modèle d’action ne fournit pas d’aide pour les retrouver.
• Domaine restreint à hooks.slack.com. L’action refuse toute autre URL — c’est une protection contre les fuites accidentelles vers un autre serveur. Si votre URL ne commence pas par https://hooks.slack.com/services/, elle sera rejetée.
• Délai d’appel : 10 secondes. Si Slack ne répond pas en moins de 10 secondes, l’action échoue. C’est très rare en pratique.

Dépannage

Le message n’arrive pas dans Slack

• L’URL est-elle bien collée en entier ? Une URL tronquée donne un 404. Recopiez depuis Slack et recollez.
• Le webhook est-il toujours actif ? Allez sur api.slack.com/apps → votre app → Incoming Webhooks. Si vous ne voyez plus votre webhook dans la liste, il a été révoqué — créez-en un nouveau et mettez à jour l’action.
• L’application Slack a-t-elle été désinstallée de l’espace ? Un admin qui supprime l’app casse tous les webhooks associés. Recréez l’app si besoin.

Erreur « invalid_payload »

Slack refuse le corps de la requête. Cause habituelle : un caractère interdit dans le texte. Évitez les guillemets non échappés et raccourcissez le message pour isoler le problème.

Erreur « channel_not_found »

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

Erreur 403 ou 404 sur l’URL

L’URL ne ressemble pas à un webhook Slack valide, ou elle a été révoquée. Vérifiez qu’elle commence bien par https://hooks.slack.com/services/ et regé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 à auditer.
• Nommez vos actions par canal cible. Ex. : « Slack — #support », « Slack — #ventes ». Évite la confusion quand vous en avez plusieurs.
• Gardez les messages courts. Slack tronque les messages très longs dans les notifications mobiles. Visez 1 à 3 lignes utiles.
• Si l’URL fuit : révoquez-la immédiatement depuis api.slack.com/apps → votre app → Incoming Webhooks → corbeille à côté de l’URL. Créez-en une nouvelle et mettez à jour l’action.

Étape suivante

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