Документация / Быстрый старт

Запустите первого бота за десять минут

Это руководство проведёт вас через создание Telegram-бота, его подключение к Meshwire и публикацию рабочего сценария.

1. Создайте бота через BotFather

Откройте Telegram, напишите @BotFather и выполните /newbot. Выберите отображаемое имя и уникальное имя пользователя, оканчивающееся на «bot». BotFather вернёт токен HTTP API — скопируйте его, он понадобится на следующем шаге.

/newbot
Alright, a new bot. How are we going to call it?
> Acme Support Bot
Good. Now let's choose a username for your bot.
> acme_support_bot
Done! Use this token to access the HTTP API:
110201543:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw

2. Подключите токен к Meshwire

В консоли перейдите в раздел «Боты → Новый бот», вставьте токен и выберите режим хостинга. Для продакшена рекомендуется режим вебхука; поллинг удобен для быстрого локального тестирования.

POST /v1/bots
{
  "name": "Acme Support Bot",
  "token": "110201543:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw",
  "hostingMode": "webhook",
  "timezone": "Europe/Warsaw"
}

3. Создайте свой первый сценарий

Откройте редактор сценариев и перетащите узел trigger.command на холст (например, /start). Соедините его с узлом msg.text с приветственным сообщением, затем добавьте узел msg.inline_keyboard с кнопками быстрого ответа.

trigger.command(/start)
  -> msg.text("Welcome to Acme Support! How can we help?")
  -> msg.inline_keyboard(["Talk to sales", "Track an order"])

4. Протестируйте в песочнице

Используйте встроенный симулятор, чтобы отправлять тестовые сообщения, не затрагивая реальный трафик Telegram. Он точно отображает, как ваш сценарий будет отвечать, включая кнопки и медиа.

Simulator > /start
Bot: Welcome to Acme Support! How can we help?
     [ Talk to sales ]  [ Track an order ]

5. Опубликуйте

Нажмите «Опубликовать» и добавьте краткое примечание к релизу. Meshwire проверит сценарий, сохранит снимок версии и переключит на неё живой трафик. Вы можете в любой момент откатиться к любой предыдущей версии.

POST /v1/bots/{botId}/publish
{ "note": "Initial launch: welcome + support routing" }

Готовы копнуть глубже?

Изучите Справочник по API или настройте исходящие вебхуки для синхронизации событий с вашими системами.

Читать дальше

Начните с шаблона, а не с чистого листа

В каталоге — больше шестидесяти готовых ботов: локальные услуги, недвижимость, профессиональный приём, операционка, сообщества, путешествия, образование и торговля. Каждый ищется по названию, категории или ключевому слову и несёт честный уровень сложности (Стартовый, Бизнес, Продвинутый, Энтерпрайз) — вы знаете, что берёте, ещё до клика.\nКаждый шаблон ставится с рабочими примерами: магазины — с образцами товаров и платёжным рельсом, записи — с примерами слотов, убираемыми одним кликом. Смысл в том, что бот демонстрирует себя с первого сообщения — образцы вы замените своими данными, когда будете готовы.\nМастер установки проведёт через имя, токен от BotFather и режим работы. Всё остальное — меню, команды, тексты на языках — приходит из шаблона.

Публикация: сначала сохранить, потом в бой

Конструктор различает черновик и опубликованный сценарий. «Сохранить» пишет черновик; «Опубликовать» сохраняет текущий холст и разворачивает его новой нумерованной версией, которую работающий бот подхватывает немедленно.\nПубликация идемпотентна: сценарий, побайтово равный живому, не порождает пустую версию — двойной щелчок безвреден. Каждой публикации можно дать заметку, версии хранятся в истории, и любую прошлую версию можно откатить одним действием на вкладке «Версии».\nКнопка публикации в шапке бота публикует последний СОХРАНЁННЫЙ сценарий — диалог говорит об этом прямо, так что вопрос «какая кнопка что делает» не возникает.