Verdent Docs
Fonctionnalités principales

Messagerie instantanée

Assignez du travail à Manager depuis Telegram, Slack ou Feishu

Vous n'avez pas besoin d'être devant votre ordinateur pour assigner du travail à Manager. En connectant Telegram, Slack ou Feishu, vous pouvez envoyer des messages à Manager à tout moment, où que vous soyez, en utilisant des outils de chat familiers. Manager transforme vos messages en tâches structurées et commence à les exécuter : capturez une idée en faisant défiler votre téléphone, puis revenez plus tard pour voir le résultat.

Plateformes de messagerie instantanée prises en charge

PlateformeType
TelegramBot personnel
SlackBot d'espace de travail
FeishuBot d'entreprise

Chaque plateforme nécessite de créer un Bot dans sa console développeur, puis de terminer l'appairage dans Verdent. Une fois connecté, tout message que vous envoyez au Bot est transmis directement à Manager.


Processus de connexion

Le processus de connexion comporte deux étapes :

  1. Saisir le token — configuration des identifiants
  2. Envoyer un message pour l'appairage — lier le Bot à Manager

Tout se configure sur la page des paramètres de canal dans la barre latérale de Manager.

Comment accéder à la configuration

Ouvrir Ajouter un canal

Dans la barre latérale gauche de Manager, cliquez sur le bouton + en haut (Ajouter un canal).

Sélectionner une plateforme

Choisissez la plateforme que vous souhaitez connecter (Telegram, Slack ou Feishu).

Suivre les étapes guidées

Terminez la configuration en deux étapes dans le panneau latéral.


Configuration de Telegram

Étape 1 : créer un Bot et obtenir le token

Envoyer un message à BotFather

Trouvez @BotFather sur Telegram et envoyez /newbot.

Nommer votre bot

Suivez les invites pour fournir un nom d'affichage et un nom d'utilisateur.

Copier le token

Après la création, BotFather renvoie un token sous la forme 123456:ABC-DEF1234....

Coller dans Verdent

Collez le token dans le champ Bot Token du panneau de configuration Verdent et confirmez.

Étape 2 : appairage par message

Envoyer un message

Ouvrez votre nouveau bot dans Telegram et envoyez n'importe quel message (par exemple, hello).

Recevoir le code d'appairage

Le bot répond automatiquement avec un code d'appairage.

Confirmer dans Verdent

Saisissez le code dans le panneau Verdent et confirmez. La connexion est maintenant terminée.


Configuration de Slack

Étape 1 : créer une application Slack et obtenir les tokens

Créer une nouvelle application

Rendez-vous sur api.slack.com/apps et cliquez sur Create New App.

Utiliser le manifeste fourni

