1. С чего начать

1. Откройте бота по ссылке выше.
2. Нажмите Старт или напишите боту: /start.
3. Появится меню с направлениями перевозок — выбирайте кнопками под сообщением.

Полезные команды:

• /start — вернуться в главное меню
• /help — краткая справка
• /id — показать ваш номер в мессенджере (нужен, чтобы выдать права менеджера)

2. Как оформить заявку

1. В главном меню выберите направление: железная дорога, авто, спецтехника, специалисты, море/реки или авиа.
2. Выберите, что нужно: например «Заявка на перевозку» или «Предложить транспорт».
3. Отвечайте на вопросы по порядку. Где есть готовые варианты — нажимайте кнопки. Где нужно — пишите текстом.
4. Если ошиблись — кнопка «« Назад» вернёт к предыдущему вопросу.
5. В длинном списке вариантов стрелки « Назад» / Далее » только листают страницы списка, а не шаги заявки.
6. В конце укажите имя, email и телефон (можно кнопкой «Передать номер»).
7. Проверьте сводку и нажмите «Отправить» / «Опубликовать».

3. Как спросить менеджера

1. Убедитесь, что вы не заполняете заявку прямо сейчас (если заполняете — сначала /start).
2. Просто напишите боту обычным текстом свой вопрос.
3. Бот ответит, что вопрос передан менеджерам.
4. Когда менеджер ответит — сообщение придёт вам в эту же переписку с ботом.

4. Как ответить пользователю (для менеджеров)

Ответы идут через служебный чат менеджеров (отдельный чат в Telegram или MAX, куда бот пересылает вопросы).

1. В служебном чате появится сообщение вида:
   «Вопрос от: Имя, id …, тел. …» и ниже — текст пользователя.
2. Нажмите на это сообщение и выберите «Ответить» (Reply) — как обычный ответ в чате.
3. Напишите текст ответа и отправьте.
4. Бот сам доставит ответ пользователю в личные сообщения. В чате менеджеров ваш ответ видят все коллеги.

5. Как сделать рассылку (для менеджеров)

1. Откройте личную переписку с ботом (не групповой чат).
2. Напишите: /send.
3. Пришлите текст рассылки одним сообщением.
4. Выберите, кому отправить: «Все подписчики» или нужное направление (кнопками).
5. Дождитесь отчёта бота: сколько сообщений ушло и были ли ошибки.

Передумали — нажмите «Отмена» или напишите /start.

5.1. Блокировка пользователя (для менеджеров)

В сводном чате логистов в конце каждой заявки бот пишет код автора: T123 (Telegram) или M123 (MAX).

1. В личке бота напишите /ban и код, например: /ban T480123918 или /ban M200326995.
2. Если код не указать — бот сам попросит его следующим сообщением.
3. Снять блок: /unban с тем же кодом.

Заблокированный при любом сообщении боту видит: «Вы заблокированы, доступ невозможен!» и не попадает в рассылки.

6. Как выдать права менеджера

Сначала человек должен хотя бы раз написать боту /start или его нужно добавить в служебный чат менеджеров — тогда права выдадутся сами.

Автоматически: все участники чата менеджеров (Telegram и MAX) получают право менеджера и доступ ко всем направлениям. Удалили из чата — бот снимает право менеджера. Отвечать на вопросы пользователей в этом чате может любой участник (отдельная проверка прав не нужна).

Дальше откройте базу данных (если нужно выдать права вручную, без добавления в чат):

Через поиск в таблице (удобнее)

1. В левом списке таблиц откройте:
   • lg_user_tg — если человек в Telegram;
   • lg_user_max — если человек в MAX.
2. Нажмите вкладку «Поиск» (или «Search»).
3. В поле id укажите номер менеджера, например 480123918.
4. Нажмите «Вперёд» / Enter — откроется найденная строка.
5. В поле adm поставьте 1 (это право менеджера).
   Если нужен полный доступ администратора — поставьте 129 (менеджер + суперадмин).
6. В поле directions поставьте 63 — доступ ко всем направлениям.
   (Или меньше, если нужно ограничить: ЖД=1, авто=2, спецтехника=4, специалисты=8, АКВА=16, авиа=32 — числа можно складывать.)
7. Поле deleted оставьте пустым (если там дата — очистите).
8. Кликните мышью вне поля или нажмите Enter / «Вперёд» внизу формы — изменение сохранится.

UPDATE lg_user_tg
SET adm = 1, directions = 63, deleted = NULL
WHERE id = 480123918
LIMIT 1;

7. Как править справочники и куда уходят заявки

Это делают через ту же базу: phpMyAdmin → Logist_bot_base.

Кнопки в боте (типы вагонов, кузовов и т.п.)

Таблица: lg_dict.

1. Откройте таблицу lg_dict.
2. Нажмите «Показать» / «Browse», чтобы увидеть список.
3. Чтобы изменить подпись кнопки — найдите нужную строку (можно через «Поиск» по полю title), в колонке title впишите новый текст и сохраните (клик вне поля).
4. Чтобы скрыть пункт — в поле is_active поставьте 0 (строка останется в базе, но в боте кнопка исчезнет).
5. Чтобы добавить новый пункт — вкладка «Вставить» / «Insert» и заполните:
   • dict_group — группа (как у похожих строк, например wagon_type или body_type);
   • dict_key — короткий латинский ключ без пробелов (например my_type_1);
   • title — текст, который увидит пользователь на кнопке;
   • sort_order — порядок в списке (чем меньше число, тем выше);
   • is_active — 1;
   • created_at и updated_at — текущие дата и время.

INSERT INTO lg_dict (dict_group, dict_key, title, sort_order, is_active, created_at, updated_at)
VALUES ('wagon_type', 'my_key_1', 'Мой тип вагона', 99, 1, NOW(), NOW());

Куда публикуются заявки (чаты и Google Таблицы)

Таблица: lg_publish_target.

1. Откройте таблицу и нажмите «Показать».
2. Каждая строка — один канал: Telegram-чат, MAX-чат или Google Таблица.
3. Важные поля:
   • direction_mask — направление (1 ЖД, 2 авто, 4 спецтехника, 8 специалисты, 16 АКВА, 32 авиа);
   • kind — тип заявки (как в уже существующих строках);
   • platform — tg, max или sheets;
   • target_id — id чата (для tg/max);
   • sheet_id — id таблицы из ссылки Google (для sheets);
   • is_active — 1 публиковать, 0 временно выключить.
4. Чтобы добавить канал — «Вставить», скопируйте значения с похожей строки и замените id чата / таблицы.

Узнать id чата: добавьте бота в чат администратором и напишите в чате /id — бот покажет число чата.

Посмотреть заявки

Таблица lg_order → «Показать». Там статус, телефон, имя и текст полей заявки.

8. Если что-то не работает

• Заявка не появилась в чате — бот должен быть администратором чата/канала с правом публиковать сообщения. Проверьте в lg_publish_target, что нужная строка есть и is_active = 1.
• Пользователь не получил ответ — отвечайте именно через «Ответить» на сообщение бота в служебном чате; у вас должно быть право менеджера (adm = 1).
• Бот пишет, что /send только для менеджеров — выдайте права по разделу 6.
• Не пишется в Google Таблицу — таблица должна быть открыта для сервисного аккаунта бота (это настраивает администратор сервера).

На главную bot.gruzitransport.com
gruzitransport.com