VPS для WhatsApp-бота на официальном API: webhook, HTTPS и правила платформы
Подключить бота к WhatsApp можно двумя путями, и законный из них один. Официальный путь — WhatsApp Business Platform с облачным Cloud API: компания регистрирует номер, получает токен доступа и обменивается сообщениями через HTTPS. Второй путь — неофициальные библиотеки, которые изображают браузерную версию WhatsApp Web и управляют обычным аккаунтом. Такие клиенты нарушают условия использования WhatsApp: платформа распознаёт их и блокирует номера, иногда вместе с историей переписки. Массовые рассылки людям, которые не давали согласия, запрещены правилами в любом варианте и ведут к блокировке так же быстро. Ниже речь только об официальном API.
Что делает ваш сервер
В Cloud API сообщения хранит и доставляет сама платформа, поэтому сервер бота отвечает только за логику. Его задачи:
- принимать webhook — HTTP-запросы платформы о входящих сообщениях, статусах доставки и прочтения;
- решать, что ответить: сценарий, поиск по базе заказов, передача диалога оператору;
- отправлять ответы POST-запросом к API с токеном доступа;
- хранить историю диалогов и состояние клиента в базе данных.
Браузер, эмуляция телефона и постоянная сессия не нужны, поэтому нагрузка небольшая. Процесс на Node.js или Python с Nginx и PostgreSQL помещается в 1–2 ГБ памяти; больше потребуется, если рядом работают CRM, очереди задач или конструктор сценариев вроде n8n на своём сервере.
Требования к webhook
Адрес для webhook должен быть публичным и работать по HTTPS с действительным сертификатом от доверенного центра сертификации; самоподписанный сертификат платформа не примет. Обычная схема — домен, Nginx на порту 443 с бесплатным сертификатом Let's Encrypt и проксирование запросов на приложение. Дальше важны детали:
- Проверка адреса. При подключении платформа присылает GET-запрос с параметрами
hub.mode,hub.verify_tokenиhub.challenge. Сервер сверяет токен с заданным вами и возвращает значениеhub.challenge. - Подпись. Каждое событие приходит с заголовком
X-Hub-Signature-256— HMAC-SHA256 тела запроса на секрете приложения. Проверяйте подпись до обработки, иначе любой, кто узнал адрес, сможет подсовывать боту поддельные сообщения. - Быстрый ответ. Отвечайте кодом 200 сразу, а обработку ставьте в очередь. Если сервер долго не отвечает, платформа повторяет доставку.
- Повторы. Одно событие может прийти дважды. Запоминайте идентификаторы обработанных сообщений, чтобы бот не ответил клиенту два раза.
Простой сервера означает, что события копятся на стороне платформы и приходят с задержкой. Поэтому оформите приложение как сервис с автоперезапуском и следите за сроком действия сертификата: просроченный сертификат останавливает приём сообщений так же надёжно, как выключенный сервер.
Правила, которые влияют на архитектуру
- Окно 24 часа. Свободный ответ можно отправить в течение 24 часов после последнего сообщения клиента. Позже — только заранее одобренный шаблон, поэтому храните время последнего входящего сообщения для каждого диалога.
- Согласие получателя. Писать первым можно только тем, кто сам дал согласие на сообщения от компании. Бот должен уметь записывать согласие и выполнять отписку.
- Рейтинг качества и лимиты. У номера есть суточный лимит диалогов, которые начинает компания, и он зависит от рейтинга качества. Жалобы и блокировки пользователей снижают рейтинг и лимит. Обходить эти ограничения нельзя, правильный ответ — писать только тем, кто ждёт сообщения.
Ключи и данные
Постоянный токен доступа и секрет приложения дают полный контроль над номером компании. Храните их в переменных окружения или менеджере секретов, а не в коде и не в репозитории, входите на сервер по SSH-ключу. Не пишите в журналы полный текст сообщений и номера телефонов: логи читает больше людей, чем базу, и хранятся они дольше. Для разработки заведите отдельное тестовое приложение с тестовым номером и отдельный адрес webhook, чтобы эксперименты не трогали рабочий номер и его рейтинг качества. Если в базе бота копятся имена, телефоны и адреса клиентов из России, учитывайте требования 152-ФЗ к их хранению — об этом страница VPS для 152-ФЗ. Сам сервер под официальный API может стоять в любой стране: задержка до платформы почти не влияет на скорость ответа клиенту.
Если вы выбираете платформу для бота, сравните требования на страницах VPS для Telegram-бота и VPS для бота ВКонтакте: у них тоже есть официальные API и webhook, но свои правила.