API VEGA

Сводка

Отправляйте и принимайте сообщения, управляйте групповыми чатами и работайте с файлами в Lark IM.

  • Поддерживает рабочие процессы обмена сообщениями: отправка/ответ на сообщения, поиск истории чата, пакетная загрузка сообщений по ID и управление реакциями emoji и закреплениями сообщений

  • Операции с групповым чатом включают создание, список, поиск, обновление имени/описания и управление участниками (добавление/удаление пользователей и ботов)

  • Работа с файлами и медиа: загрузка изображений, скачивание файлов с автоматической разбивкой на большие файлы (куски по 8 МБ), и пересылка сообщений или веток

  • Закладки сообщений или веток на уровне сообщения или ленты; отправка уведомлений в приложении, по SMS и по телефону в случае срочности (только для идентичности бота)

  • Работает как с идентичностью пользователя, так и с идентичностью бота; идентичность пользователя обычно имеет более широкий доступ к контактам и чатам, тогда как идентичность бота требует явной видимости приложения и настроек членства

im (v1)

КРИТИЧЕСКО — Перед началом ОБЯЗАТЕЛЬНО используйте инструмент Read, чтобы прочитать ../lark-shared/SKILL.md, который содержит аутентификацию и обработку разрешений

Основные понятия

  • Message: одно сообщение в чате, идентифицируемое по message_id (om_xxx). Поддерживаются типы: текст, пост, изображение, файл, аудио, видео, стикер, интерактивное (карта), share_chat, share_user, merge_forward и т. д.

  • Chat: групповой чат или P2P-переписка, идентифицируемый по chat_id (oc_xxx).

  • Thread: ответная ветка к сообщению, идентифицируемая по thread_id (om_xxx или omt_xxx).

  • Reaction: эмодзи-реакция на сообщение.

  • Flag: закладка на сообщение или ветку.

  • Feed Shortcut: чат, прикрепленный к ленте текущего пользователя в боковой панели, идентифицируемый по feed_card_id (открытый чат oc_xxx типа CHAT).

  • Feed Group: тег, который группирует карточки ленты в списке ленты, идентифицированный по feed_group_id (ofg_xxx). Участники — это карточки ленты, каждая идентифицируется по feed_id + feed_type. Есть два типа: normal (участники управляются явно) и rule (участники автоматически выводляются по правилам).