Уборка снега требует своевременного оповещения жителей о необходимости убрать автомобили. В противном случае возникают сложности с «подснежниками» – машинами, которые простаивают всю зиму, а также с жильцами которые игнорируют объявления на подъездах. Обзвон всех жильцов отнимает много времени.
WhatsApp выглядит привлекательным способом оповещения. К примеру, в нашем ТСЖ недавно создали WhatsApp-группу и предполагается что WhatsApp есть у всех жителей. А ещё бывают люди, подключающие домовой чат в качестве эпизодического развлечения: отключают для него уведомления и просто копят непрочитанные.
Хотя скрипт полностью рабочий и протестированный, он ещё не был опробован в реальной жизни при рассылке сообщений - когда я подошёл с таким предложением к нашему председателю, то он не особо впечатлился, предпочтя более привычный обзвон.
Установка и настройка
Чтобы настроить автоматическую рассылку сообщений, нужно подготовить рабочую среду. Это не займет много времени, даже если вы раньше не занимались программированием.
Первым шагом является установка Node.js - инструмента, который позволяет запускать JavaScript-код на компьютере. Без него скрипт попросту не заработает. Перейдите на официальный сайт Node.js, скачайте рекомендованную версию (LTS) и установите её, следуя подсказкам на экране. Убедиться, что всё установлено правильно, можно, открыв терминал и введя команду node -v. Она покажет текущую версию Node.js.
Следующий важный элемент — библиотека whatsapp-web.js. Она обеспечивает взаимодействие с веб-версией WhatsApp, позволяя автоматически отправлять сообщения. Это основной инструмент, который делает весь процесс рассылки возможным.
Помимо этого, мы будем использовать библиотеку qrcode-terminal, чтобы вывести QR-код прямо в консоли. Он потребуется для подключения вашего аккаунта WhatsApp к скрипту. Это быстрое и удобное решение, чтобы не прибегать к сложным настройкам.
Для обработки списка номеров жильцов пригодится библиотека xlsx. Она позволяет читать и работать с Excel-файлами, из которых скрипт будет брать контакты для рассылки. Это значительно упрощает подготовку данных и исключает необходимость вручную переносить номера.
Соблюдение лимитов для предотвращения бана аккаунта
Автоматическая рассылка сообщений через WhatsApp — отличное решение, но важно помнить о существующих ограничениях, чтобы избежать блокировки аккаунта. WhatsApp внимательно отслеживает подозрительную активность, и массовая рассылка может быть воспринята как нарушение правил.
Ключевое ограничение — суточный лимит на количество отправленных сообщений. С одного аккаунта нельзя отправить больше 1000 сообщений в день (у меня нет официальной информации на этот счёт). Но для ТСЖ это не должно стать проблемой, ведь даже при большом количестве жильцов обычно достаточно 200-300 сообщений.
Еще один важный момент - скорость отправки. Если отправлять сообщения слишком быстро, система может заподозрить неестественное поведение. Рекомендуется не превышать 5-15 сообщений в минуту. Для этого в скрипте можно встроить задержки между отправками, чтобы рассылка выглядела максимально естественно.
Также стоит позаботиться об уникальности текста сообщений. Если отправлять однотипные фразы, это может вызвать подозрения у алгоритмов WhatsApp. Добавление персонализации - например, имени, отчества или информации о марке машины — делает сообщения индивидуальными.
Простое сообщение вроде «Уважаемый(ая) ${person.Name},
завтра будет проводиться уборка снега с 9:00 до 15:00. Просим вас заранее убрать автомобиль ${person.Car || ' '} с парковки, чтобы работа прошла быстро и качественно.
Спасибо за понимание!» выглядит естественнее и снижает риск блокировки.
Соблюдение этих правил поможет использовать WhatsApp для рассылок без риска потери доступа к аккаунту.
Сам скрипт рассылки всем членам ТСЖ сообщений о завтрашней уборке снега через WhatsApp
Для организации автоматической рассылки сообщений через WhatsApp потребуется выполнить несколько шагов. Первым делом нужно установить необходимые зависимости. Используйте команду npm install whatsapp-web.js xlsx qrcode-terminal. Она загрузит библиотеку для работы с WhatsApp, модуль для работы с Excel-файлами и генератор QR-кодов.
Затем нужно подготовить список контактов в формате Excel. Файл должен включать три обязательные колонки: Name (имя), Phone number (номер телефона) и Car (марка автомобиля). Убедитесь, что данные заполнены корректно, так как скрипт будет использовать их для отправки сообщений.
Следующий этап — редактирование шаблона сообщений. Код уже включает базовый текст, например:
Уважаемый(ая) Иван Иванович, Завтра будет проводиться уборка снега с 9:00 до 15:00. Просим вас заранее убрать автомобиль Toyota Camry с парковки, чтобы работа прошла быстро и качественно. Спасибо за понимание!
Подключение WhatsApp осуществляется через QR-код. После запуска скрипта на экране появится QR-код, который необходимо отсканировать через приложение WhatsApp. Это позволит синхронизировать аккаунт со скриптом. Важно учитывать, что для рассылки лучше использовать аккаунт, который не жалко потерять, чтобы избежать рисков, связанных с возможной блокировкой.
После настройки можно запускать программу, и она автоматически отправит всем жильцам персонализированные уведомления с учетом задержек между отправками. Это обеспечит соблюдение лимитов WhatsApp и сделает процесс оповещения быстрым и удобным.
/** * Система автоматических уведомлений через WhatsApp для ТСЖ и УК * * Данный скрипт загружает список жильцов из Excel-файла и отправляет им сообщения через WhatsApp. * Используется библиотека whatsapp-web.js для взаимодействия с WhatsApp Web. * * Подготовка окружения * * 1. Установите Node.js: * - Скачайте LTS версию с официального сайта nodejs.org * - Проверьте установку командой: `node -v` * * 2. Установите необходимые библиотеки: * npm install whatsapp-web.js xlsx qrcode-terminal * * Подготовка данных * * Создайте Excel-файл `TSZH.xlsx` со следующими колонками: * - Name (Имя жильца) * - Phone number (Номер телефона) * - Car (Марка автомобиля, опционально) * * Подробнее о скрипте: https://habr.com/ru/articles/876216/ * */ // Импорт необходимых библиотек const { Client, LocalAuth } = require('whatsapp-web.js'); const qrcode = require('qrcode-terminal'); const xlsx = require('xlsx'); const path = require('path'); // Путь к Excel-файлу с данными const excelFilePath = path.join(__dirname, 'TSZH.xlsx'); // Читаем данные из Excel-файла console.log("Чтение данных из Excel-файла..."); const workbook = xlsx.readFile(excelFilePath); const sheetName = workbook.SheetNames[0]; const data = xlsx.utils.sheet_to_json(workbook.Sheets[sheetName]); // Вывод данных в консоль сразу после чтения console.log("Данные из Excel-файла:", data); // Настройка клиента WhatsApp console.log("Инициализация клиента WhatsApp..."); const client = new Client({ authStrategy: new LocalAuth() }); // Генерация QR-кода client.on('qr', qr => { console.log("Сканируйте этот QR-код в приложении WhatsApp:"); qrcode.generate(qr, { small: true }); }); // Когда клиент готов client.on('ready', async () => { console.log("Клиент WhatsApp готов к отправке сообщений."); // Функция для отправки сообщения с задержкой const sendMessageWithDelay = async (person, delay) => { return new Promise(resolve => { setTimeout(async () => { // Проверка наличия имени и номера телефона, чтобы избежать ошибок if (!person.Name || !person['Phone number']) { console.error(`Ошибка: Отсутствует имя или номер телефона для записи:`, person); return resolve(); // Переходим к следующей записи } // Преобразуем номер телефона в строку, если он число let phoneNumber = person['Phone number']; if (typeof phoneNumber === 'number') { phoneNumber = String(phoneNumber); } // Удаляем все нецифровые символы из номера и добавляем суффикс WhatsApp phoneNumber = phoneNumber.replace(/\D/g, '') + '@c.us'; const message = `Уважаемый(ая) ${person.Name}, Завтра будет проводиться уборка снега с 9:00 до 18:00. Просим вас заранее убрать автомобиль ${person.Car || ' '} с парковки, чтобы работа прошла быстро и качественно. Спасибо за понимание!`; try { await client.sendMessage(phoneNumber, message); console.log(`Сообщение успешно отправлено на номер ${person['Phone number']}.`); } catch (err) { console.error(`Ошибка при отправке сообщения на номер ${person['Phone number']}:`, err); } resolve(); }, delay); }); }; // Персонализированная рассылка сообщений с задержкой for (let i = 0; i < data.length; i++) { // Задержка 4 секунды между сообщениями (15 сообщений в минуту) await sendMessageWithDelay(data[i], i * 4000); } }); // Обработка ошибок client.on('auth_failure', () => { console.error("Ошибка авторизации. Проверьте свои учетные данные."); }); client.on('disconnected', () => { console.log("Клиент WhatsApp был отключен."); }); // Запуск клиента client.initialize();
Завершение работы и проверка отправки
Чтобы убедиться, что сообщения успешно отправлены, можно использовать два способа. Во-первых, обратите внимание на логи в консоли. Программа выводит подробную информацию о процессе отправки: номера телефонов, текст сообщения и возможные ошибки. Если возникли проблемы, лог поможет понять, на каком этапе произошел сбой. Во-вторых, выполните ручную проверку. Зайдите в WhatsApp на подключённом аккаунте и убедитесь, что сообщения действительно отправлены указанным получателям.
Задел на будущее
В перспективе скрипт можно расширить, добавив более сложные сценарии: опросы, напоминания или уведомления об авариях. Такой подход позволит сделать общение с жильцами удобнее и эффективнее.
Заключение
Использование WhatsApp для автоматической рассылки сообщений в ТСЖ - это бесплатное, быстрое и удобное решение. Даже начинающий пользователь легко настроит скрипт благодаря понятным библиотекам и простому коду.
Однако стоит учитывать риски. Массовая рассылка может привести к блокировке аккаунта, поэтому начните с небольших списков и внимательно следите за скоростью отправки.
Попробуйте предложить эту систему в своём ТСЖ уже сегодня и оцените, насколько чище будет ваш двор!
Автор: Михаил Шардин
🔗 Моя онлайн-визитка
📢 Telegram «Умный Дом Инвестора»
10 февраля 2025 г.
