Отличия от VK Teams
Имена методов, способ передачи токена и поля в ответах совпадают. Боту обычно достаточно сменить базовый адрес и токен — кроме одного места, где нужна правка кода.
Таблица отличий
| VK Teams | Chat Ostart | |
|---|---|---|
chatId, userId, msgId, fileId | строки своего формата, часто числовые | UUID |
eventId | число | число (сквозной идентификатор события) |
| Ссылка на сообщение | собирается из inviteLink | chats/getInfo отдаёт готовый messageLinkTemplate |
Клавиатуры, колбэки, sendFile, editText, deleteMessages | есть | пока нет, вторым заходом |
Единственная правка кода
Функция вида getMessageLink в библиотеке bot-os собирает ссылку из inviteLink, проверяя хост myteam.mail.ru и числовой msgId — здесь это не сработает. Возьмите messageLinkTemplate из chats/getInfo и подставьте msgId. Формат: https://chat.ostart.ru/c/<chatId>/m/<msgId>.
Почему идентификаторы другие
У чата уже есть свои идентификаторы. Вводить вторую, числовую нумерацию означало бы держать две личности одного объекта и постоянно их сводить — поэтому наружу отдаются те же UUID, что внутри.
Права и границы
- Бот — обычный участник: видит ровно то, что участник, и только с момента вступления.
- Бот принадлежит одному рабочему пространству и не может обратиться к чужому.
- Исключили из чата — доступ пропадает сразу, включая уже выданные ссылки на файлы.
- Отключённый или удалённый бот получает
401на любой запрос.