Уведомления в MAX-группы через API

Отдельный бот пишет короткие сообщения в вашу рабочую группу MAX: оплаты, лиды, свои алерты. Доступно только по подписке PRO.

Бот: @id507407009123_2_bot — «Уведомления | Perfomate». Он только доставляет сообщения. Какой текст слать — решаете вы: оплата, лид, свой алерт.

Кому доступно

Нужен любой один активный PRO на канал. Это не конверсии: конверсии остаются на оплаченный канал. Когда PRO истечёт, API ответит 402. Цель — рабочая группа MAX. Личка только если явно сделали /bind и группы нет.

Какого бота добавить в группу

В MAX откройте группу, куда должны приходить сообщения.
Участники → добавить @id507407009123_2_bot. В MAX нет кнопки «добавить бота из чата с ним» — ищите username в участниках.
Дайте боту право писать сообщения. Принимать заявки и быть админом не нужно.

Как привязать чат к кабинету

В @perfomate_bot или @id507407009123_bot: меню «Уведомления в MAX» или команда /notify.
Откройте ссылку и нажмите Start у @id507407009123_2_bot. Это только привязка кабинета. Куда слать сообщения, Start не выбирает. Из MAX, если уже писали продуктовому боту, достаточно Start. Из Telegram ссылка обязательна: аккаунты разные.
Для группы: добавьте бота, как выше, и напишите /bind в этой группе. Повторный Start в личке группу не снимет.
Если уведомления нужны в личку — напишите /bind в диалоге с ботом, и только если группы ещё нет.

Бот пишет в чат, где сделали /bind. Если есть и группа, и личка — уходит в группу. Произвольный chat_id чужого чата не примем.

Как получить ключ API

Нужна подписка PRO на любой канал. Без неё ключ не выдаётся, а запрос к API не пройдёт.
Самый простой путь: кабинет → Уведомления. Там ключ, шаги и пример запроса.
В @perfomate_bot или @id507407009123_bot можно нажать «Уведомления в MAX». Если ключа ещё не было, бот пришлёт строку pm_… один раз. Сохраните её.
Если ключ уже выдавали, бот напишет только префикс вроде pm_key_. Секрет из этого сообщения не восстановить.
Новый ключ или если секрет потеряли: lk.perfomate.ru → Настройки → Кабинет → вкладка «API-ключи» → «Создать ключ». Чтобы заменить старый — «Ротировать». Снова покажут один раз. Нужна роль владельца, админа или разработчика.
Тот же ключ, что для событий и конструкторов. Если подключали своего бота через /add_bot, строка pm_… уже могла прийти тогда — её и используйте.

settings.perfomate.ru ключей не выдаёт: это настройки канала, не кабинета.

API

В запрос: Authorization: Bearer pm_…, либо X-Api-Key, либо ?key=. Ключ привязан к проекту кабинета, для уведомлений достаточно любого активного ключа этого кабинета.

GET https://perfomate.ru/public/v1/notify
Authorization: Bearer pm_…

POST https://perfomate.ru/public/v1/notify
Authorization: Bearer pm_…
Content-Type: application/json

{
  "text": "Оплата 1 490 ₽, заказ 10041"
}

Поле	Обязательно	Зачем
`text`	да	До 4000 символов. Пустую строку не примем
`format`	нет	`plain` (по умолчанию), `markdown` или `html`
`parse_mode`	нет	Синоним `format`
`chat_id`	нет	Явно указать уже привязанную группу. Без поля берём группу, не личку
`notify`	нет	`true` — звук/бейдж в MAX
`disable_web_page_preview`	нет	Не разворачивать ссылку

Ответ отправки: { "data": { "ok": true, "chat_id", "title" } }. Статус: { "data": { "allowed", "bot", "bot_url", "chats" } }.

Лимит: 30 отправок в минуту на ключ. 60 запросов статуса в минуту.

Примеры

{
  "text": "Новый лид: Иван, +7999…, ленд /offer"
}

{
  "text": "*Оплата* 1490 ₽\nЗаказ `10041`",
  "format": "markdown",
  "notify": true
}

Чего это не делает

Не шлёт в лички произвольным людям и не рассылает по базе.
Не пишет в Telegram — только MAX, только через @id507407009123_2_bot.
Не учит Директ и не заменяет POST /public/v1/events.
Не принимает заявки в канал и не ставит кнопки «одобрить».

Заявки закрытого канала

Если у кабинета есть закрытый Telegram-канал, в ту же группу кабинет сам может написать о заявке. Это бонус той же привязки, не смысл API. Одобрение — в Telegram или автоприём.

PRO · События API · Как добавить бота в MAX