Документация › Каналы › Бот в группах WhatsApp
Бот в группах WhatsApp
Обновлено 23 октября 2026 г.
Бот может работать в рабочих группах вашего WhatsApp: отвечать, когда к нему обращаются, или следить за группой и делать задачу, например отмечать в CRM, кто из учеников пришёл. Вы сами выбираете группы, по умолчанию бот не видит ни одной.
⏱ 7 мин · 👤 для владельца и оператора · 🟢 live, открыт всем
За 30 секунд:
- Каналы → WhatsApp → «Группы» → «Показать группы номера», у нужной группы включите «Бот видит эту группу».
- Два режима: «Отвечает, когда к нему обращаются» (отметили ваш номер или ответили на сообщение бота) и «Следит и делает задачу» (задачу пишете вы обычными словами).
- До 5 групп на проект, в группах до 100 участников. Входит в подписку, расход токенов с баланса, как у обычных ответов.
- Сообщения группы видны в «Диалогах» на вкладке «Группы», у каждого сообщения имя автора.
Включить бота в группе
- Подключите WhatsApp проекта по QR, если ещё не подключён: Подключить WhatsApp.
- Каналы → WhatsApp, раздел «Группы», кнопка «Показать группы номера». Список приходит прямо из WhatsApp: название и число участников каждой группы, в которой состоит ваш номер. У нас этот список не хранится.
- У нужной группы включите «Бот видит эту группу» и подтвердите. С этой минуты бот читает группу и может писать в неё с вашего номера, участники видят его сообщения.
- Выберите, что делает бот (ниже), и нажмите «Сохранить».
⚠️ Включайте только рабочие группы: семейный чат или группа друзей тоже окажется в «Диалогах», а бот будет отвечать там от вашего имени.
Выключить можно в любой момент тем же переключателем. После выключения сообщения группы больше не принимаются, а уже сохранённые остаются в «Диалогах».
Режим 1. «Отвечает, когда к нему обращаются»
Бот отвечает, только если:
- в сообщении отметили ваш номер (в WhatsApp:
@и выбрать номер из списка участников); - или ответили на сообщение бота (свайп «Ответить» по его сообщению).
Отвечает коротко, одним сообщением, цитатой того, кому отвечает. На всё остальное молчит, сообщения просто сохраняются в «Диалогах». Бот знает то же, что в личке: ваш промпт, базу знаний, функции.
📌 Пример: в группе продавцов кто-то пишет «@Магазин сколько осталось синих штор 2 м?», бот смотрит остаток функцией склада и отвечает цитатой.
💡 Номер у вас и у бота один. Если вы ответите на отметку сами, бот увидит ваше сообщение и замолчит в этой группе на 30 минут, чтобы не говорить поверх вас.
Режим 2. «Следит и делает задачу»
Бот читает все сообщения группы, обычно молчит и делает задачу группы. Задачу вы пишете обычными словами в поле «Задача бота в этой группе».
📌 Пример для школы: «Педагоги после урока пишут, кто из учеников пришёл. Отметь посещение каждого в CRM и ответь одной строкой, кого отметил». Педагог пишет «Сегодня в 17:00 были Аня и Дима, Саша болеет», бот отмечает посещения функцией CRM и отвечает «Отметил: Аня, Дима. Саша: пропуск».
Как бот бережёт баланс в этом режиме:
- Сообщения группы копятся 3 минуты, потом одна проверка на всю пачку, а не ход на каждое сообщение.
- Сначала лёгкая проверка: есть ли в пачке дело по задаче. Болтовня, приветствия и «спасибо» дальше не идут, такая проверка стоит доли цента.
- Полный ответ бота с функциями только когда дело есть.
- Потолок проверок в день (по умолчанию 100, меняется в настройках группы). Дошли до потолка, бот молчит в группе до полуночи по времени проекта, а вам приходит одно уведомление.
Ещё две настройки режима:
- «Кто даёт боту задания»: все участники, только админы группы или список номеров. Просьбы остальных бот видит, но не выполняет.
- «Расшифровывать голосовые»: включено, бот слушает голосовые в этой группе (расшифровка стоит как обычно). Фото, документы и видео бот читает, только когда к нему обратились (видео при включённом «Смотреть видео» в настройках бота, без фразы «смотрю видео»).
Если в этом режиме бота отметили или ответили на его сообщение, он отвечает сразу, не дожидаясь пачки.
Настоящая отметка участника
Бот (и уведомления в группу) умеет по-настоящему отмечать участника: синее имя и личное уведомление ему, даже если звук группы выключен. Для этого в тексте должно стоять @ и номер участника цифрами: @77011234567. Если номер есть в группе, WhatsApp покажет отметку, иначе номер останется обычным текстом.
📌 Отмены и переносы в группу педагогов: в функции «Уведомление в WhatsApp» выберите группу из списка (кнопка «Выбрать группу из списка»). Ниже откройте «Дополнительно» → «Свои данные для текста уведомления» → «Добавить параметр» и заведите параметр teacher_phone (номер педагога). В шаблоне напишите {{summary}} и Педагог @{teacher_phone}. Бот заполнит номер из данных урока или разговора, педагог получит отметку, а суть с цитатой клиента бот напишет сам в момент отправки.
Где видны сообщения группы
«Диалоги» → вкладка «Группы» (появляется, когда у проекта есть хоть одна группа). В общем списке «Все» группы не показываются, чтобы болтливая группа не прятала клиентов. У каждого сообщения участника стоит его имя и номер. Ответить в группу можно прямо из кабинета, как в обычном диалоге, в том числе цитатой.
Выключить бота только в одной группе можно и из диалога группы, кнопкой бота в шапке.
Что бот в группе НЕ делает
Группа не клиент, поэтому для неё не работает всё «клиентское»:
- заявки и сделки CRM не заводятся, дожимы, напоминания о записях и рассылки не уходят;
- сторож «клиент без ответа» и «ответьте руками» группу не трогают: молчание бота в группе нормально;
- при сбое модели текст «техническая ошибка» в группу не пишется.
Ограничения
| Что | Сколько | Почему |
|---|---|---|
| Групп с ботом на проект | до 5 | бережём номер и баланс |
| Участников в группе | до 100 | первая отправка в большую группу шифрует ключ для каждого устройства каждого участника, это заметная нагрузка на номер. Уведомления в большую группу слать можно |
| Ответов бота в группу | не чаще раза в 20 секунд и не больше 30 в час | защита от петли с чужим ботом в группе и от бана |
| Пачка в режиме «следит» | 3 минуты | одна проверка вместо десятков |
| Пауза, когда вы пишете в группу сами | 30 минут | бот не говорит поверх человека |
Сколько стоит
Функция входит в подписку проекта. Ответы бота в группе списываются с баланса токенов так же, как ответы в личке; лёгкая проверка пачки в режиме «следит» стоит доли цента. Сколько проверок было сегодня, видно в строке группы в настройках. См. Цена сообщения.
Не получилось
| Что видите | Почему | Что сделать |
|---|---|---|
| Кнопка списка групп пишет «номер не на связи» | WhatsApp проекта отключён | Подключите номер заново: Канал не работает |
| Переключатель группы серый | В группе больше 100 участников или уже включено 5 групп | Выключите другую группу или используйте для большой группы только уведомления |
| Бот молчит на отметку | Вы недавно писали в группу сами (пауза 30 минут), бот выключен в диалоге группы, автор не входит в «Кто даёт задания» или кончился баланс | Посмотрите строку группы в настройках и Бот молчит |
| Отметка пришла простым текстом | Номера нет среди участников группы или он записан не цифрами | Проверьте номер в шаблоне: @77011234567 |
💬 Простыми словами
Бот умеет сидеть в ваших рабочих группах WhatsApp. Вы сами выбираете, в каких: в остальные он не заглядывает. В группе он либо отвечает, когда его позвали (отметили номер или ответили на его сообщение), либо тихо следит и делает дело, которое вы ему поручили, например отмечает посещения. Чтобы не тратить деньги на болтовню, он собирает сообщения за 3 минуты и проверяет их разом. Если вы сами пишете в группу, бот на полчаса замолкает.
🔧 Под капотом
- Шлюз WhatsApp пропускает к платформе только группы из списка включённых (
project_wa_groups.enabled), остальные отбрасывает до записи куда-либо. Список шлюз читает при старте номера и получает свежим при каждом изменении в кабинете. - Диалог группы помечен
conversations.kind = 'group',chat_idвидаwg_<id группы>. По этой метке группу обходят лиды, CRM, дожимы, рассылки, сторожа неотвеченных. - Ход бота идёт тем же движком, что ответ в личке (промпт, база знаний, функции, списание), с правилами группы в конце подсказки и без функций заявки (теги, счёт клиенту, сделка CRM). Модель может ответить меткой молчания, тогда в группу ничего не уходит.
- Состав групп кэшируется на 5 минут и сбрасывается событиями WhatsApp об изменении группы: отправка в группу не спрашивает WhatsApp о составе каждый раз.
- MCP:
dosai_list_wa_groupsиdosai_set_wa_group(ИИ-агенты).
Связано: Подключить WhatsApp · Антибан · Уведомления · Диалоги · Функции