Feishu verbinden met Elisi Agent

Een Feishu-bot verbinden met Elisi Agent

Na de installatie kun je in Feishu privé met je bedrijfsbot chatten en Elisi Agent vragen taken, lijsten en andere items vast te leggen of op te zoeken.

Voordat je begint

Je hebt nodig:

Een Elisi-account.
Toestemming om een aangepaste Feishu-app voor je bedrijf te maken en te publiceren.
Goedkeuring van de bedrijfsbeheerder voor apprechten, als dat vereist is.

1. Een Feishu-app maken

Open het Feishu Open Platform en ga naar de ontwikkelaarsconsole.
Maak een aangepaste bedrijfsapp.
Schakel onder Appmogelijkheden toevoegen de Bot in.
Voeg onder Machtigingen het volgende toe:
- Privéberichten lezen die gebruikers naar de bot sturen.
- Berichten verzenden als de app.
- Voeg voor groepschats ook de machtiging toe om berichten te ontvangen waarin de bot wordt genoemd.

Bewaar de App ID en het App Secret.

2. De bot verbinden in Elisi

Open Instellingen in Elisi.
Selecteer onder Elisi AI de optie Feishu / Lark Bot.
Kies Feishu als platform. Gebruik je de internationale Lark-dienst, kies dan Lark.
Voer een optionele botnaam, de App ID, het App Secret en de Verification Token uit de Feishu-console in.
Selecteer Bot verbinden.

Na verificatie toont Elisi:

Een callback-URL voor gebeurtenissen.
Een eenmalig commando om je account te koppelen.

Het App Secret wordt maar één keer getoond. Elisi bewaart het versleuteld en stuurt het niet naar de Agent.

3. Callbacks voor gebeurtenissen configureren

Ga terug naar het Feishu Open Platform:

Open Gebeurtenissen en callbacks of Gebeurtenisabonnementen.
Selecteer Gebeurtenissen naar een ontwikkelaarsserver verzenden.
Kopieer de Callback-URL voor gebeurtenissen uit Elisi en plak deze als aanvraag-URL.
Laat Encrypt Key leeg.
Sla de URL op en wacht op de bevestiging van Feishu.
Selecteer Gebeurtenis toevoegen en voeg het volgende toe:
```
Berichten ontvangen (im.message.receive_v1)
```

Alleen de URL verifiëren is niet genoeg. Je moet ook im.message.receive_v1 toevoegen.

4. De app publiceren en installeren

Maak een nieuwe versie in het Feishu Open Platform.
Controleer of de nieuwe machtigingen en gebeurtenis zijn opgenomen.
Dien de versie in ter controle en publiceer deze. Regel zo nodig eerst goedkeuring van de beheerder.
Installeer de app in het bedrijf en controleer of je Feishu-account binnen de beschikbaarheidskring valt.

Publiceer na wijzigingen aan machtigingen of gebeurtenisabonnementen een nieuwe versie om ze actief te maken.

5. Je Elisi-account koppelen

De configuratie en publicatie kunnen langer dan 15 minuten duren. Ga na publicatie terug naar Elisi:

Selecteer op de botkaart Nieuwe koppelcode genereren.
Kopieer het volledige eenmalige commando, bijvoorbeeld:
```
/elisi-bind AbCdEf123
```
Open binnen 15 minuten een privéchat met de bot en stuur het commando.
Ga na de succesmelding terug naar Elisi en vernieuw de status.

De installatie is voltooid wanneer de status verandert van Wachten op koppeling naar Verbonden. De eerste koppeling moet in een privéchat gebeuren, niet in een groep.

6. De bot gebruiken

Privéchat: Stuur de bot rechtstreeks een tekstbericht.
Groepschat: Een gekoppelde gebruiker moet de bot in het bericht noemen.
Verbinding verbreken: Selecteer Verbinding verbreken op de botkaart in Elisi.

De huidige versie ondersteunt tekstberichten. Versleutelde callbacks met Encrypt Key, bijlagen, interactieve kaarten en het delen van één Elisi-account door meerdere mensen worden niet ondersteund.

Problemen oplossen

Probleem	Controleer dit
De callback-URL wordt niet geverifieerd of geeft geen challenge terug	Controleer de volledige URL en of `Verification Token` overeenkomt. Maak `Encrypt Key` leeg en sla opnieuw op.
URL geverifieerd, maar de bot reageert niet in privéchat	Controleer of `im.message.receive_v1` is toegevoegd. Publiceer, laat goedkeuren en installeer na wijzigingen aan gebeurtenissen en machtigingen de nieuwste versie opnieuw.
Elisi blijft “Wachten op koppeling” tonen	Genereer een nieuwe code en stuur binnen 15 minuten het volledige commando in een privéchat. Oude codes verlopen.
Account is gekoppeld, maar de bot antwoordt niet	Controleer of de machtiging om als app berichten te sturen is goedgekeurd en in de nieuwste versie zit.
De bot reageert niet in een groep	Koppel eerst via privéchat. Laat daarna een gekoppelde gebruiker de bot in de groep noemen.
De bot is niet te vinden of niet privé te berichten	Controleer of de app is geïnstalleerd en je account binnen de beschikbaarheidskring valt.

Blijft het probleem bestaan, controleer dan in het Feishu Open Platform onder Logboeken voor gebeurtenispush of im.message.receive_v1 verschijnt. Ontbreekt dit, dan zijn de gebeurtenis, machtigingen, gepubliceerde versie of beschikbaarheidskring mogelijk nog niet actief.