Настройка канала Feishu (Lark)
Подключите своего Bot в Memoh к Feishu (Lark) через Open Platform, чтобы корпоративный Bot общался с пользователями в группах и личных чатах.
Предварительные условия
- Аккаунт на Feishu Open Platform с правом создавать собственные приложения.
- Bot в Memoh; каналы настраиваются на его вкладке Platforms.
Шаги
1. В консоли Feishu создайте собственное приложение
- Откройте Feishu Open Platform и войдите.
- Нажмите Create Custom App, укажите название и описание, затем нажмите Create.
- В левой панели перейдите в App Settings > Credentials & Basic Info.
- Скопируйте App ID и App Secret.
2. В консоли Feishu включите возможность Bot
Перейдите в Capabilities > Bot и нажмите Enable Bot.
3. В консоли Feishu настройте права
- Перейдите в Capabilities > Permissions.
- Найдите и включите как минимум следующие права:
im:message(получение и отправка сообщений)im:chat(доступ к информации о групповых чатах)
- Если этого требует ваша организация, нажмите Apply for Permissions.
4. В Memoh добавьте канал Feishu (по умолчанию: постоянное соединение)
- Откройте вкладку Platforms нужного Bot и добавьте канал Feishu.
- Оставьте для Inbound Mode значение по умолчанию:
websocket. - Заполните App ID и App Secret; если вы используете международный Lark, переключите Region на
lark. - Нажмите Save. Сообщения приходят по постоянному WebSocket-соединению Feishu — публичный URL обратного вызова и настройка подписки на события не нужны.
5. Необязательно: переключитесь на режим webhook
Выбирайте этот вариант, только если ваш сервер доступен из интернета и вы предпочитаете обратные вызовы по событиям.
TIP
Этот режим требует переходов между Memoh и консолью Feishu: Memoh генерирует URL обратного вызова, который нужно вставить обратно в Event Subscriptions, поэтому держите консоль Feishu открытой.
- В Memoh установите Inbound Mode в
webhook; помимо App ID и App Secret заполните также Encrypt Key и Verification Token — они должны совпадать с настройками Event Subscriptions в консоли Feishu. - Нажмите Save. Memoh сгенерирует Webhook Callback URL — скопируйте его.
- В консоли Feishu перейдите в App Settings > Event Subscriptions, вставьте URL в поле Verification URL и сохраните.
- Добавьте события, например Receive Message (
im.message.receive_v1).
Официальное руководство: Feishu Custom Bot Guide
6. В консоли Feishu опубликуйте приложение
- Перейдите в App Release > Version Management & Release.
- Нажмите Create a Version, заполните сведения и отправьте на утверждение.
- После утверждения и публикации 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) и сохраните.
Частые вопросы
Канал настроен, но Bot не отвечает
Собственное приложение сначала нужно опубликовать: в консоли Feishu перейдите в App Release > Version Management & Release, создайте версию и отправьте её на утверждение. После утверждения и публикации Bot готов к работе в вашем тенанте.
Включение прав требует согласования
В некоторых организациях права приложений проходят процесс согласования: нажмите Apply for Permissions в разделе Capabilities > Permissions, чтобы отправить запрос.