> ## 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 und Feishu

> Lark- oder Feishu-Direktnachrichten und @Erwähnungen in Gruppen beantworten

Lark (international) und Feishu (China) lassen den Assistenten eine Direktnachricht und eine @Erwähnung in einer Gruppe beantworten. Wähle die Domain, die zur Konsole passt, in der du die App angelegt hast.

## Wann du ihn nutzt

Nutze Lark, wenn das Unternehmen auf larksuite.com chattet, und Feishu, wenn es auf feishu.cn chattet. Eine Famulor-Verbindung nutzt eine App und eine Domain.

## Was der Assistent hört

Der Assistent hört das Ereignis **im.message.receive\_v1**: Direktnachrichten und Gruppennachrichten, die den Bot erwähnen. Veröffentliche eine App-Version und vergebe die Berechtigungen für diese Unterhaltungen, bevor die erste Nachricht kommt.

## Woher die Schlüssel kommen

Die verlinkte Anbieter-Anleitung zeigt die Bildschirme zu diesen Klicks. Folge den Klicks unten zusammen mit diesen Bildern.

App-ID, App-Secret und Verification Token existieren schon in der App, bevor du die Famulor-URL hast. Internationale Apps entstehen unter [open.larksuite.com/app](https://open.larksuite.com/app). Apps für China unter [open.feishu.cn/app](https://open.feishu.cn/app). Das Empfangsereignis ist dokumentiert unter [Receive message](https://open.larksuite.com/document/server-docs/im-v1/message/events/receive).

## Beim Anbieter anlegen

1. Öffne die Lark- oder Feishu-Entwicklerkonsole und melde dich an.
2. Lege eine **custom app** an. Kopiere die **App ID** (sie beginnt mit `cli_`) und das **App Secret**.
3. Öffne die Ereignisabos. Kopiere das **Verification Token**. Setze es dort zurück, wenn du ein neues brauchst.
4. Lege einen **Encrypt Key** nur an, wenn du Verschlüsselung einschaltest. Dann kommen Ereignisse verschlüsselt an und Famulor braucht denselben Schlüssel.
5. Abonniere **im.message.receive\_v1**.
6. Aktiviere den Bot. Füge die Berechtigungen für Direktnachrichten hinzu und, wenn du Gruppen willst, für Gruppennachrichten, die den Bot erwähnen.
7. Erstelle und veröffentliche eine App-Version, damit der Bot installiert werden kann.

## In Famulor verbinden

Dein Plan enthält diesen Kanal. Öffne **Settings → Channels**, wähle die Karte, benenne die Verbindung, wähle einen Assistenten und speichere. Die gemeinsamen Konversationseinstellungen — Antwortverzögerung (Standard 5 Sekunden) und Inaktivitätszeit (Standard 30 Minuten) — stehen auf der Seite [Messaging-Kanäle](https://docs.famulor.io/de/channels/messaging.md).

Wähle auf der Karte **Lark / Feishu** **Lark (International — larksuite.com)** oder **Feishu (China — feishu.cn)**. Füge **App ID**, **App Secret** und **Verification Token** ein. **Encrypt Key** nur, wenn die App einen nutzt.

Öffne nach dem Speichern das Menü der Verbindung und wähle **Copy webhook URL**. Füge genau diese Adresse beim Anbieter ein. Eine verifizierte eigene Domain ist in der angezeigten Adresse bereits enthalten.

## Den Anbieter auf Famulor zeigen lassen

1. Kopiere die Famulor-Webhook-URL.
2. Setze in den Ereignisabos der App die Request-URL auf diese Adresse und speichere. Die Konsole prüft das Verification Token.
3. Installiere die veröffentlichte App für die Personen, die damit chatten sollen.
4. Schick dem Bot eine Direktnachricht oder erwähne ihn mit @ in einer Gruppe. Der Thread erscheint im Verlauf.

## Verlauf

Öffne den [Verlauf](https://docs.famulor.io/de/monitoring/history.md) und filtere nach **Lark / Feishu**. Der Thread, die Antwort des Assistenten und eine vorhandene Auswertung erscheinen dort. Du kannst den Assistenten pausieren und selbst antworten.

## API, MCP und Kommandozeile

Dieselbe Verbindung lässt sich über die öffentliche API, das MCP-Tool `create_messaging_connector` oder die Kommandozeile anlegen. Ersetze die Platzhalter durch deine eigenen Werte.

```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.