Личные сообщения — API

Бот может написать человеку лично. Сообщения в беседу отправляются тем же методом, что и в канал: POST /api/channels/dm_…/messages.

POST/api/dm/channels

Открыть беседу

Bot

Поле	Тип	Описание
`recipientIds`обяз.	string[]	Один id — личная беседа (type: dm) (если она уже есть, вернётся существующая); до 9 — группа (type: group).
`name`	string	Название группы.

JSON

{ "channel": { "id": "dm_…", "type": "dm", "name": null, "ownerId": null, "createdAt": 1767225600000, "members": [User, User] } }

403 — человек принимает сообщения только от друзей или закрыл их.

GET/api/dm/channels

Беседы бота

Bot

Ответ: { "channels": [DmChannel] }.

const { channel } = await api("POST", "/dm/channels", { recipientIds: [userId] });
await api("POST", `/channels/${channel.id}/messages`, { content: "Напоминание: встреча в 18:00" });