Telegram-бот для автосалона — инструкция по подключению

1. 1Откройте в Telegram официальный бот @BotFather (с синей галочкой) и нажмите Start.
2. 2Отправьте команду /newbot.
3. 3Введите название — его видят клиенты в шапке чата. Например: Casa Auto — авто из Кореи.
4. 4Введите username — адрес бота. Только латиница, цифры и «_», в конце обязательно bot. Например: casa_auto_bot.
5. 5BotFather пришлёт сообщение с токеном — длинной строкой вида 7123456789:AAH…. Скопируйте её целиком.

Пример диалога с BotFatherВы: /newbot
BotFather: Alright, a new bot. How are we going to call it?
Вы: Casa Auto
BotFather: Good. Now let's choose a username for your bot…
Вы: casa_auto_bot
BotFather: Done! … Use this token to access the HTTP API:
7123456789:AAH••••••••••••••••••••••••••••••••

Напишите нам в Telegram @motor_feed и отправьте:

• Токен бота из шага 1.
• Название компании — как оно должно звучать в боте.
• Страны, куда вы продаёте (Молдова, Россия, Украина, Беларусь, ОАЭ) — от этого зависит расчёт цены под ключ.
• Какие площадки нужны: Корея (Encar), Китай (Che168) или обе.

Мы зарегистрируем бота, подключим ему ключ MotorFeed API с вашей подпиской и напишем, что всё готово. Платформа сама проверит токен и настроит вебхук, кнопку меню и команды бота.

1. 1Когда мы напишем, что бот подключён, откройте его по ссылке t.me/ваш_бот и нажмите Start.
2. 2Бот поприветствует вас и пришлёт сообщение «👑 Вы стали владельцем этого бота» с кнопкой «⚙️ Управление».
3. 3Нажмите «⚙️ Управление» — внутри Telegram откроется панель управления ботом.

Позже панель открывается так же — кнопкой «⚙️ Управление» или командой /admin в чате с ботом. Обычные клиенты эту кнопку не видят, а на команду /admin получают отказ.

Если первым Start нажал не тот человек — напишите нам, мы сбросим владельца, и вы повторите шаг.

1. 1Отправьте боту /start — проверьте приветствие, логотип и кнопки.
2. 2Нажмите «🚗 Найти автомобиль» — откроется мини-приложение. Посмотрите главную страницу.
3. 3Откройте каталог, задайте фильтры (марка → модель → год, пробег, цена) и откройте карточку авто.
4. 4Проверьте цену под ключ и её расшифровку — совпадает ли с вашим расчётом для вашей страны.
5. 5Оформите тестовую заявку кнопкой «Заказать» и убедитесь, что она пришла вам в Telegram и появилась в панели в разделе «Заявки».
6. 6Нажмите «📞 Связаться с нами» — проверьте телефон, менеджера и адрес.

Попросите коллегу пройти то же со своего телефона — так вы увидите бота на другой теме и другом языке Telegram.

1. 1Клиент нажимает «Заказать» в карточке автомобиля, может оставить комментарий и номер телефона (если запрос телефона включён в «Функции и меню»).
2. 2Клиенту в чат приходит подтверждение: «✅ Заявка №… принята! Менеджер свяжется с вами…» — текст можно изменить в разделе «Тексты».
3. 3Заявка появляется в панели: «Заявки» → список с автомобилем, клиентом и датой.
4. 4Все администраторы бота сразу получают заявку в Telegram: автомобиль, цена, клиент и телефон, кнопки «Написать клиенту», «Открыть авто» и «Все заявки». Уведомления отключаются в «Функции и меню».
5. 5Если указан webhook — заявка в ту же секунду уходит в вашу CRM.

Подключение к CRM (webhook)

1. 1В разделе «Webhook (CRM)» вставьте URL — адрес, который даст ваша CRM или разработчик: Bitrix24, amoCRM, Planfix, свой сервер. Адрес должен начинаться с https://.
2. 2Нажмите «Создать секрет подписи» и передайте секрет разработчику — по нему CRM проверит, что заявка пришла от вашего бота.
3. 3Нажмите «Отправить тест» и посмотрите результат в журнале доставки.

Если CRM была недоступна, платформа повторит отправку несколько раз в течение суток (через 30 секунд, 2 минуты, 10 минут… до 12 часов). Неудачную отправку можно повторить вручную кнопкой «Повторить» в журнале.

{
  "event": "vehicle.order.created",
  "eventId": "…delivery uuid…",
  "createdAt": "2026-10-03T10:00:00.000Z",
  "tenant": { "id": "…", "slug": "casa-auto-bot", "companyName": "Casa Auto" },
  "order": { "id": "…", "number": 17, "comment": "…" },
  "vehicleId": "encar_42365346",
  "provider": "encar",
  "vehicle": { "title": "…", "brand": "BMW", "model": "3 Series", "year": 2021,
               "mileageKm": 88003, "price": { "amount": 18198, "currency": "EUR" }, "url": "…" },
  "customer": { "telegramId": 123456, "username": "max", "firstName": "Max",
                "languageCode": "ru", "phone": "+373…" }
}

sha256=HMAC_SHA256(secret, "<timestamp>.<raw body>")

1. 1Попросите сотрудника открыть вашего бота и нажать Start — без этого его нельзя найти.
2. 2В панели откройте «Администраторы», найдите сотрудника по имени, @username или ID и назначьте его.
3. 3У сотрудника в боте появится доступ к «⚙️ Управление» и команде /admin.

Пароли не нужны: Telegram сам подтверждает, кто открыл панель. Уволился сотрудник — удалите его из списка, и доступ пропадёт сразу.

• Бот создан в @BotFather, токен передан только MotorFeed
• Вы нажали Start первым и получили «👑 Вы стали владельцем этого бота»
• Заполнены название, логотип, приветствие и контакты
• Настроены цены под ключ для ваших стран, проверены на нескольких авто
• Выбраны площадки и их названия в каталоге
• Собрана главная страница
• Заявки приходят нужным людям: администраторы получают их в Telegram, при необходимости подключён webhook в CRM
• Менеджеры добавлены в «Администраторы»
• Тестовая заявка прошла весь путь