💬 Chat Sync для Starvell — все диалоги с покупателями в одной Telegram-группе

Chat Sync — модуль StarvellBot, который превращает Telegram-группу с включёнными «Темами» в полноценный рабочий мессенджер для Starvell. Каждый чат с покупателем получает свою тему: вы читаете переписку, видите оплаты и отзывы, отвечаете текстом или фото — и сообщение уходит покупателю на Starvell. Работать можно с телефона, не открывая сайт.

✨ Возможности

• 🗂 Тема на каждого покупателя — диалоги не смешиваются, история всегда под рукой.
• 🔄 Двусторонняя связь. Сообщения из темы уходят в чат Starvell; в тему приходят сообщения покупателя, ваши сообщения с сайта, ответы бота и системные события сделки.
• 🔔 События сделки прямо в теме: оплата, подтверждение выполнения, подтверждение получения, возврат, новый и удалённый отзыв (с оценкой и текстом), ответ на отзыв.
• 👀 «Покупатель смотрит» — какой лот покупатель открыл прямо сейчас, со ссылкой.
• 🏷 Название и иконка темы по статистике покупателя: сколько заказов оплачено, закрыто и возвращено.
• 🖼 Фото и стикеры из Telegram уходят покупателю картинками.
• 💬 Заготовки ответов кнопками под полем ввода.
• 🆘 Сотрудники Starvell (поддержка, арбитраж) помечаются отдельно, и бот всегда упоминает вас при их сообщениях.
• 🤖 Работает с одним основным ботом. Дополнительные боты — по желанию, для большого потока сообщений.

🔌 Часть 1. Включение

1. /menu → 🧩 Функции → Chat Sync → 🚀 Включить.
2. ⚙️ Настройки в карточке модуля — это «главное меню модуля»:
   • 📋 Статус и инструкция — готовность к работе и подсказка, что сделать дальше;
   • ⚙️ Переключатели — функции модуля (Часть 4);
   • 🤖 Доп. боты — дополнительные боты (необязательно);
   • 💬 Заготовки ответов — шаблоны для кнопок;
   • 🔄 Создать темы для всех чатов — появляется после привязки группы.

🛠 Часть 2. Группа-форум

1. Создайте группу в Telegram.
2. Настройки группы → включите Темы (в некоторых версиях — «Форум»).
3. Добавьте в группу основного бота (того, через которого вы управляете StarvellBot) и назначьте его администратором с правом «Управление темами». Проще всего выдать все права.
4. Отправьте в группе команду /setup_sync_chat — бот ответит «✅ Группа привязана!». Команду должен отправить человек, который уже вошёл в панель бота (ввёл пароль в личном чате с ботом), и модуль должен быть включён — иначе бот промолчит или попросит включить функцию. Если в группе не включены «Темы», бот попросит их включить.
5. По желанию сразу отправьте /sync_chats, чтобы создать темы для всех текущих чатов Starvell.

⚠️ Пишите в группе от своего имени, а не анонимно: если у вас как администратора включён режим «Анонимность», бот не узнает вас и не отправит сообщение. Сообщения из тем принимаются только от пользователей, у которых есть доступ к панели бота.

Смена группы. /setup_sync_chat в новой группе → бот спросит «Сменить группу для синхронизации?» → ✅ Да, сменить. Связи «тема ↔ чат Starvell» сбросятся; выполните /sync_chats в новой группе.

Отвязка. /delete_sync_chat → ✅ Да, отвязать. Модуль перестанет пересылать сообщения, пока вы не привяжете группу снова.

🤖 Часть 3. Дополнительные боты (по желанию)

Telegram ограничивает одного бота примерно 20 сообщениями в минуту в одну группу. Если покупателей много, добавьте 1–3 дополнительных бота — модуль будет писать в темы по очереди разными ботами.

