Telegram-бот пишет первым: приглашения в Bot API 10.5 | CrmAI

Telegram-бот пишет первым: приглашения в Bot API 10.5

22 ноября Telegram дал владельцу бота право пригласить до 10 человек в чат с ботом – и бот может написать им первым. Где это полезно и почему это не рассылка.

Смартфон с чатом Telegram-бота, где служебная строка сообщает о приглашении от владельца, рядом руководитель отмечает в списке десять контактов

Директор оптовой компании в Караганде подключил к CRM Telegram-бота: новая заявка – и ответственный менеджер сразу получает сообщение с суммой и телефоном клиента. Прошло три недели. Из двенадцати менеджеров бота запустили семь. Остальные пять «не успели нажать», и их заявки по-прежнему ждут до утренней планёрки, хотя уведомление давно ушло. Ушло в никуда: Telegram-бот не мог написать первым тому, кто сам с ним не заговорил.

22 ноября 2026 года Telegram выпустил Bot API 10.5, и это правило впервые получило исключение. Владелец бота может пригласить в личный чат с ботом до десяти человек за раз, после чего бот вправе им писать. Telegram-бот пишет первым – но только тем, кого привёл владелец, и только вручную. Ниже разбираем, где это экономит недели, где не поможет вовсе и что ещё в этой версии стоит проверить в коде бота.

Главное за минуту

Что появилось

Ссылка вида t.me/botinvite/имя_бота. По ней владелец приглашает до 10 человек за раз, и бот может отправлять им сообщения.

Кто приглашает

Только владелец бота, своими руками. Метода API, который пригласил бы человека автоматически, нет.

Что видит бот

Служебное сообщение с новым полем inviter: доступ выдан, потому что пригласил владелец. По нему бот понимает, откуда взялся собеседник.

Что ещё в версии

Метод setMySettings – настройки бота без BotFather, новый тип BotFullInfo в ответе getMe и правка в раскрывающихся цитатах.

Как работает приглашение в Telegram-бота

Механика описана в changelog и справке Bot API коротко. Владелец открывает ссылку https://t.me/botinvite/<имя_бота> и выбирает, кого пригласить, – не больше десяти человек за одно нажатие. В личном чате с ботом у каждого приглашённого появляется служебное сообщение WriteAccessAllowed. Раньше такое сообщение приходило в трёх случаях: пользователь добавил бота в меню вложений, открыл Web App по ссылке или принял явный запрос доступа. Теперь к ним добавился четвёртый, и в нём заполнено поле inviter – владелец бота, который выдал приглашение.

С этого момента бот может отправлять приглашённому сообщения, не дожидаясь, пока тот нажмёт «Запустить».

На этом подтверждённое заканчивается. В документации на 22 ноября не сказано, из кого можно выбирать приглашённых (только из контактов владельца или любого пользователя), видит ли человек запрос и может ли отказаться, есть ли суточный лимит поверх «десяти за раз». Мы бы не строили процесс на догадках: проверьте поведение на своём аккаунте и паре коллег, прежде чем обещать отделу продаж.

Где бот, который пишет первым, правда экономит время

Ограничение «владелец, вручную, по десять» сразу отсекает массовые сценарии. Зато остаются небольшие и понятные группы людей, которых владелец знает лично. Их не так мало.

Внутренний бот для команды

История из начала статьи – самый частый случай. Бот уведомлений из CRM, бот для согласования скидок, бот, который присылает руководителю сводку по просроченным сделкам. Раньше каждый сотрудник должен был сам найти бота и нажать кнопку, и всегда находился кто-то, кто этого не сделал. Теперь владелец приглашает отдел из двенадцати человек в два захода, и в тот же день бот начинает писать всем. Новичку в первый рабочий день доступ выдаётся за минуту, без инструкции «найдите в поиске бота с таким-то именем».

Ключевые клиенты в B2B

Допустим, поставщик стройматериалов в Астане ведёт двадцать постоянных закупщиков. Владелец знает их лично, телефоны у него в контактах. Пригласив их в бота, он может сразу присылать подтверждение отгрузки, номер счёта и напоминание о сверке, а не просить каждого «напишите боту что-нибудь, чтобы он вас увидел». Для розницы с тысячами покупателей это не работает – там по-прежнему нужен вход через ссылку с сайта, QR-код на чеке или кнопку в Kaspi-карточке.

Пилот перед запуском

Перед тем как открыть нового бота клиентам, его обычно гоняют на своих: менеджерах, операторах, паре лояльных покупателей. Приглашение снимает лишний шаг – владелец собирает тестовую группу за минуту, бот сам присылает первое сообщение с просьбой пройти сценарий, а ответы и ошибки ложатся в CRM как от обычных пользователей.

Соберём бота уведомлений для вашего отдела продаж

Подключим его к сделкам в CRM, покажем, как пригласить команду через новую ссылку, и настроим, кому какие события приходят.

Обсудить бота для команды

Почему это не канал для рассылок

Соблазн понятен: десять человек за раз, сто – за десять нажатий, и бот пишет каждому. Мы считаем такую схему ошибкой, и не только из-за ручного труда.

