# Чат в виджете

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

Чат работает через канал «Веб-чат» у бота. Как устроен сам канал, что видит оператор и как отключить канал — на странице [Веб-чат](https://support.watbot.ru/chatbots/channels/web). Здесь — настройки чата в виджете.

## Что нужно

- **Бот в том же проекте, что и виджет.** Чат можно связать только с ботом своего проекта.
- **Подписка Pro у владельца бота.** Сам виджет подписки не требует, чат — требует. Без Pro чат не включится, а если подписка закончилась — виджет останется на сайте без чата.
- **Учёт контактов.** Каждый посетитель, открывший чат, становится контактом бота — как человек, написавший боту в мессенджере. От числа контактов зависит цена Pro: см. [Тариф Pro](https://support.watbot.ru/billing/pro).

## Включить чат

1. Откройте виджет, в конструкторе нажмите кнопку с шестерёнкой — откроется панель «Настройки виджета».
2. В строке «Чат с ботом» включите «Показывать чат с ботом в виджете».
3. В поле «Бот» выберите бота проекта.
4. Нажмите «Сохранить».

![Настройки чата и открытая переписка с ботом в виджете](https://support.watbot.ru/_media/ru/04-widgets/_images/chat.webp?v=1791781230)

При сохранении платформа сама подключает боту канал «Веб-чат», если он ещё не подключён. Если виджет уже [установлен на сайте](https://support.watbot.ru/widgets/install), чат появится в нём без изменений на сайте.

С включённым чатом ссылки виджету не обязательны: можно оставить один чат.

## Настройки чата

| Настройка | Что задаёт |
|---|---|
| «Бот» | С каким ботом проекта переписывается посетитель |
| «Заголовок чата» | Строка в шапке чата, до 50 символов. Если пусто — имя бота. Рядом показывается аватар бота |
| «Надпись на кнопке» | Строка чата в списке способов связи, до 50 символов. Если пусто — «Написать в чат» |
| «Подсказка в поле ввода» | Серый текст в пустом поле ввода, до 100 символов. Если пусто — «Напишите сообщение…» |
| «Как открывать» | Режим чата — см. ниже |
| «Принимать файлы от посетителей» | Может ли посетитель присылать файлы |
| «Новых посетителей с одного IP в час» | Защита от накрутки контактов. Поле стоит последним в панели |

Под настройками — строка «Написали из этого чата: …» с числом контактов, пришедших через этот виджет, и ссылка «Открыть переписку»: она ведёт в раздел «Сообщения» бота.

### Режимы: «Как открывать»

| Режим | Как выглядит на сайте |
|---|---|
| «Кнопкой в списке каналов» | Виджет открывается списком: первой строкой — чат, ниже — ваши ссылки. Чат открывается по нажатию на строку |
| «Сразу чатом» | Виджет открывается сразу перепиской. Стрелка «Назад» в шапке чата ведёт к списку ссылок, если они есть |

Первый режим подходит, когда чат — один из способов связи наравне с мессенджерами. Второй — когда чат главный.

### Приём файлов

Переключатель «Принимать файлы от посетителей» включён по умолчанию. В поле ввода чата появляется скрепка, и посетитель может прислать:

- картинки — JPG, PNG, GIF, WebP;
- документы — PDF, Word, Excel, текстовые файлы и CSV;
- аудио и видео.

Ограничения: файл до 10 МБ; от одного посетителя — не больше 20 файлов и 50 МБ в сутки.

> [!NOTE]
> Настройка общая для всех виджетов с этим ботом: выключите её в одном виджете — скрепка пропадёт во всех.

### Новых посетителей с одного IP в час

Каждый новый посетитель чата — платный контакт бота. Чтобы кто-нибудь не завёл их сотнями, открывая чат снова и снова, платформа ограничивает число новых посетителей с одного IP-адреса за час. По умолчанию — 20, можно задать от 0 до 1000; 0 снимает ограничение.

Посетитель сверх лимита увидит «Чат сейчас недоступен, попробуйте позже». Уже начатые переписки ограничение не затрагивает.

> [!TIP]
> Увеличьте значение, если ваши клиенты часто выходят в интернет с одного адреса — например, сотрудники одной крупной компании или посетители одного коворкинга.

## Проверить чат

В конструкторе чат живой: откройте его в виджете и напишите сообщение. Это проверка бота — такая же, как окно «Проверить бота» на схеме: бот отвечает по сценарию, а контактов и статистики такая переписка не добавляет.

## Как чат работает у посетителя

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

### Как посетитель узнаёт об ответе

Если посетитель свернул виджет или ушёл на другую вкладку, а бот или оператор ответил, виджет зовёт его обратно:

| Способ | Что видит посетитель |
|---|---|
| Бейдж | Красный кружок с числом непрочитанных сообщений на кнопке виджета; больше девяти — «9+» |
| Подсказка | Карточка над кнопкой: имя бота (или «Оператор») и начало сообщения. Клик открывает чат, крестик закрывает подсказку |
| Заголовок вкладки | Число в скобках перед названием страницы — например, «(2) Ромашка — доставка цветов» |
| Звук | Короткий сигнал. Звучит только для сообщений, пришедших при открытой странице: после перезагрузки пропущенное показывается молча |

![Свёрнутый виджет: подсказка с ответом и бейдж](https://support.watbot.ru/_media/ru/04-widgets/_images/unread.webp?v=1791781230)

Виджет проверяет новые сообщения примерно раз в 20 секунд, поэтому бейдж появляется с небольшой задержкой. Разрешения на уведомления браузера виджет не запрашивает. Уведомления работают только у тех, кто уже открывал чат на этом устройстве.

## Ограничения чата

- Посетитель может отправить не больше 30 сообщений в минуту.
- Сообщение — до 4096 символов.
- Файл — до 10 МБ; 20 файлов и 50 МБ в сутки от посетителя.
- При переносе виджета в другой проект чат в нём выключается.

Тексты чата — заголовок, надпись на кнопке и подсказка — проверяются платформой так же, как остальные тексты виджета: см. [Проверка виджетов платформой](https://support.watbot.ru/widgets).

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

- **«Канал «Веб-чат» у этого бота выключен, поэтому чат на сайте не показывается.»** Предупреждение в панели настроек: канал отключили на схеме бота. Нажмите «Подключить канал» прямо в предупреждении.
- **При сохранении открывается окно с предложением оформить Pro.** Чат включается только с подпиской.
- **«Бот не найден в проекте виджета.»** Выбранный бот удалён или перенесён в другой проект. Выберите другого.
- **В списке «Бот» пусто — «В проекте пока нет ботов».** Создайте бота в этом проекте или перенесите виджет в проект с ботом.
- **Чата нет на сайте, хотя он включён.** Проверьте по порядку: действует ли Pro у владельца бота, подключён ли у бота канал «Веб-чат», сохранён ли виджет.
- **Посетитель видит «Чат сейчас недоступен, попробуйте позже.»** Причины: у владельца бота закончилась подписка или сработал лимит новых посетителей.
- **Посетитель видит «Слишком много сообщений, подождите немного.»** Сработал лимит 30 сообщений в минуту.
- **Посетитель не может отправить файл.** Сообщения чата объясняют причину: «Файл слишком большой: не больше 10 МБ.», «Такой тип файла не поддерживается. Подойдут изображения, видео, аудио и документы.», «Слишком много файлов, попробуйте завтра.» или «В этом чате нельзя отправлять файлы.» — если приём файлов выключен.