> ## Documentation Index
> Fetch the complete documentation index at: https://docs.famulor.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Lark et Feishu

> Répondre aux messages directs Lark ou Feishu et aux @mentions de groupe

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](https://open.larksuite.com/app). Les applications Chine sur [open.feishu.cn/app](https://open.feishu.cn/app). L'événement est documenté sur [Receive message](https://open.larksuite.com/document/server-docs/im-v1/message/events/receive).

## 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](https://docs.famulor.io/fr/channels/messaging.md).

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](https://docs.famulor.io/fr/monitoring/history.md) 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.

```bash theme={null}
famulor create-messaging-connector --platform lark --name "Support" \
  --assistant-id ASSISTANT_UUID --domain lark --app-id cli_… --app-secret APP_SECRET --verification-token VERIFY_TOKEN
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.