Telegram Inbox Setup

Подключение входящих сообщений через qzeroaibot

Этот гайд объясняет, где найти бота, как привязать Telegram‑чат к виджету через код из админ‑панели, и как проверить, что сообщения из виджета приходят в Telegram.

1. Найти бота

В Telegram в поиске набери qzeroaibot, открой чат и нажми Start.

Если бот не отвечает, проверь правильность ника и что чат с ботом открыт, а не группа.

2. Сгенерировать код привязки

1
Открой админ‑панель → Widgets.
Выбери нужный виджет.
2
Нажми кнопку
Bind Telegram
Система покажет команду с уникальным кодом.
Код одноразовый и действует 24 часа.
Кнопка Bind Telegram и выдача кода привязки
Генерация кода привязки в списке виджетов.
Команда bind_widget с кодом для Telegram
Команда для отправки в Telegram с полученным кодом.

3. Привязать Telegram‑группу (Topics обязательны)

Привязка работает только с группами, где включены Topics. Это нужно, чтобы каждое новое обращение из виджета шло в отдельную тему (topic) и переписки не смешивались.

1
Создай группу и включи Темы / Topics (Forum).
Без Topics привязка не сработает.
2
Добавь qzeroaibot и выдай права администратора.
Минимально нужно право Manage Topics.
3
В этой группе отправь команду
/bind_widget <КОД>
Бот подтвердит привязку и покажет widgetId.
Если Topics отключены или у бота нет права Manage Topics, привязка не сработает.
Настройки группы: включение Тем (Topics/Forum)
Где включать Topics: Настройки группы → Темы.
Права администратора для бота: Управление темами
Права бота: обязательно «Управление темами».

4. Ручные ответы и управление ИИ

Команды работают внутри темы (topic) или в личном чате, где бот прислал сообщение из виджета.

1
Выключить автоответ ИИ
/ai_off
Ответь этой командой на сообщение из виджета.
2
Включить автоответ ИИ
/ai_on
Ответь этой командой на сообщение из виджета.
3
Ответить вручную
/answer
Ответь командой на сообщение из виджета, затем напиши текст.

Что должно получиться

✓
Код привязки успешно использован и подтверждён.
✓
Сообщения из виджета дублируются в выбранный Telegram‑чат.
✓
В группе каждое обращение идёт в отдельную тему.
✓
Команды /ai_on, /ai_off, /answer работают по ответу на сообщение из виджета.
OK Если всё настроено верно, тестовое сообщение из виджета сразу появится в Telegram.

Если сообщения не приходят

Проверь список ниже и повтори шаги подключения.
1
Код привязки не истёк (24 часа) и был введён корректно.
2
Привязка сделана именно в том чате, куда нужно получать сообщения.
3
Если это группа: включены Topics и у бота есть право Manage Topics.