Перейти к основному содержимому

Частые вопросы

С чего начать?​

См. Быстрый старт — простой эхо-бот за 5 минут.

Как создать бота?​

  1. Откройте Telefon
  2. Найдите @botmaker
  3. Нажмите «➕ Новый бот»
  4. Введите имя и @username
  5. Скопируйте токен (показывается один раз!)

Какие библиотеки рекомендуете?​

Зависит от языка:

  • Python: aiogram (современный async) или python-telegram-bot (стабильный)
  • Node.js / TypeScript: grammy
  • JavaScript: Telegraf или node-telegram-bot-api

См. SDK.

Long-polling или Webhook?​

  • Long-poll — для разработки, простых ботов, без публичного домена
  • Webhook — для прода, мгновенный отклик, требует HTTPS

См. сравнение.

Я потерял токен. Что делать?​

@botmaker → бот → «🔑 Токен» → «🔄 Выпустить новый». Старый перестаёт работать.

Можно ли запустить бота на бесплатном хостинге?​

Да. Подходят: Replit, Railway, Render, Fly.io, Vercel (для webhook). Long-poll бот работает на любом VPS от 100₽/мес.

Лимиты для бота?​

  • 30 запросов в секунду на токен
  • 30 одновременных соединений
  • 1 сообщение в секунду в один чат
  • 30 в секунду в разные чаты

См. Errors and Rate Limits.

Бот может писать первым?​

Нет. Бот может писать только тем, кто уже написал ему первым (нажал «Начать», написал команду или добавил его в группу). Это защита от спама.

Можно ли скрыть бота от поиска?​

В настройках бота через @botmaker пока нет такой опции — все боты публичны через @username.

Альтернатива — использовать Access Control: даже если бота нашли по @username, он будет отвечать только избранным.

Можно ли передать бота другому пользователю?​

Да. Настройки бота → секция «Передать бота» → @username нового владельца. После передачи вы теряете доступ.

Как протестировать webhook локально?​

Используйте туннели:

  • ngrok: ngrok http 8000 → даёт публичный HTTPS URL
  • cloudflared: cloudflared tunnel --url localhost:8000
  • localtunnel: npx localtunnel --port 8000

Затем setWebhook с URL от туннеля.

Бот падает с 401 Unauthorized​

Токен невалиден. Проверьте:

  1. Правильно ли скопирован (без пробелов)
  2. Не сбросили ли вы его в @botmaker
  3. Правильный ли URL: https://api.telefon.chat/bot<TOKEN>/getMe

Как локализовать бота?​

См. Имя/описание и Команды — все принимают language_code.

Где обсудить вопросы?​

Email: dev@telefon.chat. Чат разработчиков: создаётся, ссылка появится здесь.

Где репортить баги?​

Email dev@telefon.chat или через бота @botmaker командой /feedback.

Сколько стоит?​

Bot API бесплатен. Tariff на медиа-storage и количество ботов — пока без ограничений в beta.