Skip to content

Channels: Lark / Feishu

Lark, known as Feishu in mainland China, is a Tier 2 channel. Wayland connects as a Lark app. You create a custom app, copy its credentials, and configure an event subscription so Lark delivers messages to Wayland.

Before you start (prerequisites and accounts)

Section titled “Before you start (prerequisites and accounts)”
  • A Lark or Feishu developer account and a custom app.
  • The Wayland desktop app running with a model provider connected.

Create the credentials (on the provider side)

Section titled “Create the credentials (on the provider side)”
  1. In the Lark/Feishu developer console, create a custom app and note its App ID and App secret.
  2. Choose the domain that matches your tenant: Lark (international) or Feishu (China).
  3. If you enable encryption, note the Encrypt key and the Verification token for the event subscription.

Connect it in Wayland (Settings -> Channels -> Lark / Feishu)

Section titled “Connect it in Wayland (Settings -> Channels -> Lark / Feishu)”
  1. Open Settings -> Channels and choose Lark / Feishu.
  2. Select the Domain.
  3. Enter the App ID and App secret.
  4. Enter the Encrypt key and Verification token if you use them; otherwise leave them blank.
  5. Save.

Verify (status goes from idle to connected, send a test message)

Section titled “Verify (status goes from idle to connected, send a test message)”

After saving, the status moves from idle to connected. Message the app in Lark and confirm a reply. Add the bot to a chat if your tenant requires it.

Set the assistant and default model on the Lark page. Inbound messages route to that assistant.

A domain mismatch (Lark vs Feishu) or a wrong app secret are common causes of failures. Confirm the domain and credentials. See Channel Connection Issues.