1msg official logo

Массовые рассылки в WhatsApp: как отправлять много без блокировок

Массовые рассылки в WhatsApp можно масштабировать только через официальный WhatsApp Business API. Нужны три вещи: согласие получателей, одобренный Meta шаблон и очередь sendTemplate с ограничением скорости. У нового бизнес-портфолио лимит — 250 уникальных получателей за скользящие 24 часа, потом 2000, 10 000, 100 000 и без ограничений. Каждую отправку отслеживайте по wamid и останавливайте рассылку до лимита.

Nikita L ·

Для больших рассылок в WhatsApp рабочий путь один: официальный WhatsApp Business API, получатели с согласием и одобренные Meta шаблоны, которые уходят через очередь с учётом лимитов. Мы в 1MSG (официальная платформа WhatsApp Business API) собрали в этом руководстве всё, что нужно бэкенд-разработчикам и growth-командам: вызов sendTemplate, отслеживание доставки, ограничение скорости и расчёт прогрева для базы на 2500 контактов.

Новому бизнес-портфолио Meta даёт лимит 250 уникальных получателей за скользящие 24 часа (Meta, 2026). Поэтому рассылке нужен не только цикл отправки, но и стоп-кран. Ниже собираем такой пайплайн: одобренный шаблон, очередь с ограничением скорости, отслеживание доставки и расчёт прогрева.

Как масштабировать массовые рассылки в WhatsApp?

Большие рассылки в WhatsApp делают через официальный WhatsApp Business API (Cloud API). Для этого нужны явное согласие получателя, одобренный Meta шаблон и очередь отправки с учётом лимитов. Приложение WhatsApp Business упирается в 256 контактов в списке рассылки. Рабочие объёмы — это официальная WABA, а не серые обёртки над WhatsApp Web.

«Вне окна обслуживания пользователям WhatsApp можно отправлять только шаблонные сообщения» — правила Meta для шаблонов

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

Business App, рассылки из кабинета или API: что масштабируется?

Отправлять можно тремя способами: из бесплатного приложения WhatsApp Business (списки рассылки до 256 контактов, привязка к телефону), из кабинета платформы Business API (CSV, без кода) и напрямую через API (вызовы sendTemplate из кода). Больше 256 контактов в список приложение не берёт, дальше — только варианты через API.

Маркетологи работают в кабинете: загружают CSV и ставят рассылку по расписанию. Разработчики подключают API — его и разбираем дальше. Лимиты и правила шаблонов в обоих случаях одни и те же.

Что настроить до масштабирования: одобрение шаблонов и правила окна обслуживания

До любой рассылки нужно выполнить два условия. Первое: если компания пишет первой вне 24-часового окна обслуживания, сообщение должно идти по одобренному Meta шаблону (Marketing, Utility или Authentication). Второе: каждый получатель должен дать согласие. Достаточно выполнить их один раз — дальше в руководстве только инженерия.

«Начинать диалог можно только одобренным шаблоном сообщения» — WhatsApp Business Messaging Policy

Одобрить шаблон несложно: отправляете текст с нумерованными переменными {{1}}, {{2}} и указываете категорию. У неверифицированного портфолио может быть до 250 шаблонов на WABA, у верифицированного с одобренным отображаемым именем — до 6000. С оплатой два подвоха. Во-первых, с 1 июля 2025 года Meta берёт плату за каждый доставленный шаблон в зависимости от категории. Во-вторых, utility-шаблон, похожий на рекламу, могут перевести в marketing и считать по маркетинговым тарифам, хотя статус останется APPROVED. Автоматическая смена категории работает по умолчанию — это не флажок, который включают по желанию.

Ответ клиента открывает 24-часовое окно, в котором сообщения в свободной форме не требуют одобрения. Вне окна путь один — шаблон. Поэтому рассылка по холодной базе всегда начинается с шаблона.

Одобрение шаблона и 24-часовое окно обслуживания — два условия любой рассылки в WhatsApp.

Как подготовить базу получателей к рассылке?

Большинство сбоев первой рассылки ловит проверка базы. Приведите номера к международному формату без плюса и пробелов, уберите дубли из разных источников и приложите к каждому контакту подтверждение согласия (источник и время). И заполните переменные шаблона так, чтобы ни одна строка не ушла пустой: строка с пустой {{1}} не отправится.

