Retour au centre d’aide

Connecter Feishu à Elisi Agent

Connecter un bot Feishu à Elisi Agent

Après la configuration, vous pouvez discuter en privé avec votre bot d’entreprise dans Feishu. Elisi Agent peut alors enregistrer ou rechercher des tâches, des listes et d’autres éléments.

Avant de commencer

Vous avez besoin de :

  • Un compte Elisi.
  • L’autorisation de créer et publier une application personnalisée Feishu.
  • L’approbation de l’administrateur de votre entreprise pour les autorisations de l’application, si nécessaire.

1. Créer une application Feishu

  1. Ouvrez la plateforme ouverte Feishu et accédez à la console développeur.
  2. Créez une application personnalisée d’entreprise.
  3. Dans Ajouter des capacités d’application, activez Bot.
  4. Dans Autorisations, ajoutez :
    • Lire les messages privés envoyés au bot.
    • Envoyer des messages en tant qu’application.
    • Pour utiliser le bot dans les groupes, ajoutez aussi l’autorisation de recevoir les messages qui le mentionnent.

Notez l’App ID et l’App Secret.

2. Connecter le bot dans Elisi

  1. Ouvrez les Paramètres dans Elisi.
  2. Dans Elisi AI, sélectionnez Bot Feishu / Lark.
  3. Choisissez Feishu comme plateforme. Sélectionnez Lark si vous utilisez le service international Lark.
  4. Indiquez un nom de bot facultatif, l’App ID, l’App Secret et le Verification Token affiché dans la console Feishu.
  5. Sélectionnez Connecter le bot.

Après vérification, Elisi affiche :

  • Une URL de callback d’événements.
  • Une commande à usage unique pour associer le compte.

L’App Secret n’est affiché qu’une seule fois. Elisi le stocke de manière chiffrée et ne l’envoie pas à l’Agent.

3. Configurer les callbacks d’événements

Retournez sur la plateforme ouverte Feishu :

  1. Ouvrez Événements et callbacks ou Abonnements aux événements.

  2. Sélectionnez Envoyer les événements à un serveur développeur.

  3. Copiez l’URL de callback d’événements d’Elisi et collez-la comme URL de requête.

  4. Laissez Encrypt Key vide.

  5. Enregistrez l’URL et attendez la confirmation de Feishu.

  6. Sélectionnez Ajouter un événement et ajoutez :

    Recevoir des messages (im.message.receive_v1)

La vérification de l’URL ne suffit pas : vous devez aussi ajouter im.message.receive_v1.

4. Publier et installer l’application

  1. Créez une nouvelle version dans la plateforme ouverte Feishu.
  2. Vérifiez qu’elle comprend les autorisations et l’événement de message ajoutés.
  3. Soumettez-la à la vérification et publiez-la. Si nécessaire, obtenez d’abord l’approbation de l’administrateur.
  4. Installez l’application dans l’entreprise et vérifiez que votre compte Feishu fait partie des utilisateurs autorisés.

Après toute modification des autorisations ou des événements, publiez une nouvelle version pour qu’elle soit prise en compte.

5. Associer votre compte Elisi

La configuration et la publication prennent souvent plus de 15 minutes. Une fois l’application publiée, revenez dans Elisi :

  1. Sur la carte du bot, sélectionnez Générer un nouveau code d’association.

  2. Copiez la commande complète à usage unique, par exemple :

    /elisi-bind AbCdEf123

  3. Dans les 15 minutes, ouvrez une conversation privée avec le bot et envoyez la commande.

  4. Après le message de réussite, revenez dans Elisi et actualisez le statut.

La configuration est terminée lorsque le statut passe de En attente d’association à Connecté. La première association doit se faire dans une conversation privée, pas dans un groupe.

6. Utiliser le bot

  • Conversation privée : Envoyez directement du texte au bot.
  • Groupe : Un utilisateur associé doit mentionner le bot dans son message.
  • Déconnecter : Sélectionnez Déconnecter sur la carte du bot dans Elisi.

La version actuelle accepte les messages texte. Elle ne prend pas en charge les callbacks chiffrés avec Encrypt Key, les pièces jointes, les cartes interactives ni le partage d’un compte Elisi entre plusieurs personnes.

Dépannage

Problème Vérifications
La vérification de l’URL échoue ou aucun challenge n’est renvoyé Vérifiez que l’URL est complète et que le Verification Token correspond. Effacez Encrypt Key puis enregistrez de nouveau.
L’URL est vérifiée, mais le bot ne répond pas en privé Vérifiez que im.message.receive_v1 a été ajouté. Après avoir ajouté événements et autorisations, republiez, faites approuver et installez la dernière version.
Elisi affiche toujours « En attente d’association » Générez un nouveau code et envoyez la commande complète dans une conversation privée sous 15 minutes. Les anciens codes expirent.
Le compte est associé, mais le bot ne répond pas Vérifiez que l’autorisation d’envoyer des messages en tant qu’application est approuvée et incluse dans la dernière version publiée.
Le bot ne répond pas dans un groupe Associez d’abord le compte en privé. Ensuite, un utilisateur associé doit mentionner le bot dans le groupe.
Le bot est introuvable ou impossible à contacter Vérifiez que l’application est installée et que votre compte fait partie des utilisateurs autorisés.

Si le problème persiste, vérifiez dans la plateforme ouverte Feishu, sous Journaux de transmission d’événements, si im.message.receive_v1 apparaît. En l’absence de journal, l’événement, les autorisations, la version publiée ou le périmètre d’utilisation ne sont peut-être pas encore actifs.