WhatsApp — ИИ для самого популярного мессенджера в мире

WhatsApp есть везде. Более двух миллиардов человек пользуются им ежедневно, и теперь вы можете подключить Hermes прямо к нему. Без аккаунта разработчика Meta. Без верификации бизнеса. Без сложной настройки API. Просто сканируете QR-код — и общаетесь со своим ИИ-агентом из того же приложения, в котором пишете друзьям.

Как это работает

Hermes подключается к WhatsApp через встроенный мост на основе Baileys. Представьте это как эмуляцию сессии WhatsApp Web — точно так же, как вы привязываете браузер к своему телефону. Это не официальный WhatsApp Business API, а значит, вам не нужны никакие специальные разрешения для старта.

Запустите hermes gateway setup и выберите WhatsApp — вас проведут по шагам.

Два способа использования

Режим	Как работает	Для чего подходит
Отдельный номер для бота (рекомендуется)	Выделите номер телефона под бота. Люди пишут на этот номер напрямую.	Чистый UX, несколько пользователей, ниже риск бана
Личный self-chat	Используете свой WhatsApp. Пишете самому себе, чтобы общаться с агентом.	Быстрая настройка, один пользователь, тестирование

Подход с отдельным номером для бота чище — у вашего ИИ своя идентичность, и вы не смешиваете личные чаты с разговорами с ботом. Режим self-chat идеален для быстрого тестового запуска.

Перед началом

Вам понадобится:

Node.js v18+ и npm — мост WhatsApp работает как Node.js-процесс
Телефон с установленным WhatsApp (для сканирования QR-кода)

Хорошая новость: в отличие от старых браузерных мостов, вам не нужно устанавливать Chromium или Puppeteer. Настройка гораздо легче.

Шаг 1: Запустите мастер настройки

hermes whatsapp

Мастер выполнит следующее:

Спросит, какой режим вам нужен (bot или self-chat)
Установит зависимости моста, если потребуется
Покажет QR-код в вашем терминале
Будет ждать, пока вы его отсканируете

Как отсканировать QR-код:

Откройте WhatsApp на телефоне
Перейдите в Настройки → Связанные устройства
Нажмите Привязать устройство
Наведите камеру на QR-код в терминале

После сопряжения мастер подтвердит подключение и завершит работу. Ваша сессия сохраняется автоматически.

Совет: Если QR-код выглядит нечитаемо, убедитесь, что ваш терминал имеет ширину не менее 60 колонок и поддерживает Unicode. Также можно попробовать другой эмулятор терминала.

Шаг 2: Получение второго номера телефона (режим бота)

Для режима бота нужен номер, который ещё не зарегистрирован в WhatsApp. Вот ваши варианты:

Вариант	Стоимость	Примечания
Google Voice	Бесплатно	Только для США. Получите номер на voice.google.com. Подтвердите WhatsApp через SMS в приложении Google Voice.
Prepaid SIM-карта	$5–15 разово	Любой оператор. Активируйте, подтвердите WhatsApp, затем SIM-карта может лежать в ящике. Номер должен оставаться активным (совершайте звонок каждые 90 дней).
VoIP-сервисы	Бесплатно–$5/мес	TextNow, TextFree или аналогичные. Некоторые VoIP-номера блокируются WhatsApp — попробуйте несколько, если первый не сработает.

После получения номера:

Установите WhatsApp на телефон (или используйте приложение WhatsApp Business с двумя SIM-картами)
Зарегистрируйте новый номер в WhatsApp
Запустите hermes whatsapp и отсканируйте QR-код из этого аккаунта WhatsApp

Шаг 3: Настройка Hermes

Добавьте следующее в файл ~/.hermes/.env:

# Обязательно
WHATSAPP_ENABLED=true
WHATSAPP_MODE=bot                          # "bot" или "self-chat"

# Контроль доступа — выберите ОДИН из этих вариантов:
WHATSAPP_ALLOWED_USERS=15551234567         # Номера телефонов через запятую (с кодом страны, без +)
# WHATSAPP_ALLOWED_USERS=*                 # ИЛИ используйте * для разрешения всем
# WHATSAPP_ALLOW_ALL_USERS=true            # ИЛИ установите этот флаг (эффект тот же, что и *)

Сокращение «разрешить всем»: Установка WHATSAPP_ALLOWED_USERS=* разрешает всех отправителей. Чтобы вместо этого использовать механизм сопряжения, удалите обе переменные и положитесь на систему сопряжения через личные сообщения.

Дополнительные настройки поведения в ~/.hermes/config.yaml:

unauthorized_dm_behavior: pair

whatsapp:
  unauthorized_dm_behavior: ignore

unauthorized_dm_behavior: pair — глобальное значение по умолчанию. Неизвестные отправители личных сообщений получают код для сопряжения.
whatsapp.unauthorized_dm_behavior: ignore — WhatsApp остаётся молчаливым для неавторизованных личных сообщений — обычно лучший выбор для личного номера.

Затем запустите шлюз:

hermes gateway              # На переднем плане
hermes gateway install      # Установить как пользовательский сервис
sudo hermes gateway install --system   # Только Linux: системный сервис с автозапуском

Шлюз автоматически запускает мост WhatsApp, используя сохранённую сессию.

Сохранение сессии

Мост Baileys сохраняет свою сессию в ~/.hermes/platforms/whatsapp/session. Это означает:

Сессии переживают перезагрузки — вам не нужно сканировать QR-код каждый раз
Данные сессии включают ключи шифрования и учётные данные устройства
Не делитесь и не коммитьте эту директорию сессии — она даёт полный доступ к аккаунту WhatsApp

Повторное сопряжение

Если сессия сломалась (сброс телефона, обновление WhatsApp, ручная отвязка), вы увидите ошибки подключения в логах шлюза. Чтобы исправить:

hermes whatsapp

Это сгенерирует новый QR-код для повторного сопряжения.

Небольшое предостережение

WhatsApp официально не поддерживает сторонних ботов вне Business API. Использование стороннего моста несёт небольшой риск ограничений аккаунта. Чтобы минимизировать риск:

Используйте выделенный номер телефона для бота (не ваш личный номер)
Не отправляйте массовые/спам-сообщения — держите использование в рамках переписки
Не автоматизируйте исходящие сообщения людям, которые не написали вам первыми

Кроме того, WhatsApp периодически обновляет свой веб-протокол, что может временно нарушить совместимость со сторонними мостами. Когда это происходит, Hermes обновляет зависимость моста. Если бот перестал работать после обновления WhatsApp, установите последнюю версию Hermes и выполните повторное сопряжение.

Нужно что-то более официальное?

Если вы запускаете настоящего бизнес-бота и хотите стабильности, обратите внимание на руководство по WhatsApp Business Cloud API. Это официальный путь от Meta: нет риска бана аккаунта, но требуется бизнес-аккаунт Meta и публичный webhook URL. Оба адаптера также могут работать параллельно с разными номерами телефонов, если у вас есть такая необходимость.

Впрочем, для большинства личных проектов и экспериментов мост Baileys — самый быстрый способ добавить ИИ в ваш WhatsApp. Сканируйте, настраивайте и начинайте общаться.