Документация › Каналы › Бот в группах WhatsApp

Бот в группах WhatsApp

Обновлено 23 октября 2026 г.

Бот может работать в рабочих группах вашего WhatsApp: отвечать, когда к нему обращаются, или следить за группой и делать задачу, например отмечать в CRM, кто из учеников пришёл. Вы сами выбираете группы, по умолчанию бот не видит ни одной.

⏱ 7 мин · 👤 для владельца и оператора · 🟢 live, открыт всем

За 30 секунд:
  • Каналы → WhatsApp → «Группы» → «Показать группы номера», у нужной группы включите «Бот видит эту группу».
  • Два режима: «Отвечает, когда к нему обращаются» (отметили ваш номер или ответили на сообщение бота) и «Следит и делает задачу» (задачу пишете вы обычными словами).
  • До 5 групп на проект, в группах до 100 участников. Входит в подписку, расход токенов с баланса, как у обычных ответов.
  • Сообщения группы видны в «Диалогах» на вкладке «Группы», у каждого сообщения имя автора.

Включить бота в группе

  1. Подключите WhatsApp проекта по QR, если ещё не подключён: Подключить WhatsApp.
  2. Каналы → WhatsApp, раздел «Группы», кнопка «Показать группы номера». Список приходит прямо из WhatsApp: название и число участников каждой группы, в которой состоит ваш номер. У нас этот список не хранится.
  3. У нужной группы включите «Бот видит эту группу» и подтвердите. С этой минуты бот читает группу и может писать в неё с вашего номера, участники видят его сообщения.
  4. Выберите, что делает бот (ниже), и нажмите «Сохранить».

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

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

Режим 1. «Отвечает, когда к нему обращаются»

Бот отвечает, только если:

  • в сообщении отметили ваш номер (в WhatsApp: @ и выбрать номер из списка участников);
  • или ответили на сообщение бота (свайп «Ответить» по его сообщению).

Отвечает коротко, одним сообщением, цитатой того, кому отвечает. На всё остальное молчит, сообщения просто сохраняются в «Диалогах». Бот знает то же, что в личке: ваш промпт, базу знаний, функции.

📌 Пример: в группе продавцов кто-то пишет «@Магазин сколько осталось синих штор 2 м?», бот смотрит остаток функцией склада и отвечает цитатой.

💡 Номер у вас и у бота один. Если вы ответите на отметку сами, бот увидит ваше сообщение и замолчит в этой группе на 30 минут, чтобы не говорить поверх вас.

Режим 2. «Следит и делает задачу»

Бот читает все сообщения группы, обычно молчит и делает задачу группы. Задачу вы пишете обычными словами в поле «Задача бота в этой группе».

📌 Пример для школы: «Педагоги после урока пишут, кто из учеников пришёл. Отметь посещение каждого в CRM и ответь одной строкой, кого отметил». Педагог пишет «Сегодня в 17:00 были Аня и Дима, Саша болеет», бот отмечает посещения функцией CRM и отвечает «Отметил: Аня, Дима. Саша: пропуск».

Как бот бережёт баланс в этом режиме:

  1. Сообщения группы копятся 3 минуты, потом одна проверка на всю пачку, а не ход на каждое сообщение.
  2. Сначала лёгкая проверка: есть ли в пачке дело по задаче. Болтовня, приветствия и «спасибо» дальше не идут, такая проверка стоит доли цента.
  3. Полный ответ бота с функциями только когда дело есть.
  4. Потолок проверок в день (по умолчанию 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 · Антибан · Уведомления · Диалоги · Функции