mirror of
https://github.com/langbot-app/LangBot.git
synced 2026-11-02 05:45:20 +08:00
RockChinQ
35a0234c87
Localized Cloud promotion tips for English and Japanese versions. EN tips emphasize Slack, LINE, WeCom (internationally relevant). JA tips emphasize LINE and Lark (Japan-relevant platforms).
95 lines
3.6 KiB
Plaintext
95 lines
3.6 KiB
Plaintext
---
|
|
title: "Connect to Feishu Bot"
|
|
---
|
|
|
|
## Create Bot
|
|
|
|
Go to the [Feishu Open Platform](https://open.feishu.cn/app), log in, and create an enterprise self-built application or store application. [(difference introduction)](https://open.feishu.cn/document/platform-overveiw/overview)
|
|
|
|
|
|
|
|
|
|
|
|
Add bot capability to the application:
|
|
|
|
|
|
Add the permissions shown in the image in the permission management:
|
|
|
|
|
|
|
|
If card streaming permissions are required, additionally add the following card creation and update permissions as shown in the image:
|
|
|
|
|
|
|
|
<Warning>
|
|
If you need to change the default card template, you need to modify the card template in the platform adapter's code yourself.
|
|
</Warning>
|
|
|
|
## Connect to LangBot
|
|
|
|
Find `app_id` and `app_secret` on the `Credentials and Basic Information` page.
|
|
|
|
|
|
|
|
|
|
|
|
Open LangBot's Webui configuration page, create a new bot
|
|
|
|
Fill in the relevant information in the form
|
|
|
|
|
|
|
|
Streaming related:
|
|
|
|
|
|
After filling in, start LangBot. If configured successfully, the log will show `[01-29 23:42:56.796] manager.py (68) - [INFO] : Initializing platform adapter 1: lark`, keep LangBot running.
|
|
|
|
<Warning title="By default, WebSocket long connection mode is used, corresponding to the long connection subscription below. But in some cases (such as international version of Feishu), long connection mode is not available, in which case you need to use Webhook mode, corresponding to the `Send events to developer server` mode, please refer to the following configuration:">
|
|
|
|
- `enable-webhook`: Set to `true`
|
|
- `encrypt-key`: Set to `Encrypt Key` in the `Encryption Strategy` of the `Events and Callbacks` page
|
|
|
|
Note that in Webhook mode, LangBot needs to be deployed on a server with a public IP, and ensure that the firewall has opened the port configured above.
|
|
|
|
<Tip>
|
|
**No public server?** [LangBot Cloud](https://space.langbot.app/cloud) includes built-in domain and HTTPS — get Lark bots working out of the box.
|
|
</Tip>
|
|
</Warning>
|
|
|
|
## Configure Event Subscription
|
|
|
|
Go to the `Events and Callbacks` page, configure the subscription method as `Long Connection`:
|
|
|
|
|
|
|
|
And add the event: `Receive Messages`
|
|
|
|
|
|
|
|
<Warning title="Webhook mode configuration method:">
|
|
|
|
|
|
|
|
Please start LangBot first, fill in your server address and port here, the path is `/lark/callback`, click `Save`.
|
|
|
|
</Warning>
|
|
|
|
## Publish Bot
|
|
|
|
Click `Create Version` at the top, fill in the version number and other information, click `Save` below.
|
|
|
|
|
|
|
|
Add the bot to a Feishu group to use it:
|
|
|
|
|
|
|
|
|
|
|
|
Private chat can also be used directly
|
|
|
|
|
|
|
|
## Common Issues
|
|
- Store app bots cannot respond to chat messages immediately after creation/saving. Due to the [app_ticket event](https://open.feishu.cn/document/server-docs/application-v6/event/app_ticket-events) delay mechanism, you need to wait about 2 minutes before it can work normally.
|