Choisissez From an app manifest et collez le manifeste JSON fourni par Verdent (un bouton de copie est disponible dans l'interface).

Sélectionner un espace de travail

Choisissez l'espace de travail Slack et créez l'application.

Copier les deux tokens

Dans les paramètres de l'application, repérez le Bot Token (xoxb-) et l'App Token (xapp-), puis collez les deux dans le panneau de configuration Verdent.

Exigence sur le nom de l'application : le nom doit comporter moins de 80 caractères et ne peut pas contenir de caractères chinois, japonais ou coréens.

Étape 2 : appairage par message

Comme pour Telegram : envoyez un message au bot, recevez le code d'appairage, puis saisissez-le dans Verdent pour terminer la connexion.


Configuration de Feishu

Feishu demande quelques étapes de plus que Telegram ou Slack : les permissions se configurent séparément et les événements doivent être souscrits manuellement. Ce n'est pas complexe, mais chaque étape doit être effectuée correctement, sinon la connexion restera bloquée. Suivez-les dans l'ordre.

Étape 1 : créer une application personnalisée

Ouvrir la console développeur

Rendez-vous sur la plateforme ouverte Feishu et connectez-vous avec votre compte Feishu.

Créer une application personnalisée

Cliquez sur Create Custom App en haut à droite.

Renseigner les informations de base

Saisissez le nom et la description de l'application, puis terminez la création.

Étape 2 : configurer les permissions

Ouvrez la nouvelle application et allez dans Permissions & Scopes dans le menu de gauche.

Feishu prend en charge l'importation groupée des scopes, vous n'avez donc pas besoin de les cocher un par un. Trouvez l'entrée d'import/export groupé sur la page et collez l'intégralité du JSON suivant :

{
  "scopes": {
    "tenant": [
      "im:message:send_as_bot",
      "im:message",
      "im:resource",
      "im:chat",
      "im:chat:readonly",
      "im:message.p2p_msg:readonly",
      "im:message.group_at_msg:readonly",
      "contact:contact.base:readonly",
      "contact:user.base:readonly",
      "contact:user.employee_id:readonly",
      "docs:document.content:read",
      "wiki:wiki:readonly",
      "application:application:self_manage"
    ],
    "user": []
  }
}

Après confirmation de l'import, tous les scopes ci-dessus doivent apparaître comme sélectionnés dans la liste des permissions.

Étape 3 : obtenir les identifiants et connecter Verdent

Ouvrez Credentials & Basic Info dans le menu de gauche :

Copier l'App ID et l'App Secret

Copiez l'App ID (sous la forme cli_xxx...) et l'App Secret.

Coller dans Verdent

Collez les deux valeurs dans les champs correspondants du panneau de configuration Verdent.

Connecter

Cliquez sur Connect pour terminer la première étape.

Étape 4 : activer la connexion longue

Une fois connecté, retournez sur la plateforme ouverte Feishu et ouvrez Events & Callbacks.

Activez Use Long Connection to Receive Events. Ce commutateur contrôle la façon dont Feishu délivre les messages au bot : la connexion longue ne nécessite pas d'exposer une URL publique ; elle maintient à la place une connexion persistante, ce qui est plus fiable.

Étape 5 : souscrire aux événements de message et publier

Toujours sur la page Events & Callbacks :

Ajouter l'événement de message

Cliquez sur Add Event, puis recherchez et ajoutez im.message.receive_v1 (événement de réception de message).

Créer et publier une version

Cliquez sur Create and Publish Version en haut à droite, renseignez les notes de version et confirmez.

Appairer avec Verdent

Après la publication, retournez sur Verdent et envoyez un message à votre bot Feishu pour terminer l'appairage.

Rôle de chaque permission

PermissionObjectif
Famille im:message:*Permet au bot de lire et d'envoyer des messages, y compris les messages directs et les mentions @ en groupe
im:chat:*Lit la liste des conversations auxquelles appartient le bot
im:resourceLit les images, fichiers et autres ressources jointes aux messages
contact:*Lit les informations de contact de base pour identifier qui a envoyé un message
docs:document.content:read / wiki:wiki:readonlyLit le contenu des Feishu Docs et Wiki, afin que les liens de documents puissent être transmis à Manager comme contexte
application:application:self_manageGère la configuration propre de l'application ; requis pour la capacité de connexion longue

Après une connexion réussie

Une fois l'appairage effectué, le canal apparaît dans la liste des canaux de la barre latérale gauche de Manager et affiche :

  • L'icône de la plateforme et le nom du canal
  • Le statut de connexion (Connecté / Déconnecté / Nécessite une attention)
  • Un aperçu et l'horodatage du dernier message
  • Un indicateur de message non lu (point vert)

À partir de ce moment, chaque message envoyé au Bot est traité directement par Manager comme une tâche exécutable.


Gestion des canaux connectés

  • Voir tous les canaux — tous les canaux de messagerie instantanée connectés sont listés dans la barre latérale.
  • Supprimer un canal — survolez un canal, cliquez sur supprimer, puis confirmez. S'il s'agit du dernier canal de ce type, la configuration du bot est également effacée.
  • Reconnecter — si un canal affiche Déconnecté ou Nécessite une attention, une invite de réparation apparaît en haut pour une reconfiguration.

Cas d'usage

Centre de commande mobile

En déplacement, dites au bot dans Telegram : "Déploie les derniers changements de la branche main sur staging." À votre retour, le résultat est prêt.

Collaboration en équipe

Mentionnez votre bot Manager dans un canal Slack pour résumer les statuts des PR du jour : les réponses apparaissent directement dans le canal, visibles par toute l'équipe.

Capture rapide d'idées

Avant de dormir, envoyez une idée au bot et demandez à Manager d'en faire une tâche à exécuter le lendemain.