> ## Documentation Index
> Fetch the complete documentation index at: https://docs.langbot.app/llms.txt
> Use this file to discover all available pages before exploring further.
# Connect to Feishu Bot
## One-Click Setup (Recommended)
LangBot supports one-click Feishu app creation with automatic credential filling — no manual copy-paste needed.
1. Open LangBot WebUI, go to **Bots > Create Bot**
2. Enter a bot name, select `Feishu` as the platform/adapter
3. In the **One-Click Create App** section that appears, click the **Start** button
4. Scan the QR code with Feishu. On your phone, you'll see the Feishu Open Platform's bot creation page
5. Choose to **use an existing app** or **create a new one**:
If you choose an existing app, a list of your apps will be shown:
6. After authorization, the phone will show "Configuration Successful", and app\_id / app\_secret will be **auto-filled** in the LangBot WebUI
7. **Manually fill in the bot name** — it must match the Feishu bot name, otherwise the bot won't receive messages in groups
8. Click **Submit** to complete
***
## 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:
If you need to change the default card template, you need to modify the card template in the platform adapter's code yourself.
### 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.
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.
**No public server?** [LangBot Cloud](https://space.langbot.app/cloud) includes built-in domain and HTTPS — get Lark bots working out of the box.
### Configure Event Subscription
Go to the `Events and Callbacks` page, configure the subscription method as `Long Connection`:
And add the event: `Receive Messages`
Set up `Callback Configuration`, select the long connection callback (use webhook if using webhook mode)
Add the callback `Card Callback Interaction`
Webhook mode configuration method:
Please start LangBot first, fill in the Webhook address obtained from LangBot here.
### 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.