Приглашение – это решение владельца, а не человека, которому теперь пишет бот. Он не подписывался и не просил присылать ему акции. Получив рекламу от незнакомого бота, он нажмёт «Заблокировать» или «Пожаловаться», и как Telegram поступает с ботами, на которые часто жалуются, в описании функции не сказано. Есть и вопрос персональных данных: если бот сразу заводит в CRM карточку с именем и идентификатором приглашённого, у вас должно быть основание эту обработку вести. Как изменились правила сбора данных о лидах, мы разбирали в статье «Новые правила сбора персональных данных: лиды, маскирование, ИИ».

Практичное правило: приглашать тех, с кем уже есть рабочие отношения и кто ждёт от вас сообщений, – сотрудников, партнёров, постоянных клиентов, предупреждённых по телефону. Первое сообщение бота должно объяснять, кто пригласил и зачем, и давать способ отписаться одной кнопкой.

setMySettings: настройки бота без BotFather

Вторая заметная часть версии менее эффектна, но полезна тем, кто держит несколько ботов. Раньше режим приватности, разрешение добавлять бота в группы и inline-режим включались вручную в BotFather. Теперь то же самое бот меняет сам, одним вызовом setMySettings. Параметры, которые не переданы, остаются как были.

Для продаж и сервиса важны три настройки из этого метода.

Параметр Что переключает Когда это нужно бизнесу
can_read_all_group_messages Режим приватности в группах: True отключает его, False включает Бот в общем чате с B2B-клиентом, который должен замечать заявки и вопросы, а не только команды
can_join_groups Можно ли вообще добавить бота в группу Закрыть внутреннего бота от случайных групп, куда его утащит сотрудник
can_connect_to_business Можно ли подключить бота к аккаунту пользователя, чтобы он вёл переписку от его имени Бот отвечает в личных чатах менеджера через Telegram Business

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

Что проверить разработчику бота

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

  • getMe теперь возвращает BotFullInfo. Поля, которые приходили только в ответе getMe, убраны из класса User. Если в типизированной библиотеке код читает, например, can_join_groups из объекта User, после обновления он перестанет собираться или получит пустое значение.
  • Раскрывающиеся цитаты в rich-сообщениях. В RichBlockExpandableBlockQuotation и InputRichBlockExpandableBlockQuotation поле text заменено на blocks. Кто отправляет ответы бота с такими цитатами, как мы описывали в статье «Telegram-бот печатает на глазах: стриминг и rich-сообщения», должен поменять формат запроса.
  • Режим callback-запросов. Параметр callback_query_mode позволяет получать в нажатиях кнопок inline_message_id вместо message. По умолчанию ничего не меняется, но если кто-то включит режим auto или inline, обработчики кнопок, которые ищут сделку по message, сломаются.

Если ваша библиотека ещё не поддерживает 10.5, новые методы можно вызвать обычным HTTP-запросом к Bot API. Обновлять зависимость вслепую, не прогнав сценарии бота, мы бы не стали.

Чего от приглашений ждать не стоит

Функция вышла сегодня, и описана она в двух строках документации. Границы лучше знать заранее.

Ограничения на 22 ноября

  • Не из CRM. Пригласить человека методом API нельзя – только владелец по ссылке, руками.
  • Не менеджер. Право есть у владельца бота, а не у каждого сотрудника с доступом к нему.
  • Не тысячи. Десять человек за одно приглашение, о других лимитах документация молчит.
  • Не согласие. Приглашение не превращает человека в подписчика рекламы.
  • Не всё описано. Нужно ли приглашённому подтверждать доступ и как выглядит экран выбора, Telegram не пишет.

Отдельно о владельце. Во многих компаниях бота создавал подрядчик или уволившийся разработчик, и владелец – его личный аккаунт. Теперь у этого аккаунта появилось ещё одно право, которое нужно бизнесу. Самое время выяснить, кто владеет вашими ботами.

Чек-лист: пригласить команду в бота

Если хотите попробовать на этой неделе, начните с внутреннего бота – там меньше всего рисков.

  • Узнать, чей аккаунт владеет ботом, и при необходимости передать бота ответственному сотруднику, а не подрядчику.
  • Составить список приглашённых: сотрудники или клиенты, которые ждут сообщений.
  • Научить бота обрабатывать WriteAccessAllowed с полем inviter и сразу присылать приветствие с объяснением.
  • Связать приглашённого с карточкой сотрудника или клиента в CRM по идентификатору Telegram.
  • Добавить в первое сообщение кнопку «Не присылать мне сообщения».
  • Проверить код на getMe, раскрывающиеся цитаты и обработку callback-кнопок.
  • Вынести настройки бота в setMySettings, если ботов несколько.

Связанные материалы

Проверим вашего Telegram-бота под Bot API 10.5

Пришлите имя бота и опишите, кому он пишет. За два дня проверим код на изменения версии, настроим приветствие для приглашённых и связку с CRM.

Проверить бота
Решения CrmAI по теме статьи

Хотите так же у себя?

Выберите услугу или опишите задачу в чате – подскажем, с чего начать в вашем бизнесе.