Главная · Справка · Подключение Telegram

Подключение Telegram

Подключение занимает пять минут и не требует своего сервера: вы создаёте бота у @BotFather, вставляете токен в разделе «Каналы» — вебхук на app.chbt.io ЧБТ устанавливает сам. Ниже шаги по порядку, как убедиться, что всё работает, и что делать, если статус канала «Ошибка».

Шаг 1. Создайте бота у @BotFather

Откройте в Telegram @BotFather и отправьте команду /newbot.
Введите имя бота — то, что увидят клиенты в шапке чата («Салон Мята»). Его можно поменять позже командой /setname.
Введите username — латиницей, обязательно с окончанием bot: myata_salon_bot. Он попадёт в ссылку https://t.me/myata_salon_bot и не меняется — выбирайте сразу.
BotFather ответит сообщением с токеном вида 1234567890:AAH…. Скопируйте его целиком.

Токен — пароль бота: кто им владеет, тот управляет ботом. Не пересылайте его в чаты и не публикуйте; если утёк — /revoke у BotFather и новый токен. Подробнее — в справке о токене BotFather. Если бот уже есть (работал в другом сервисе или на своём коде), новый создавать не нужно — подойдёт его токен, подписчики и ссылка сохранятся.

Шаг 2. Вставьте токен в «Каналах»

В кабинете app.chbt.io откройте бота → раздел «Каналы» → в блоке «Подключить новый канал» у карточки Telegram нажмите «Подключить».
При желании заполните «Название канала» для себя (например, «Основной бот»), вставьте токен в поле «Токен» и нажмите «Подключить Telegram».
ЧБТ проверит токен запросом к Telegram и сам установит вебхук с секретным ключом — вручную URL прописывать не нужно, поля для него в кабинете нет.

После этого кабинет откроет «Обзор» бота: в карточке «Каналы» появится строка Telegram со статусом. «Работает» — Telegram принял вебхук, можно переходить к проверке. «Ошибка» — рядом будет ответ Telegram. «Unauthorized» значит, что Telegram не знает такой токен: он скопирован не полностью или уже отозван. «Not Found» — в поле попал не токен, а, например, ссылка на бота. Подключите Telegram ещё раз с действующим токеном, а строку с ошибкой удалите в «Каналах»: кнопка «⋯» → «Удалить». Переписки в ней нет — бот через неё не работал.

Если бот раньше работал в другом сервисе, тот сервис отвечать перестанет: у одного бота один вебхук. Это нормально и означает, что переключение произошло.

Шаг 3. Проверьте с телефона

Откройте «Сценарии»: на карточке нужного сценария должна стоять плашка «Включён», а не «Черновик». Включается сценарий переключателем на его карточке или в списке сценариев на «Обзоре». Пустой новый сценарий и копия создаются черновиками.
Откройте сценарий в редакторе и проверьте, что в нём есть триггер «Команда (/start)».
Откройте ссылку https://t.me/ваш_бот с телефона и нажмите «Начать» (это и есть /start).
Бот должен ответить первым сообщением сценария. В кабинете откройте «Диалоги» — там появился ваш диалог с каналом Telegram.

Сообщение в «Диалогах» есть, а ответа нет — подключение в порядке, дело в сценарии. Бот ответил фразой «Лимит диалогов на бесплатном тарифе исчерпан» — подключение тоже в порядке: на Бесплатном тарифе в этом месяце боту уже написали 30 разных контактов. С ними разговор продолжается, а новым контактам бот отвечает этой фразой, и их сообщения в «Диалоги» не попадают. Нет ни сообщения, ни ответа — вернитесь к статусу канала. Быстро отделить одно от другого помогает кнопка «Проверить сценарий» в редакторе: тест-чат работает без Telegram.

«Переустановить webhook» и письмо об ошибке

Отдельной фоновой проверки вебхука в ЧБТ нет: статус канала меняется только по событиям. «Работает» ставится, когда Telegram принял вебхук при подключении или переустановке и когда от бота приходит входящее сообщение; после успешной отправки от имени бота «Ошибка» тоже сменяется на «Работает». «Ошибка» ставится, когда не удалось подключение или переустановка и когда Telegram отклонил токен при отправке ответа бота, сообщения оператора или рассылки. Если вебхук перехватил другой сервис, статус об этом не узнает — смотрите в «Диалоги».

Кнопка «Переустановить webhook» есть в строке канала в разделе «Каналы». Она заново проверяет токен, сохранённый в канале, и снова ставит вебхук на адрес ЧБТ с секретным ключом, который уже записан в канале. Токен она не меняет. Нажимайте её, если:

бота параллельно запускали своим кодом или в другом сервисе, и тот перехватил вебхук — в «Диалогах» пусто при статусе «Работает». Сначала остановите старый код или уберите токен из того сервиса, иначе он снова заберёт вебхук;
статус «Ошибка», но текст не про токен (например, сетевая ошибка при обращении к Telegram), а токен точно действующий.

Если при отправке Telegram отвечает 401 — токен отозван или заменён у @BotFather, — строка канала переходит в «Ошибку» с текстом «токен бота отклонён (401 Unauthorized)», а владельцу и админам бота приходит письмо «Бот … требует внимания»: не чаще раза в сутки и если в «Уведомлениях» не выключены «Email-уведомления» или пункт «Статус ботов». «Переустановить webhook» здесь не поможет — кнопка работает со старым токеном. Подключите Telegram заново с новым токеном и дождитесь статуса «Работает» у новой строки. Старую строку можно удалить (кнопка «⋯» → «Удалить»), но вместе с ней из «Диалогов» пропадёт вся переписка, которая шла через этот канал. Контакты с тегами и полями останутся. Если в переписке есть что-то важное, сохраните это до удаления.

Полный чеклист причин молчания — в справке «Бот в Telegram молчит», разбор с симптомами — в статье почему Telegram-бот не отвечает.

Что дальше

Тот же сценарий можно запустить в MAX и ВКонтакте, подключив каналы в том же разделе, — переделывать ничего не нужно. Точки входа для клиентов: ссылка https://t.me/ваш_бот, ссылка с меткой ?start=… и QR из раздела «QR-кампании». Метку ловит триггер «Deeplink»: под неё можно завести отдельный сценарий и в нём действием «Добавить тег» отметить источник. Возможности канала — на странице бота для Telegram; если бота ещё нет ни в одном сервисе, начните со статьи как создать Telegram-бота. Telegram входит в Бесплатный тариф — зарегистрируйтесь и подключите бота за пять минут.

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

Нужно ли прописывать webhook вручную?
Нет. При нажатии «Подключить Telegram» ЧБТ сам устанавливает вебхук с секретным ключом. Отдельного поля для URL в кабинете нет; при проблемах — кнопка «Переустановить webhook».

Можно подключить бота, который уже работает в другом сервисе?
Да, тем же токеном. После подключения к ЧБТ прежний сервис отвечать перестанет — у бота один вебхук. Подписчики и ссылка t.me сохраняются.

Статус «Ошибка» с текстом про 401 или Unauthorized — что делать?
Telegram не принимает токен: он отозван, пересоздан у @BotFather или скопирован с ошибкой. Возьмите действующий токен в /mybots → «API Token» и подключите Telegram заново. Старую строку канала удаляйте, помня, что вместе с ней из «Диалогов» пропадёт её переписка; контакты останутся.

Создать бота бесплатно

Токен BotFather Бот молчит: чеклист Бот для Telegram Как создать бота