Passer au contenu principal
Lark (international) et Feishu (Chine) permettent à l’assistant de répondre à un message direct et à une @mention dans un groupe. Choisissez le domaine qui correspond à la console où l’application a été créée.

Quand l’utiliser

Utilisez Lark si l’entreprise discute sur larksuite.com, et Feishu si elle discute sur feishu.cn. Une connexion Famulor utilise une application et un domaine.

Ce que l’assistant entend

L’assistant entend l’événement im.message.receive_v1 : messages directs, et messages de groupe qui mentionnent le bot. Publiez une version et accordez les portées de ces conversations avant le premier message.

Où trouver les clés

Le guide du fournisseur lié montre les écrans de ces clics. Suivez les clics ci-dessous avec ces images. L’App ID, l’App Secret et le Verification Token existent déjà sur l’application, avant l’URL Famulor. Les applications internationales se créent sur open.larksuite.com/app. Les applications Chine sur open.feishu.cn/app. L’événement est documenté sur Receive message.

Le créer chez le fournisseur

  1. Ouvrez la console développeur Lark ou Feishu et connectez-vous.
  2. Créez une custom app. Copiez l’App ID (elle commence par cli_) et l’App Secret.
  3. Ouvrez les abonnements d’événements. Copiez le Verification Token. Réinitialisez-le là si vous en voulez un nouveau.
  4. Ajoutez une Encrypt Key seulement si vous activez le chiffrement. Les événements arrivent alors chiffrés et Famulor a besoin de la même clé.
  5. Abonnez im.message.receive_v1.
  6. Activez le bot. Ajoutez les portées des messages directs et, pour les groupes, des messages qui mentionnent le bot.
  7. Créez et publiez une version pour que le bot puisse être installé.

Le connecter dans Famulor

Votre forfait inclut ce canal. Ouvrez Settings → Channels, choisissez la carte, nommez la connexion, sélectionnez un assistant et enregistrez. Les paramètres de conversation communs — délai de réponse (5 secondes par défaut) et délai d’inactivité (30 minutes par défaut) — sont décrits sur la page canaux de messagerie. Sur la carte Lark / Feishu, choisissez Lark (International — larksuite.com) ou Feishu (China — feishu.cn). Collez App ID, App Secret et Verification Token. Collez Encrypt Key seulement si l’application en utilise une. Après l’enregistrement, ouvrez le menu de la connexion et choisissez Copy webhook URL. Collez cette adresse exacte chez le fournisseur. Un domaine personnalisé vérifié fait déjà partie de l’adresse affichée.

Pointer le fournisseur vers Famulor

  1. Copiez l’URL de webhook Famulor.
  2. Dans l’abonnement d’événements, mettez l’URL de requête sur cette adresse et enregistrez. La console vérifie le jeton.
  3. Installez l’application publiée pour les personnes qui doivent discuter avec le bot.
  4. Envoyez un message direct au bot, ou mentionnez-le avec @ dans un groupe. Le fil apparaît dans l’historique.

Historique

Ouvrez l’historique et filtrez par Lark / Feishu. Le fil, la réponse de l’assistant et l’analyse éventuelle y apparaissent. Vous pouvez mettre l’assistant en pause et répondre vous-même.

API, MCP et ligne de commande

La même connexion se crée avec l’API publique, l’outil MCP create_messaging_connector ou la ligne de commande. Remplacez les exemples par vos propres valeurs.