Чат-комната на сайте

Чат-комната — это публичная страница чата прямо на домене платформы. Посетитель открывает её в браузере и сразу общается с вашим ботом: без Telegram, без установок и без входа в личный кабинет. Дизайн максимально простой — только переписка, ничего лишнего.

Каталог ботов

Боты, включённые для чат-комнаты, показываются на общей странице-каталоге со своим описанием и статусом «в сети». У каждого бота свой короткий адрес — например, «/chatroom/help-desk». Так посетитель может выбрать нужного бота, не заходя ни в Telegram, ни в приложение.

Как включить

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

Посетители без регистрации

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

Список переписок и аккаунт по желанию

Слева — вкладка со всеми разговорами гостя с разными ботами: поиск, пометка канала, последнее сообщение и время. Разговор можно переключить и продолжить — у каждого своё состояние. По желанию можно зарегистрироваться (имя, почта, пароль) или войти. При входе все анонимные переписки этого устройства переходят в аккаунт и становятся доступны на любом другом устройстве. Выход возвращает устройство в анонимное состояние, а сам аккаунт остаётся целым.

Связка с Telegram

Посетитель может связать свой Telegram с сайтом. Ему выдаётся короткий одноразовый код и ссылка для перехода в Telegram: открыл или отправил код боту — и переписки из Telegram появляются в списке на сайте, их можно продолжать с сайта. Связку можно и снять: переписки из Telegram перестанут показываться на сайте, но история на сервере сохранится, а подключить заново можно в любой момент. В управлении связкой Telegram показан понятным именем, а не номером.

То же поведение, что в Telegram

Сообщения с сайта проходят тот же путь, что и в Telegram: те же сценарии, те же правила, та же передача оператору. Работают кнопки, отложенные сообщения, рассылки и ответы оператора. Если бот остановлен, страница честно показывает «не в сети», а отправка отклоняется — клиент не будет думать, что его услышали.

Обновления в реальном времени

Ответы приходят на страницу сразу, без перезагрузки, и показывается индикатор «печатает». Гости изолированы друг от друга: чужую переписку увидеть невозможно.

Защита от злоупотреблений

Действуют ограничения на частоту и длину сообщений. Если посетитель пишет слишком часто, страница прямо объясняет причину и предлагает отправить ещё раз. Доступ к чужому разговору закрыт, а несуществующий разговор ничем не отличается от чужого — то есть по ответу нельзя понять, существует ли такой разговор.

Взаимодействие с оператором

Переписка с сайта появляется у оператора с пометкой канала и полной историей. Ответ оператора приходит посетителю прямо на страницу. Всё это — в разделе Входящие, рядом с разговорами из Telegram и виджета.

Если вам нужен чат не на отдельной странице, а прямо на вашем сайте, — читайте раздел Виджет для сайта. Про работу оператора — раздел Входящие, про настройку бота — раздел Боты.

← Оглавление документации