Перенеси бота из Telegram за 5 минут

Bot API Переклика совместим с Telegram Bot API. Бот на aiogram 3, grammY, python-telegram-bot или Telegraf переезжает сменой адреса сервера и токена.

API: https://api.pereklik.ru/bot<TOKEN>/<method>
Файлы: https://api.pereklik.ru/file/bot<TOKEN>/<file_path>

1. Получите токен у @BotFather

Откройте Переклик (приложение или web-версию) и привяжите VK ID, Яндекс ID или телефон.
Найдите botfather в поиске или откройте pereklik.ru/botfather.
/newbot, затем имя и username (5–32 символа a-z 0-9 _, в конце bot).
Скопируйте токен. /revoke выдаёт новый токен, если старый утёк.

2. Поменяйте адрес сервера

aiogram 3

from aiogram.client.session.aiohttp import AiohttpSession
from aiogram.client.telegram import TelegramAPIServer

session = AiohttpSession(api=TelegramAPIServer.from_base("https://api.pereklik.ru"))
bot = Bot(token=TOKEN, session=session)

grammY

const bot = new Bot(TOKEN, { client: { apiRoot: "https://api.pereklik.ru" } });

python-telegram-bot

app = (Application.builder().token(TOKEN)
       .base_url("https://api.pereklik.ru/bot")
       .base_file_url("https://api.pereklik.ru/file/bot")
       .build())

Telegraf

const bot = new Telegraf(TOKEN, { telegram: { apiRoot: "https://api.pereklik.ru" } });

3. Отличия от Telegram

Webhook: только https, порты 443/80/88/8443. Самоподписанные сертификаты не принимаются. Фильтр по IP-сетям Telegram надо выключить, в aiogram это IPFilter.default(). Подлинность запроса проверяйте через secret_token.
ID свои. Форма та же (группы отрицательные, каналы -100…), значения другие. Не зашивайте ID из Telegram. Старые file_id здесь не работают.
Диплинки: https://pereklik.ru/<бот>?start=<payload> вместо t.me.
Бот не пишет первым: в личку он пишет только тем, кто сам написал ему.
Апдейты: message, edited_message, channel_post, edited_channel_post, callback_query, my_chat_member.
Нет: inline mode, платежей, стикеров, игр, Web Apps, business, forum topics, опросов, геопозиции, контактов, реакций, restrictChatMember/promoteChatMember. Такие методы отвечают 400 method is not supported by Pereklik Bot API.

Лимиты

Сообщений от бота	30/с
В один личный чат	всплеск 20, затем 1/с
В одну группу или канал	20/мин
Скачивание файла	20 МБ
Загрузка: фото / прочее	20 / 50 МБ

При превышении сервер отвечает 429 с retry_after, как Telegram.

Поддержанные методы

getMe, getUpdates, setWebhook, deleteWebhook, getWebhookInfo, logOut, close, setMyCommands, getMyCommands, deleteMyCommands, setMyName, getMyName, setMyDescription, getMyDescription, setMyShortDescription, getMyShortDescription, sendMessage, forwardMessage, copyMessage, sendChatAction, sendPhoto, sendDocument, sendVideo, sendAnimation, sendAudio, sendVoice, sendVideoNote, sendMediaGroup, getFile, editMessageText, editMessageCaption, editMessageReplyMarkup, deleteMessage, answerCallbackQuery, getChat, getChatMember, getChatAdministrators, getChatMemberCount, leaveChat, banChatMember, unbanChatMember, pinChatMessage, unpinChatMessage.

Форматирование HTML, MarkdownV2, Markdown; inline-кнопки callback_data и url; текстовые reply-клавиатуры.

Вопросы по переносу: support@pereklik.ru.