Skip to main content

​
À quoi ça sert

L’intégration Slack permet à votre agent de publier un message dans un canal pendant l’appel : compte rendu de conversation, demande de rappel, alerte pour l’équipe. Le message arrive dans le canal relié au webhook entrant que vous avez créé. Comme pour les autres intégrations, vous branchez votre propre espace : Bookivox ne fournit aucun identifiant. Il n’y a aucune clé à créer : c’est l’URL du webhook qui porte le secret.
Cette intégration est en écriture seule : elle publie un message, elle ne lit jamais votre historique Slack. Le client fournit sa propre URL de webhook ; Bookivox ne fournit aucun identifiant.

​
Ce qu’il faut préparer

L’URL est le secret. Toute personne qui la détient peut publier dans le canal : ne la partagez pas et ne la collez pas dans un billet ou un ticket.

​
Connecter Slack

1

Créer l'application Slack

Dans Slack, créez une application dédiée à Bookivox et activez la fonctionnalité Incoming Webhooks.
2

Ajouter un webhook au canal

Ajoutez un webhook et choisissez le canal de destination. Le canal est lié au webhook.
3

Copier l'URL

Copiez l’URL générée : elle commence par https://hooks.slack.com/services/.
4

Coller l'URL dans Bookivox

Dans Intégrations → Slack, collez l’URL du webhook. Le formulaire vérifie son format avant l’enregistrement.
5

Cocher l'action

Sélectionnez Envoyer un message. L’action devient un outil indépendant.
6

Vérifier la connexion

Cliquez sur Créer les outils. Un bandeau vert confirme la création et indique le nombre d’outils créés. L’URL apparaît masquée : elle n’est jamais réaffichée en clair.
7

Compléter la connexion

La carte Connexions Slack liste les canaux reliés à l’organisation avec leur état (Complète ou Partielle). Le bouton Créer ajoute l’action manquante sans ressaisir l’URL.

​
Ce que l’agent peut faire

Chaque action crée un outil distinct : même s’il n’y en a qu’une ici, elle peut être attachée à un agent, et à lui seul.
Le message utilise le formatage Slack (*gras*, _italique_, liens). Le canal est celui du webhook par défaut ; le paramètre channel ne permet de publier ailleurs que si le webhook l’autorise.

​
Cas d’usage

​
Comment ça marche

  1. Aucune credential n’est créée : l’URL du webhook est elle-même le secret.
  2. Bookivox utilise cette URL telle quelle comme adresse de l’outil : pas d’URL de base, pas de chemin ajouté.
  3. Un outil http_api est créé, en POST, avec config.provider = "slack", config.operation = "send_message" et un timeout de 10 000 ms.
  4. Le paramètre text est obligatoire ; channel, username, icon_emoji et blocks (Block Kit) sont facultatifs et permettent un message plus structuré.
  5. L’URL est masquée à l’affichage dans Bookivox et masquée dans les logs de l’API : seule la première partie du chemin reste lisible.
En cas de fuite de l’URL, régénérez le webhook côté Slack. Supprimer l’outil dans Bookivox ne suffit pas : l’URL reste valide tant qu’elle n’a pas été révoquée dans Slack.

​
Rédiger la description de l’outil

La description de l’outil est ce qui décide quand l’agent publie sur Slack. Rédigez-la comme une consigne :
Un envoi Slack est visible par toute l’équipe et ne peut pas être annulé. Précisez dans la description les cas autorisés, et évitez d’y placer des données personnelles inutiles : le message est conservé dans l’historique du canal.

​
Sécurité

​
Ce qui est déconseillé

​
Limites et dépannage

Slack n’est pas relié ici par un serveur MCP ni par une application OAuth : l’outil passe par un webhook entrant, ce qui évite de stocker un jeton d’accès à votre espace de travail.

Intégrations

Toutes les intégrations et les catégories d’outils.

API HTTP

Comprendre les outils HTTP : paramètres, presets, credentials.
Last modified on November 3, 2026