API: рассылки, группы и справочник методов

Панель и ИИ-ассистент через MCP умели заводить рассылки и группы давно, а внешняя интеграция — нет. Это перекос: за API берутся ровно затем, чтобы нагнать аудиторию из своей CRM и написать ей. Теперь методы есть.

Рассылки

• CreateBroadcast — разовая рассылка: текст, медиа из хранилища бота, кнопки со ссылкой или переходом в рубрику, всем подписчикам или выбранной группе, сейчас или в назначенное время по Москве;
• GetBroadcasts — список с честным статусом: запланирована, отправляется, отправлена;
• CancelBroadcast — снять запланированную. Ту, что уже ушла в отправку, отменить нельзя — метод так и отвечает, вместо того чтобы делать вид, что всё получилось.

Правила у рассылки из API ровно те же, что у рассылки из панели: чужая группа не станет аудиторией, кнопка с рубрикой другого бота не пройдёт. Проверка живёт в одном общем месте, поэтому «через API можно то, чего нельзя в панели» здесь не бывает.

Группы подписчиков

CreateGroup и DeleteGroup дополняют существующие чтение групп и добавление в них подписчика. Теперь сегмент можно завести из своей системы целиком: создать группу, наполнить её и разослать по ней сообщение.

Справочник и спека

Появились две вещи, которых не было вовсе:

• справочник методов — все методы с параметрами и требуемым уровнем доступа ключа, сгруппированные по назначению;
• машиночитаемая спека по адресу /api/v1/openapi.json — её можно скормить генератору клиента или Swagger UI.

Обе собираются прямо из кода сервиса, поэтому не расходятся с тем, что реально работает: метод, добавленный без описания, не проходит нашу проверку сборки.

Напомним про повторы: заголовок Idempotency-Key защищает от двойного выполнения, если запрос ушёл по таймауту и неясно, дошёл ли он, — повтор вернёт прежний ответ и не создаст вторую рассылку. Как подключиться — в документации по API, а если управлять ботом должен ИИ-ассистент, смотрите MCP.