September 16, 2025

Инструкция по работе с тг-ботом @take_a_card_bot

Бот @take_a_card_bot работает в комментариях к каналу или в группе. Он:

  • Хранит ваши "рабочие колоды" в одном месте.
  • Выдает карту по ключевому слову (ключевое слово привязывается администратором к колоде в интерфейсе бота). Два режима выдачи — случайная карта и карта по номеру в колоде.
  • Если вы добавляете к каждой карте описание — посылает его спойлером под картинкой (если описание более 1000 символов — то оно посылается вторым сообщением из-за лимитов Телеграм)
  • Если индивидуального описания нет, то бот может послать общую подсказку по работе с картой (привязывается к колоде).
  • Не требует регулярных абонентских платежей.

1. Запуск бота

  1. Перейдите в бота @take_a_card_bot и нажмите кнопку «Запустить» или выберите в меню команду /start.
  2. Если вы ещё не подписаны на канал проекта (@bots_at_work) — подпишитесь. Подписка открывает бесплатный доступ:
    • 2 слота для колод;
    • 2 слота для текстовых наборов;
    • 1 слот для привязки группы.
  3. После этого вы увидите главное меню (в это меню можно выйти в любое время, выбрав команду /menu )

2. Создание и наполнение колоды

  1. В главном меню выберите «Новая колода».
  2. Если лимит колод не исчерпан, то бот предложит ввести название колоды:

3. Выберите способ загрузки и нажмите "Продолжить"

4. Загрузите изображения карт (при загрузке выбирайте опцию "Сжать изображение"):

    • Только картинки — загрузка альбомом — без описаний (их можно добавить позже).
    • Картинка + текст — по одному изображению — с указанием описания каждой карты.
    • Импорт из шаблона — импорт изображений из готовой колоды — пока что доступна только одна колода для импорта (таро Райдера-Уэйта)

5. После загрузки изображений колода доступна через меню Мои колоды.

В меню колоды можно:

  • просматривать карты (и добавлять/редактировать описания, удалять ненужные). Описание, привязанное к карте, будет потом отправляться пользователю в спойлере под картинкой;
  • назначить ключевое слово (оно должно быть уникальным, разные колоды не могут иметь одно и то же слово);
  • назначить общую подпись (текст под картой в случае, когда индивидуальное описание для карты не задано);
  • переименовать колоду;
  • перетасовать колоду;
  • очистить колоду (удалить все карты, сохранив колоду);
  • полностью удалить колоду (пустой слот в любом случае останется за вами).
⚠️ Если бесплатные слоты заняты, можно купить дополнительный слот для колоды за звезды. Слот предоставляется бессрочно.

3. Привязка группы

Чтобы бот выдавал карты в комментариях канала или в закрытой группе:

  1. Добавьте бота в вашу группу комментариев (или любую другую) как администратора (достаточно минимальных прав).
  2. Выберите способ привязки:
    • запустите в группе команду, которую предложит бот: /start bind_<id> Чтобы это сделать, у вас должны быть администраторские права, никто не сможет привязать бота с вашими колодами в посторонние группы.
      После запуска команды вам в бот придет запрос, действительно ли это вы привязываете к своему слоту группу (чтобы ваш слот не занял никто, кроме вас).
      Нажимаете да — и группа привязана.
    • либо перешлите в бота сообщение из этой группы (этот способ может не всегда работать, советую предыдущий).

После успешной привязки бот начнёт работать с вашей группой.

⚠️ Бесплатно доступен один слот для группы. Дополнительные слоты можно приобрести за звёзды.

4. Покупка дополнительных слотов

  • Оплата производится через Telegram Stars.
  • Если у вас нет звёзд, но вы хотите оплатить в рублях переводом на карту — напишите в личку @mariyastr.

5. Использование в группе

  • В комментариях к постам участники пишут ключевое слово вашей колоды. Даже если слово "снабжено" эмодзи или еще парой слов — бот распознает команду.
  • В режиме по умолчанию бот выбирает случайную карту из этой колоды и отправляет её в ответ.

Если у карты есть описание, то оно будет отображено в спойлере под картой (или придет следующим сообщением, если оно больше 1000 символов).

Помощь в настройке

Если что-то не получается, пишите под постом в канале "Боты на работе", из которого вы пришли в эту инструкцию. Разберемся обязательно!