Перейти к содержанию

Настройка Телеграм-бота

Telegram-бот — необязательный дополнительный канал для клиентского приложения Tellem. Без него покупатели продолжают открывать приложение по ссылке в браузере или как установленное PWA. Если вы хотите использовать Telegram, создайте бота, подключите его к CRM и настройте приветственное сообщение.

Обзор остальных необязательных подключений находится на странице «Интеграции».

1. Создайте бота в @BotFather

  1. Откройте Telegram и найдите официального бота @BotFather.
  2. Отправьте команду /newbot.
  3. Укажите имя бота — его увидят покупатели.
  4. Укажите @username бота — он должен заканчиваться на bot.
  5. BotFather пришлёт токен вида 1234567890:AA…. Скопируйте его — он понадобится на следующем шаге.

По желанию задайте боту аватарку (/setuserpic) и описание (/setdescription).

Токен — это ключ к вашему боту

Никому не передавайте токен и не публикуйте его. Единственное место, куда его нужно ввести, — экран «Интеграции → Telegram» в CRM.

2. Подключите бота к CRM

Откройте в CRM пункт меню «Интеграции → Telegram».

  1. Включите переключатель рядом с заголовком «Интеграция с Telegram». Пока он выключен, CRM не использует токен и бот не отвечает на сообщения; остальные настройки экрана появляются после включения.
  2. В поле «Токен бота» вставьте токен из BotFather.

Кнопки «Сохранить» на экране нет

Все настройки этого экрана сохраняются автоматически сразу после изменения.

Больше ничего подключать не нужно: после включения интеграции и ввода токена CRM сама соединяется с серверами Telegram и принимает сообщения покупателей. Webhook, URL бэкенда и другие технические параметры не настраиваются.

3. Настройте приветственное сообщение

Блок «Приветственное сообщение» находится на том же экране «Интеграции → Telegram». Бот отправляет это сообщение в ответ на команду /start — это первое, что видит покупатель, открывший бота.

Текст

Введите текст в поле блока «Приветственное сообщение». Пока свой текст не задан, бот отвечает стандартным «Welcome!».

Поле работает в двух режимах — их переключает настройка «Мультиязычный редактор» на экране «Настройки → Основные»:

  • переключатель включён — при редактировании открывается мультиязычный редактор, и вы задаёте отдельный текст для каждого языка;
  • переключатель выключен — это обычное текстовое поле, один текст для всех покупателей.

Картинка

Нажмите «Загрузить файл» и выберите изображение — бот отправит его вместе с приветствием, а текст станет подписью к картинке. Без загруженной картинки бот отправляет только текст. Максимальный размер файла — 10 МБ, форматы: PNG, JPG/JPEG, SVG, GIF, WebP, BMP, HEIC.

Кнопки-ссылки

Нажмите «Функциональные кнопки» — откроется окно со списком кнопок, которые бот показывает под приветственным сообщением. Такой кнопкой удобно вести на сайт, канал или страницу с акциями.

  • «Создать» — добавить кнопку: заполните «Текст кнопки» и адрес ссылки (префикс https:// уже подставлен), затем нажмите «Сохранить». Текст кнопки подчиняется тому же режиму «Мультиязычный редактор», что и текст приветствия.
  • «Изменить» и «Удалить» — редактирование и удаление выбранной кнопки.

Каждая кнопка выводится в сообщении отдельной строкой. Ниже ваших кнопок бот автоматически добавляет кнопку, открывающую клиентское приложение прямо в Telegram. Её название зависит от типа бизнеса, выбранного в мастере настройки при первом входе в CRM:

Тип бизнеса в мастере настройки Кнопка в сообщении
«Офлайн магазин / сеть магазинов» «Открыть Магазин»
«Онлайн-магазин» «Открыть Каталог»
«Ресторанный / кафе» «Открыть Меню»

Если тип бизнеса не выбран, кнопка называется «Открыть Магазин».

4. Кнопка меню в BotFather — по желанию

Покупатели открывают клиентское приложение кнопкой из приветственного сообщения, поэтому этот шаг не обязателен. Если хотите, чтобы приложение открывалось ещё и кнопкой меню рядом с полем ввода, настройте её в BotFather:

  1. Отправьте @BotFather команду /mybots и выберите вашего бота.
  2. Откройте «Bot Settings → Menu Button» и выберите настройку кнопки меню.
  3. Укажите адрес клиентского приложения — https://<ваш-магазин>.tellem.store. Этот адрес выдаёт команда Tellem при подключении (см. Подключение и доступ к CRM).

5. Проверьте работу

  1. Откройте вашего бота в Telegram и отправьте /start.
  2. Бот ответит приветственным сообщением — с картинкой и кнопками, если вы их настроили.
  3. Нажмите кнопку открытия — внутри Telegram запустится клиентское приложение с каталогом.

Если бот не отвечает, откройте «Интеграции → Telegram» и проверьте, что переключатель включён, а токен вставлен целиком и без лишних пробелов.