Telegram — самый удобный канал для старта. Подключение бота занимает 5 минут и не требует прав администратора чужих ресурсов: вы создаёте своего бота, и он работает только с теми клиентами, которые сами с ним заговорили.
Что нужно перед началом
- Аккаунт Telegram (если ещё нет — установите Telegram и зарегистрируйтесь, это бесплатно).
- Аккаунт в ЭТОЧАТБОТЕ (зарегистрироваться по email — 1 минута).
- Идея, как будет называться бот (имя и username, заканчивающийся на
_bot).
Шаг 1. Создайте бота в @BotFather
@BotFather — официальный бот Telegram, через который создаются все боты.
- Откройте Telegram → поиск → @BotFather → «Запустить».
- Отправьте команду
/newbot. - На вопрос «Имя бота» (это видимое имя) — введите, например,
Бот ЭТОЧАТБОТ Тест. Имя можно менять потом. - На вопрос «Username» — введите латиницей, обязательно заканчивая на
_bot. Например,etochat_test_bot. - Если username свободен, @BotFather пришлёт сообщение с токеном — длинной строкой вида
1234567890:AAExxxxxxxxxxxxxxxxxxxxxxx.
Токен — это пароль вашего бота
Любой, у кого есть токен, может писать клиентам от имени бота. Никому не показывайте токен, не публикуйте в чатах, не выкладывайте скриншот настроек. Если показали случайно — пересоздайте токен (см. ниже).
Шаг 2. Скопируйте токен
Полностью выделите строку токена и скопируйте в буфер обмена. Без неё дальше не получится.
Совет
Сразу настройте боту картинку и описание в @BotFather: команды /setuserpic, /setdescription, /setabouttext. Это первое, что увидит клиент, нажав на имя бота.
Шаг 3. Подключите бота к ЭТОЧАТБОТУ
- Войдите в личный кабинет.
- Нажмите «Подключить бота» или перейдите на страницу добавления.
- Выберите соцсеть Telegram.
- Вставьте токен в поле «Токен бота».
- Нажмите «Подключить».
Через 5–10 секунд бот появится в списке ботов с зелёной точкой «Активен».
Что мы проверяем
При подключении мы делаем тестовый вызов к Telegram API: проверяем валидность токена, получаем имя бота и username, регистрируем нашу серверную URL как webhook. Если что-то не так — увидите понятную ошибку.
Шаг 4. Первое сообщение
Найдите своего бота в Telegram по username и нажмите «Start». Это первое сообщение откроется в «Диалогах» ЭТОЧАТБОТА.
Напишите ответ из панели — он мгновенно придёт в Telegram. Подключение успешно.
Совет
Сразу создайте простейшее приветствие: когда любой клиент напишет /start, бот ответит «Здравствуйте! Я — бот компании N, спрашивайте». Без этого бот будет молчать на /start — клиент решит, что «ничего не работает».
Несколько ботов
В ЭТОЧАТБОТЕ можно подключить сколько угодно Telegram-ботов в одну учётку. Каждый — отдельная карточка в «Мои боты». Это удобно, если:
- У вас несколько проектов / клиентов / филиалов.
- Хотите сделать тестового и боевого бота — отлаживать на тесте, использовать на бою.
- Делаете ботов клиентам как агентство.
Если что-то пошло не так
- «Токен не валиден» — проверьте, что скопировали всю строку, без пробелов. Иногда мобильный Telegram копирует только часть.
- «Webhook ошибка» — может быть, что у вас в @BotFather на этого бота уже стоит чей-то webhook (например, от старого сервиса). Откройте @BotFather →
/mybots→ выберите бота → «Bot Settings» → «Group Privacy» — там же будет «Webhook URL». Сбросьте старый. - Бот подключён, но не отвечает на
/start— у вас просто нет сценария «Приветствие». Создайте — см. «Первый сценарий».
Подробнее — в «Ошибки Telegram».
Что дальше
- Токен и username — как пересоздать токен и поменять имя.
- Команды и приватность — настройка
/menu, приватность в группах. - Комментарии под постами Telegram-канала — собирать лиды из-под постов.
- Ошибки Telegram — что значат типичные ошибки.