Feishu mit Elisi Agent verbinden

Einen Feishu-Bot mit Elisi Agent verbinden

Nach der Einrichtung kannst du dem Unternehmens-Bot in Feishu direkt schreiben. Elisi Agent kann dann Aufgaben, Listen und andere Einträge erfassen oder suchen.

Vorbereitung

Du benötigst:

Ein Elisi-Konto.
Die Berechtigung, eine Feishu-App für dein Unternehmen zu erstellen und zu veröffentlichen.
Falls erforderlich, die Zustimmung deiner Unternehmensadministration zu den App-Berechtigungen.

1. Eine Feishu-App erstellen

Öffne die Feishu Open Platform und wechsle zur Entwicklerkonsole.
Erstelle eine benutzerdefinierte Unternehmens-App.
Aktiviere unter App-Funktionen hinzufügen den Bot.
Füge unter Berechtigungen Folgendes hinzu:
- Einzelmitteilungen lesen, die Nutzer an den Bot senden.
- Nachrichten als App senden.
- Für Gruppenchats zusätzlich die Berechtigung, Nachrichten zu empfangen, in denen der Bot erwähnt wird.

Notiere die App ID und das App Secret.

2. Den Bot in Elisi verbinden

Öffne in Elisi die Einstellungen.
Wähle unter Elisi AI die Option Feishu / Lark Bot.
Wähle Feishu als Plattform. Wenn du den internationalen Lark-Dienst verwendest, wähle Lark.
Gib optional einen Bot-Namen sowie App ID, App Secret und das in Feishu angezeigte Verification Token ein.
Wähle Bot verbinden.

Nach der Überprüfung zeigt Elisi Folgendes an:

Eine Event-Callback-URL.
Einen einmaligen Befehl zum Verknüpfen des Kontos.

Das App Secret wird nur einmal angezeigt. Elisi speichert es verschlüsselt und sendet es nicht an den Agent.

3. Event-Callbacks konfigurieren

Kehre zur Feishu Open Platform zurück:

Öffne Ereignisse und Callbacks oder Event-Abonnements.
Wähle Ereignisse an einen Entwickler-Server senden.
Kopiere die Event Callback URL aus Elisi und füge sie als Request-URL ein.
Lass den Encrypt Key leer.
Speichere die URL und warte auf die erfolgreiche Überprüfung durch Feishu.
Wähle Ereignis hinzufügen und füge Folgendes hinzu:
```
Nachrichten empfangen (im.message.receive_v1)
```

Die URL-Prüfung allein reicht nicht. im.message.receive_v1 muss zusätzlich hinzugefügt werden.

4. App veröffentlichen und installieren

Erstelle in der Feishu Open Platform eine neue Version.
Prüfe, ob sie die hinzugefügten Berechtigungen und das Nachrichtenereignis enthält.
Reiche die Version zur Prüfung ein und veröffentliche sie. Falls erforderlich, hole zuerst die Zustimmung der Administration ein.
Installiere die App im Unternehmen und stelle sicher, dass dein Feishu-Konto zum verfügbaren Nutzerkreis gehört.

Nach jeder Änderung an Berechtigungen oder Ereignissen musst du eine neue Version veröffentlichen, damit die Änderungen wirksam werden.

5. Elisi-Konto verknüpfen

Konfiguration und Veröffentlichung dauern häufig länger als 15 Minuten. Kehre nach der Veröffentlichung zu Elisi zurück:

Wähle auf der Bot-Karte Neuen Verknüpfungscode erstellen.
Kopiere den vollständigen einmaligen Befehl, zum Beispiel:
```
/elisi-bind AbCdEf123
```
Öffne innerhalb von 15 Minuten einen Einzelchat mit dem Bot und sende den Befehl.
Kehre nach der Erfolgsmeldung zu Elisi zurück und aktualisiere den Status.

Die Einrichtung ist abgeschlossen, wenn der Status von Warten auf Verknüpfung zu Verbunden wechselt. Die erste Verknüpfung muss in einem Einzelchat erfolgen, nicht in einer Gruppe.

6. Den Bot verwenden

Einzelchat: Sende dem Bot direkt eine Textnachricht.
Gruppenchat: Ein verknüpfter Nutzer muss den Bot in der Nachricht erwähnen.
Verbindung trennen: Wähle auf der Bot-Karte in Elisi Verbindung trennen.

Die aktuelle Version unterstützt Textnachrichten. Verschlüsselte Callbacks mit Encrypt Key, Anhänge, interaktive Karten oder die gemeinsame Nutzung eines Elisi-Kontos durch mehrere Personen werden nicht unterstützt.

Fehlerbehebung

Problem	Prüfen
Die Callback-URL wird nicht geprüft oder liefert keinen Challenge-Wert	Prüfe die vollständige URL und das `Verification Token`. Leere den `Encrypt Key` und speichere erneut.
URL-Prüfung erfolgreich, aber der Bot reagiert im Einzelchat nicht	Prüfe, ob `im.message.receive_v1` hinzugefügt wurde. Veröffentliche, genehmige und installiere nach Änderungen an Ereignissen und Berechtigungen die aktuelle App-Version erneut.
Elisi zeigt weiterhin „Warten auf Verknüpfung“	Erstelle einen neuen Code und sende den vollständigen Befehl innerhalb von 15 Minuten in einem Einzelchat. Alte Codes laufen ab.
Konto verknüpft, Bot antwortet aber nicht	Prüfe, ob die Berechtigung zum Senden von Nachrichten als App genehmigt und in der neuesten Version enthalten ist.
Der Bot reagiert in einem Gruppenchat nicht	Verknüpfe zuerst das Konto im Einzelchat. Danach muss ein verknüpfter Nutzer den Bot in der Gruppe erwähnen.
Der Bot ist nicht auffindbar oder lässt sich nicht anschreiben	Prüfe, ob die App installiert ist und dein Konto zum verfügbaren Nutzerkreis gehört.

Wenn das Problem weiter besteht, prüfe in der Feishu Open Platform unter Event-Push-Protokolle, ob im.message.receive_v1 erscheint. Fehlt der Eintrag, sind Ereignis, Berechtigungen, veröffentlichte Version oder Nutzerkreis möglicherweise noch nicht aktiv.