1. Создайте бота в @BotFather (/newbot) и скопируйте токен.
2. Главное меню модуля → 🤖 Доп. боты → ➕ Добавить бота → пришлите токен.
3. Бот ответит «✅ Бот @… добавлен» и даст ссылку, чтобы добавить его в группу. Сделайте его администратором с правом «Управление темами».

Можно добавить до 10 дополнительных ботов. Удаление — кнопка 🗑 рядом с ботом. Требований к имени бота нет.

Статусы ботов в разделе 📋 Статус и инструкция:

🎛 Часть 4. Переключатели

Главное меню модуля → ⚙️ Переключатели. 🟢 — включено, 🔴 — выключено.

Иконка темы выбирается по приоритету: сотрудник Starvell → покупатель в чёрном списке → есть оплаченный, ещё не закрытый заказ → постоянный клиент (50+, 10+ или 1+ закрытых заказов) → только возвраты → обычная иконка. Название и иконка обновляются при событиях по заказам.

ℹ️ При сообщениях сотрудников Starvell (поддержка, арбитраж) бот упоминает вас всегда, независимо от переключателя.

💬 Часть 5. Общение с покупателями

Ответ покупателю

Откройте тему покупателя и напишите сообщение — оно уйдёт в чат Starvell. После успешной отправки бот ставит на ваше сообщение реакцию 👍. Если отправить не удалось, бот ответит в теме с причиной.

Что можно отправлять:

• ✍️ текст;
• 🖼 фото и картинки-файлы (до 20 МБ — ограничение Telegram на скачивание ботом);
• 🎭 статичные стикеры — будут отправлены картинкой.

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

Важно:

• пишите внутри темы покупателя, а не в общей теме;
• сообщение, начинающееся с команды (/stats), обрабатывается как команда и покупателю не уходит.

Как выглядят сообщения в теме

Несколько сообщений одного автора подряд склеиваются в одно. В начале каждой новой темы бот присылает карточку со ссылками на профиль покупателя и на чат на Starvell.

Если удалить тему

Бот её «забудет» и при следующем сообщении покупателя создаст новую. Старую переписку можно вывести командой /history.

📋 Часть 6. Команды

В группе:

Внутри темы покупателя:

Если ввести эти команды вне темы покупателя, бот ответит «❌ Команду нужно вводить в теме покупателя».

📝 Часть 7. Заготовки ответов

Главное меню модуля → 💬 Заготовки ответов → ➕ Добавить заготовку → пришлите текст. Можно использовать $username — ник покупателя, $date и $time — текущие дата и время. До 30 заготовок; удаление — 🗑. Те же переменные работают и в обычных сообщениях, которые вы пишете в теме.

Чтобы заготовки появились кнопками в темах, включите переключатель 💬 Кнопки заготовок в темах. Кнопки появятся со следующим сообщением бота в теме; если их не видно, нажмите значок клавиатуры справа от поля ввода. Длинный текст на кнопке сокращается, но покупателю уходит полностью.

❓ Частые вопросы

Нужно ли создавать 4 бота-помощника? Нет. Модуль работает на основном боте. Дополнительные боты нужны только при большом потоке сообщений.

Мои сообщения из темы не уходят на Starvell. Проверьте: вы пишете внутри темы покупателя; основной бот — администратор группы; вы пишете не анонимно; у вас есть доступ к панели бота; сообщение не начинается с /; модуль показывает «Готово к работе: ✅ да».

Темы для старых чатов не создались. Отправьте /sync_chats в группе и подождите пару минут. Если бот ответил «⏳ Синхронизация уже идёт» — дождитесь итога.

В названии темы нет цифр. Цифры появляются, когда у покупателя есть заказы. Статистика строится по архиву продаж (обновляется раз в 6 часов) и заказам, которые бот видел сам. Проверьте, что включён переключатель «Название и иконка темы по статистике».

Как временно отключить модуль? /menu → 🧩 Функции → Chat Sync → 🛑 Выключить. Чтобы только отвязать группу, используйте /delete_sync_chat.