# Connect Lark
URL: /docs/rome/lark
Markdown: /docs/rome/lark.md
Description: Talk with Rome in 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 [#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 [#create-the-lark-app]

1. Open the [Lark Developer Console](https://open.larksuite.com/app).
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 [#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 [#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.