---
url: /ru/integrations/channels/feishu.md
---
# Настройка канала Feishu (Lark)

Подключите своего Bot в Memoh к Feishu (Lark) через Open Platform, чтобы корпоративный Bot общался с пользователями в группах и личных чатах.

## Предварительные условия

* Аккаунт на [Feishu Open Platform](https://open.feishu.cn/app) с правом создавать собственные приложения.
* Bot в Memoh; каналы настраиваются на его вкладке **Platforms**.

## Шаги

### 1. В консоли Feishu создайте собственное приложение

1. Откройте [Feishu Open Platform](https://open.feishu.cn/app) и войдите.
2. Нажмите **Create Custom App**, укажите название и описание, затем нажмите **Create**.
3. В левой панели перейдите в **App Settings** > **Credentials & Basic Info**.
4. Скопируйте **App ID** и **App Secret**.

### 2. В консоли Feishu включите возможность Bot

Перейдите в **Capabilities** > **Bot** и нажмите **Enable Bot**.

### 3. В консоли Feishu настройте права

1. Перейдите в **Capabilities** > **Permissions**.
2. Найдите и включите как минимум следующие права:
   * `im:message` (получение и отправка сообщений)
   * `im:chat` (доступ к информации о групповых чатах)
3. Если этого требует ваша организация, нажмите **Apply for Permissions**.

### 4. В Memoh добавьте канал Feishu (по умолчанию: постоянное соединение)

1. Откройте вкладку **Platforms** нужного Bot и добавьте канал **Feishu**.
2. Оставьте для **Inbound Mode** значение по умолчанию: `websocket`.
3. Заполните **App ID** и **App Secret**; если вы используете международный Lark, переключите **Region** на `lark`.
4. Нажмите **Save**. Сообщения приходят по **постоянному WebSocket-соединению** Feishu — публичный URL обратного вызова и настройка подписки на события не нужны.

### 5. Необязательно: переключитесь на режим webhook

Выбирайте этот вариант, только если ваш сервер доступен из интернета и вы предпочитаете обратные вызовы по событиям.

::: tip
Этот режим требует переходов между Memoh и консолью Feishu: Memoh генерирует URL обратного вызова, который нужно вставить обратно в **Event Subscriptions**, поэтому держите консоль Feishu открытой.
:::

1. В Memoh установите **Inbound Mode** в `webhook`; помимо **App ID** и **App Secret** заполните также **Encrypt Key** и **Verification Token** — они должны совпадать с настройками Event Subscriptions в консоли Feishu.
2. Нажмите **Save**. Memoh сгенерирует **Webhook Callback URL** — скопируйте его.
3. В консоли Feishu перейдите в **App Settings** > **Event Subscriptions**, вставьте URL в поле **Verification URL** и сохраните.
4. Добавьте события, например **Receive Message** (`im.message.receive_v1`).

> Официальное руководство: [Feishu Custom Bot Guide](https://open.feishu.cn/document/client-docs/bot-v3/add-custom-bot)

### 6. В консоли Feishu опубликуйте приложение

1. Перейдите в **App Release** > **Version Management & Release**.
2. Нажмите **Create a Version**, заполните сведения и отправьте на утверждение.
3. После утверждения и публикации Bot готов к работе в вашем тенанте.

## Учётные данные

| Поле | Описание |
|-------|-------------|
| **App ID** | Из раздела **App Settings** > **Credentials & Basic Info** консоли Feishu. |
| **App Secret** | С той же страницы **Credentials & Basic Info**. |
| **Region** | Переключите на `lark`, если используете международный Lark. |
| **Inbound Mode** | `websocket` (по умолчанию, постоянное соединение) или `webhook`. |
| **Encrypt Key** | Только для режима webhook; должен совпадать с настройками Event Subscriptions в консоли Feishu. |
| **Verification Token** | Только для режима webhook; должен совпадать с настройками Event Subscriptions в консоли Feishu. |

## Проверка

Откройте личный чат с Bot в Feishu и отправьте `/help`. Если Bot ответил списком команд, канал работает.

## Групповые чаты

Групповые чаты Feishu поддерживаются. Добавьте Bot в группу и обращайтесь к нему через @-упоминание.

## Отключение и смена учётных данных

Отключить или удалить этот канал можно в любой момент на вкладке **Platforms** нужного Bot. Чтобы сменить учётные данные, обновите поля (например, **App Secret**) и сохраните.

## Частые вопросы {#faq}

### Канал настроен, но Bot не отвечает {#app-not-published}

Собственное приложение сначала нужно опубликовать: в консоли Feishu перейдите в **App Release** > **Version Management & Release**, создайте версию и отправьте её на утверждение. После утверждения и публикации Bot готов к работе в вашем тенанте.

### Включение прав требует согласования {#permission-approval}

В некоторых организациях права приложений проходят процесс согласования: нажмите **Apply for Permissions** в разделе **Capabilities** > **Permissions**, чтобы отправить запрос.