В песочнице Cloud API от Meta писать можно только на 5 подтверждённых номеров — первая же тестовая рассылка упирается в этот потолок. На проде подтверждать каждого получателя не нужно, поэтому проверять приходится саму базу: если число переменных не совпадает, эта строка получит ошибку 422, а остальные уйдут.

Отправляем первую пачку через 1MSG: sendTemplate с params, а не components

Вызов sendTemplate в 1MSG принимает пять ключей: phone, template (название одобренного шаблона), namespace, language (объект с policy и code) и params для переменных в тексте. Массива components из Graph API здесь нет. Передать его — самая частая ошибка при первой интеграции.

Если скопировать пример из Graph API вместе с components, вызов упадёт на проверке схемы. Каналы 1MSG работают на официальной WABA и полностью совместимы с Cloud API: отправляется ровно тот шаблон, который одобрила Meta.

Возьмём шаблон для возврата клиентов с текстом Hello, {{1}}! You previously showed interest in "{{2}}". {{3}}. В нём три переменные (имя, интерес и повод вернуться). Кнопка с URL задаётся в самом шаблоне Meta, поэтому в params передаются только значения переменных из текста. Официальный SDK @1msg/sdk оборачивает этот вызов для Node.js. Вызывать его нужно один раз на каждого получателя; на Python, PHP, Go и curl уходит тот же JSON:

import { createClient } from '@1msg/sdk';

const client = createClient({
  baseUrl: 'https://api.1msg.io',
  instanceId: process.env.MSG_INSTANCE_ID,
  token: process.env.MSG_API_TOKEN,
});

// the wire wants `params`; Meta's `components` key fails schema validation
const res = await client.templates.sendTemplate(client.config.token, {
  phone: '14155550123',
  template: 'winback_offer_v1',
  namespace: 'your_template_namespace', // 422 without it
  language: { policy: 'deterministic', code: 'en' }, // an object, not "en"
  params: [{ type: 'body', parameters: [
    { type: 'text', text: 'Anna' },                 // {{1}} name
    { type: 'text', text: 'Pro plan for teams' },   // {{2}} interest
    { type: 'text', text: '20% off until Friday' }, // {{3}} hook
  ]}],
});
// res.sent === true means accepted, not delivered; persist res.id (the wamid)

Как отслеживать доставку и останавливать рассылку до дневного лимита?

На каждую принятую отправку API отвечает sent: true и id — это wamid. Статус доставки приходит позже: событиями hooks[] в вебхук или через опрос hookInfo. Очередь рассылки крутит этот цикл: собирает события delivered/failed по wamid, считает уникальных получателей за скользящие 24 часа и встаёт на паузу с запасом до лимита whatsapp_business_manager_messaging_limit.

Назовём этот паттерн циклом отправки с учётом лимитов: принять, отследить, посчитать, остановить. sent: true — это только квитанция о приёме, а не подтверждение доставки. Поэтому каждый wamid сверяйте со статусами доставки в вебхуках. В 1MSG есть журнал доставки и проверка вебхуков, так что эта сверка сводится к настройке.

Meta ограничивает новое бизнес-портфолио 250 уникальными получателями за скользящие 24 часа, дальше — 2000, 10 000, 100 000 и без ограничений. Считайте уникальных получателей в своём журнале отправки и ставьте паузу с запасом, например на 240 из 250. Не ждите жёсткой ошибки, чтобы узнать, что лимит кончился.

Цикл отправки с учётом лимитов сохраняет wamid, сверяет статусы из вебхуков, считает уникальных получателей и встаёт на паузу до лимита портфолио.

С какой скоростью можно отправлять? Пропускная способность, лимит на пару и темп новых шаблонов

По умолчанию Cloud API пропускает 80 сообщений в секунду на один бизнес-номер. Лимит на пару (pair rate) — не больше 1 сообщения одному и тому же пользователю раз в 6 секунд, иначе приходит ошибка 131056. А у новых шаблонов сверху ещё пейсинг: Meta разгоняет их отправку постепенно. Поэтому очереди рассылки нужны три ограничителя — по одному на каждый лимит.

Рабочая схема очереди такая. Пул воркеров держится ниже потолка пропускной способности. Ключ на получателя выдерживает интервал 6 секунд для пары. Планировщик растягивает первые отправки нового шаблона, пока Meta копит данные о вовлечённости (все три лимита описаны в документации Meta). При 80 сообщениях в секунду 1000 сообщений WhatsApp уходят примерно за 13 секунд работы API. А реальные сроки рассылки определяет дневной лимит получателей.

План прогрева: как дойти до 2500 получателей со стартового уровня 250

