Bot token и provider token в Telegram: в чем разница

Bot token и provider token часто путают, потому что оба выдаются через BotFather и оба выглядят как длинные строки с цифрами, двоеточием и буквами. Но это два разных ключа. Один включает самого Telegram-бота. Второй включает прием оплаты.

Если объяснить совсем просто: bot token — это ключ от двери к вашему боту, а provider token — ключ от кассы внутри этого бота. Для платного Telegram-канала обычно нужны оба. Без первого Joinim не сможет управлять ботом. Без второго подписчик не сможет оплатить доступ через Telegram Payments.

Короткий ответ

• Bot token нужен, чтобы подключить Telegram-бота к Joinim. По нему сервис понимает, каким ботом управлять.
• Provider token нужен, чтобы этот бот мог выставлять счета и принимать платежи через Telegram Payments.
• Bot token получают при создании бота через BotFather или в разделе API Token.
• Provider token получают в BotFather в настройках конкретного бота: /mybots -> нужный бот -> Payments.
• Эти токены нельзя менять местами. Если вставить не тот token, настройка остановится или платежи не заработают.

Что такое bot token

Bot token — это секретный ключ конкретного Telegram-бота. Telegram использует его, чтобы понять: этот сервис действительно имеет право получать события от бота, отправлять сообщения от имени бота, ставить кнопки и реагировать на действия пользователей.

В Joinim bot token нужен на первом шаге, когда вы добавляете нового бота. В веб-кабинете это поле называется “Token” в разделе “Боты”. В управляющем боте Joinim это шаг “Введите токен бота”.

Получить bot token можно через BotFather. Если вы создаете нового бота, отправьте /newbot и пройдите короткие вопросы: имя бота и username. После этого BotFather покажет token. Если бот уже создан, откройте /mybots, выберите нужного бота и найдите API Token.

Этот token нельзя публиковать. Относитесь к нему как к паролю. Если человек получил bot token, он потенциально может подключить вашего бота к другому сервису или сломать текущую настройку.

Что такое provider token

Provider token — это ключ платежного провайдера для Telegram Payments. Он не создает бота и не управляет сообщениями. Его задача другая: разрешить вашему боту выставлять счет, принимать оплату и получать подтверждение, что платеж прошел.

В Joinim provider token вводится не при создании бота в списке “Боты”, а на странице конкретного бота в блоке “Платежный шлюз”. В интерфейсе написано: “Telegram Payments через provider token из BotFather”.

Получить provider token можно в BotFather: откройте /mybots, выберите нужного бота, перейдите в Payments, подключите платежного провайдера и скопируйте token, который BotFather покажет после успешного подключения. Для рублевых платежей в Joinim обычно нужен provider token после подключения YooKassa.

Если provider token содержит TEST, это тестовый режим. Он подходит для проверки, но перед настоящими продажами нужен боевой token. В Joinim рядом с полем provider token показывается режим: тестовый или боевой.

Главное различие в одной таблице

• Bot token отвечает на вопрос: “Какой бот должен работать?”
• Provider token отвечает на вопрос: “Через какую платежную кассу этот бот принимает деньги?”
• Bot token вставляют при добавлении бота.
• Provider token вставляют в настройках платежного шлюза.
• Bot token нужен даже для бесплатного бота.
• Provider token нужен только если бот принимает оплату.
• Bot token можно проверить командой getMe или через подключение бота в Joinim.
• Provider token проверяется при создании счета и оплате.

Где взять bot token пошагово

1. Откройте @BotFather в Telegram.
2. Нажмите Start или отправьте /start.
3. Если бота еще нет, отправьте /newbot.
4. Введите имя бота. Его увидят пользователи.
5. Введите username бота. Он должен заканчиваться на bot.
6. Скопируйте строку token, которую покажет BotFather.
7. Вставьте ее в Joinim в разделе “Боты” -> “Добавить бота” -> “Token”.

Если бот уже есть, отправьте /mybots, выберите нужного бота и откройте API Token. Не создавайте второго бота случайно, если уже планировали использовать существующий.

