Личные и групповые чаты

Личный чат

После установки бот получает /start, chat_id и session_id. Бот может писать без дополнительного вызова, пока установка активна и уведомления не отключены пользователем.

Групповой чат

Добавлять и удалять бота может только администратор. Один бот добавляется в группу однократно и получает только упоминания и реплаи на собственные сообщения.

Пользователь события

actor содержит стабильный только для конкретного бота id, username и display_name. Аватар, телефон, email, список участников и глобальный Matrix ID не передаются.

Уведомления

В личном чате уведомления от бота можно отключить отдельно. В группе сообщения бота подчиняются настройкам уведомлений всей группы.

Практика с SDK

В группе бот должен отвечать только на переданное платформой обращение или реплай. Не пытайтесь получать состав участников или историю обходными путями.

session_id меняется после перезапуска личного чата. Очищайте связанное диалоговое состояние, когда приходит новая сессия.

const { chat_id, chat_type, actor, message } = event.data;

if (chat_type === 'group' && message.reply_to_bot !== true) return {};
await bot.reply(chat_id, message.event_id, { text: `Hello, ${actor.display_name}` });