База на 2500 контактов не влезает в дневной лимит нового портфолио — 250 получателей. Поэтому план отправки — простая арифметика: 250 уникальных получателей за скользящие 24 часа, пока портфолио не перейдёт на следующий уровень, а потом остаток. Рассылка займёт несколько дней. Переход с 250 на 2000 идёт по правилам масштабирования Meta (верификация или качество и объём), а не по календарю.

ЭтапУникальные получателиПримечание
Пока лимит портфолио — 250250 за скользящие 24 часаКаждый день используйте лимит полностью; следите за долей блокировок и отписок
Когда лимит вырос до 2000Остальные контакты — волнами побольшеЛимит растёт сам, если качество стабильно, а не по таймеру в четыре дня
Если лимит так и остаётся 250250 в день, пока база не закончитсяБаза на 2500 строк в этом случае займёт десять календарных дней

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

Какие ошибки возникают на больших объёмах и что делать с 131049 и 131056?

В рассылках чаще всего встречаются три проблемы. Ошибка 131049 — лимит маркетинговых сообщений на пользователя: получателю недавно пришло слишком много рекламы. Ошибка 131056 — лимит на пару: одному и тому же пользователю написали дважды за 6 секунд. И маркетинг в США не доходит: 1 апреля 2025 года Meta приостановила маркетинговые шаблоны на номера +1.

Первую ошибку Meta объясняет так: «WhatsApp может ограничивать число маркетинговых шаблонов, которые пользователь получает от компаний за определённый период». Meta смотрит на долю прочтений и на то, сколько сообщений у человека во входящих. Записывайте 131049 по каждому получателю и убирайте этот контакт из маркетинговых рассылок до конца цикла. Если пользователь ответит, откроется окно обслуживания, и там этот лимит не действует. При 131056 не повторяйте отправку сразу, а ставьте сообщение обратно в очередь с интервалом для пары. Маркетинг на американские номера +1 возвращает 131049 или код-обёртку провайдера, поэтому базу лучше заранее разбить по странам. Если ошибки повторяются, откройте тикет в поддержку со списком wamid, которые не дошли.

Когда маркетинговым рассылкам нужен Marketing Messages API?

Если маркетинг через Cloud API на холодных сегментах постоянно падает с 131049, пустите этот рекламный трафик через Marketing Messages API от Meta. В 1MSG он работает на том же официальном канале WABA, что и sendTemplate: тот же номер, те же шаблоны. Менять продукт ради цикла отправки не придётся. Utility и authentication остаются на Cloud API.

Здесь Meta доставляет сообщения с учётом качества, поэтому маркетинг с высокой вовлечённостью может доходить лучше, чем через Cloud API (документация платформы Meta). Подключайте его, когда узкое место — 131049, а не для каждой рассылки по умолчанию.

Что берёт на себя 1MSG, чтобы команда занималась только логикой кампаний?

Всё руководство сводится к одному пайплайну: на входе одобренный шаблон, дальше цикл sendTemplate с ограничением скорости, обратно — статусы из вебхуков. 1MSG держит этот пайплайн на официальных каналах WABA, полностью совместимых с Cloud API (больше 140 млн обработанных сообщений, 99,8% вызовов API без сбоев). Команде остаётся писать логику кампаний, а транспорт, лимиты и журнал доставки она получает готовыми.

Рассылка в WhatsApp, которая выдерживает объёмы, — это официальная WABA, одобренный шаблон и цикл отправки с ограничением скорости и отслеживанием. Подключите канал, отправьте шаблон на одобрение, направьте очередь в sendTemplate и зарегистрируйте вебхук. Цена фиксированная: 3045 руб в месяц за канал с WABA от 1MSG или $39 со своей WABA, сообщения Meta оплачиваются отдельно. А на бесплатном тестовом номере весь цикл можно прогнать целиком ещё до подключения рабочего номера.

Следующий шаг: отправьте пачку на 10 получателей с бесплатного тестового канала 1MSG. Вызов sendTemplate тот же, вебхуки живые, а код с первой же отправки годится для прода.

Посмотреть шаблоны сценариев · Получить бесплатный тестовый номер

Источники

FAQ

У нового бизнес-портфолио лимит — 250 уникальных получателей за скользящие 24 часа, общий на все его номера. Ответы внутри открытого окна обслуживания в лимит не входят. Если качество держится, лимит растёт автоматически.

Интегрируйте WhatsApp за часы
без проблем с инфраструктурой