Где взять provider token пошагово

1. Откройте @BotFather.
2. Отправьте /mybots.
3. Выберите того же бота, через которого будете продавать доступ.
4. Откройте Payments.
5. Выберите платежного провайдера и пройдите подключение.
6. Вернитесь в BotFather и скопируйте provider token.
7. В Joinim откройте нужного бота, найдите “Платежный шлюз” и вставьте provider token.

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

Что будет, если перепутать токены

Если вставить provider token в поле обычного Token при создании бота, Joinim не сможет подключить Telegram-бота. Обычно это заканчивается ошибкой проверки token.

Если вставить bot token в поле Provider token, бот может быть подключен, но платежи не заработают. В Joinim есть проверка: provider token должен быть похож на платежный token из BotFather и не должен содержать пробелы. Но даже если строка выглядит похожей, ее смысл должен быть правильным.

Для владельца канала простой тест такой: после bot token бот появляется в списке ботов. После provider token в настройках платежного шлюза появляется статус “подключен”, а тестовая покупка доходит до счета.

Как понять, какой token у вас в руках

• Вы получили строку сразу после /newbot — скорее всего, это bot token.
• Вы нашли строку в /mybots -> API Token — это bot token.
• Вы нашли строку в /mybots -> Payments после подключения YooKassa или другого провайдера — это provider token.
• В строке есть TEST — скорее всего, это тестовый платежный token, то есть provider token для проверки оплат.
• Вы не помните, откуда скопировали token — лучше не угадывать, а заново открыть BotFather и взять нужный token в правильном разделе.

Как это работает в Joinim

В Joinim настройка разделена специально, чтобы не смешивать две разные задачи. Сначала вы подключаете самого Telegram-бота через bot token. После этого добавляете бота администратором в закрытый канал и подтверждаете канал. Затем на странице бота настраиваете платежный шлюз через provider token.

Если вам нужна полная инструкция от нуля, откройте статью как настроить бота для платного Telegram-канала. А если сейчас важна именно оплата, посмотрите разбор Robokassa для Telegram-канала.

Правила безопасности

• Не отправляйте bot token и provider token в общие чаты.
• Не вставляйте token в скриншоты для инструкции или рекламы.
• Не храните token в открытых таблицах и заметках с доступом по ссылке.
• Если token случайно показали чужому человеку, перевыпустите его в BotFather и обновите настройку в Joinim.
• Перед настоящим запуском проверьте, что provider token не тестовый.

Если сомневаетесь, какой token утек, лучше обновить оба: bot token для управления ботом и provider token для платежей. Это неприятно, но спокойнее, чем запускать продажи с неизвестным доступом.

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

Нужно ли иметь provider token, если канал бесплатный? Нет. Provider token нужен только для приема оплат. Для бесплатного бота достаточно bot token.

Можно ли использовать один provider token для нескольких ботов? В Telegram provider token привязан к платежной настройке конкретного merchant-бота. Для владельца проще правило: для каждого продающего бота берите provider token в Payments именно этого бота.

Можно ли сначала создать бота, а оплату подключить позже? Да. В Joinim через управляющего бота можно отправить “-” на шаге provider token и настроить оплату позже. Но подписчики не смогут купить доступ, пока payment token не задан.

Почему Joinim пишет, что provider token не задан? Значит, в настройках конкретного бота нет платежного token. Откройте страницу бота, блок “Платежный шлюз”, вставьте provider token и сохраните.

Итог

Bot token и provider token похожи внешне, но выполняют разные задачи. Bot token подключает Telegram-бота к Joinim. Provider token подключает оплату внутри этого бота. Для платного Telegram-канала сначала нужен bot token, потом канал, потом provider token, затем тариф и тестовая покупка.

После настройки обязательно проверьте путь подписчика: бот показывает тариф, создает счет, принимает оплату и выдает доступ. Если что-то ломается на оплате, полезно пройтись по чеклисту в статье как принимать оплату за Telegram-канал.