# Messagerie instantanée (/fr/docs/verdent-manager/core-features/instant-messaging)

> 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 [#plateformes-de-messagerie-instantanée-prises-en-charge]

| Plateforme | Type                    |
| ---------- | ----------------------- |
| Telegram   | Bot personnel           |
| Slack      | Bot d'espace de travail |
| Feishu     | Bot 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 [#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 [#comment-accéder-à-la-configuration]

<Steps>
  <Step title="Ouvrir Ajouter un canal">
    Dans la barre latérale gauche de Manager, cliquez sur le bouton &#x2A;*+** en haut (Ajouter un canal).
  </Step>

  <Step title="Sélectionner une plateforme">
    Choisissez la plateforme que vous souhaitez connecter (Telegram, Slack ou Feishu).
  </Step>

  <Step title="Suivre les étapes guidées">
    Terminez la configuration en deux étapes dans le panneau latéral.
  </Step>
</Steps>

***

## Configuration de Telegram [#configuration-de-telegram]

### Étape 1 : créer un Bot et obtenir le token [#étape-1--créer-un-bot-et-obtenir-le-token]

<Steps>
  <Step title="Envoyer un message à BotFather">
    Trouvez [@BotFather](https://t.me/BotFather) sur Telegram et envoyez `/newbot`.
  </Step>

  <Step title="Nommer votre bot">
    Suivez les invites pour fournir un nom d'affichage et un nom d'utilisateur.
  </Step>

  <Step title="Copier le token">
    Après la création, BotFather renvoie un token sous la forme `123456:ABC-DEF1234...`.
  </Step>

  <Step title="Coller dans Verdent">
    Collez le token dans le champ **Bot Token** du panneau de configuration Verdent et confirmez.
  </Step>
</Steps>

### Étape 2 : appairage par message [#étape-2--appairage-par-message]

<Steps>
  <Step title="Envoyer un message">
    Ouvrez votre nouveau bot dans Telegram et envoyez n'importe quel message (par exemple, `hello`).
  </Step>

  <Step title="Recevoir le code d'appairage">
    Le bot répond automatiquement avec un code d'appairage.
  </Step>

  <Step title="Confirmer dans Verdent">
    Saisissez le code dans le panneau Verdent et confirmez. La connexion est maintenant terminée.
  </Step>
</Steps>

***

## Configuration de Slack [#configuration-de-slack]

### Étape 1 : créer une application Slack et obtenir les tokens [#étape-1--créer-une-application-slack-et-obtenir-les-tokens]

<Steps>
  <Step title="Créer une nouvelle application">
    Rendez-vous sur [api.slack.com/apps](https://api.slack.com/apps) et cliquez sur **Create New App**.
  </Step>

  <Step title="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).
  </Step>

  <Step title="Sélectionner un espace de travail">
    Choisissez l'espace de travail Slack et créez l'application.
  </Step>

  <Step title="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.
  </Step>
</Steps>

<Note>
  **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.
</Note>

### Étape 2 : appairage par message [#étape-2--appairage-par-message-1]

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 [#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 [#étape-1--créer-une-application-personnalisée]

<Steps>
  <Step title="Ouvrir la console développeur">
    Rendez-vous sur la [plateforme ouverte Feishu](https://open.feishu.cn/app) et connectez-vous avec votre compte Feishu.
  </Step>

  <Step title="Créer une application personnalisée">
    Cliquez sur **Create Custom App** en haut à droite.
  </Step>

  <Step title="Renseigner les informations de base">
    Saisissez le nom et la description de l'application, puis terminez la création.
  </Step>
</Steps>

### Étape 2 : configurer les permissions [#é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 :

```json
{
  "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 [#étape-3--obtenir-les-identifiants-et-connecter-verdent]

Ouvrez **Credentials & Basic Info** dans le menu de gauche :

<Steps>
  <Step title="Copier l'App ID et l'App Secret">
    Copiez l'**App ID** (sous la forme `cli_xxx...`) et l'**App Secret**.
  </Step>

  <Step title="Coller dans Verdent">
    Collez les deux valeurs dans les champs correspondants du panneau de configuration Verdent.
  </Step>

  <Step title="Connecter">
    Cliquez sur **Connect** pour terminer la première étape.
  </Step>
</Steps>

### Étape 4 : activer la connexion longue [#é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 [#étape-5--souscrire-aux-événements-de-message-et-publier]

Toujours sur la page **Events & Callbacks** :

<Steps>
  <Step title="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).
  </Step>

  <Step title="Créer et publier une version">
    Cliquez sur **Create and Publish Version** en haut à droite, renseignez les notes de version et confirmez.
  </Step>

  <Step title="Appairer avec Verdent">
    Après la publication, retournez sur Verdent et envoyez un message à votre bot Feishu pour terminer l'appairage.
  </Step>
</Steps>

### Rôle de chaque permission [#rôle-de-chaque-permission]

| Permission                                          | Objectif                                                                                                                |
| --------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| 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:resource`                                       | Lit 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:readonly` | Lit le contenu des Feishu Docs et Wiki, afin que les liens de documents puissent être transmis à Manager comme contexte |
| `application:application:self_manage`               | Gère la configuration propre de l'application ; requis pour la capacité de connexion longue                             |

***

## Après une connexion réussie [#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 [#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 [#cas-dusage]

<CardGroup cols="3">
  <Card title="Centre de commande mobile" icon="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.
  </Card>

  <Card title="Collaboration en équipe" icon="users">
    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.
  </Card>

  <Card title="Capture rapide d'idées" icon="lightbulb">
    Avant de dormir, envoyez une idée au bot et demandez à Manager d'en faire une tâche à exécuter le lendemain.
  </Card>
</CardGroup>