Connect Lark

Use this page to connect Rome to a Lark bot so you can talk with Rome from Lark. Rome uses the same internal channel as Feishu, but you must choose the Lark International region when connecting.

Before you start

You need:

• Admin access to a Lark tenant where you can create and publish a custom app.
• Access to Rome's web app as the guardian.
• The Lark app's App ID and App Secret.

Create the Lark app

1. Open the Lark Developer Console.
2. Create a custom app, then open the app.
3. In the app settings, add the Bot capability.
4. In Permissions & Scopes, grant the permissions Rome needs: the im:message read and send scopes shown by the console, plus im:message:update, im:message.reactions:write_only, and the card scopes cardkit:card:read and cardkit:card:write. Rome uses an interactive card to verify your guardian account and a temporary reaction to show that it is processing a message.
5. In Events & Callbacks, subscribe to both the im.message.receive_v1 event and the card.action.trigger callback.
6. Choose the long-connection / WebSocket delivery mode. Rome does not need a public callback URL for Lark.
7. Create and publish a version of the app, then have the tenant admin approve it so the bot, scopes, and event subscription go live.

Connect in Rome

1. Open Rome and go to Settings.
2. Open Channel Connections.
3. Open the Feishu card.
4. Set Region to Lark (International).
5. Select the Enter credentials tab. (The card defaults to the Create Agent app tab, which can create a new app for you and pre-configure the bot, scopes, and callbacks automatically — use it if you'd rather skip the developer console steps above.)
6. Paste the app's App ID.
7. Paste the app's App Secret.
8. Click Test & Connect.

Rome validates the credentials, stores them locally, starts the long connection, and shows a verification code.

Link your guardian account

1. In Lark, find the bot from the app you just published and send it any message.
2. The bot replies with a verification card.
3. Enter the verification code shown in Rome into the card and submit it.
4. Keep the Rome settings page open. It polls automatically and updates once your Lark account is linked as the guardian.

You have five attempts. After too many incorrect codes the card locks — disconnect the channel in Rome and connect again to generate a new verification code.

After this, messages sent to the bot are delivered to Rome.